- Visão geral
- Sobre funções
- Funções do JavaScript
- Funções do Python
- Implantar e executar
Sobre funções
Essa funcionalidade está disponível em pré-visualização.
UiPath® Functions são unidades de computação nativas do desenvolvedor e governadas pela plataforma. Você escreve a lógica em código, a implanta na UiPath como um .nupkg pacote padrão e a chama de qualquer lugar em uma solução:
- Um processo do Maestro , como uma tarefa de serviço.
- Um fluxo de trabalho de RPA ou API, como uma etapa.
- Um agente, como uma ferramenta.
- Um aplicativo, como seu back-end.
Eles são digitados, rastreáveis, testáveis e determinísticos: sem loop de raciocínio do LLM, sem modelo, apenas código que recebe a entrada digitada e retorna a saída digitada. Uma função é executada ao lado de robôs de RPA, agentes e tarefas humanas na mesma camada de orquestração e herda a mesma governança de plataforma que o restante de suas automações:
- Identidade
- Credenciais
- Trilha de Auditoria
- Controle de acesso
Não há uma segunda pilha para hospedar, proteger e manter em conformidade.
Escolha um idioma
Uma função é seu código mais um SDK da UiPath. Dois idiomas são compatíveis, em uma embalagem e no modelo de CLI.
| JavaScript / TypeScript | Python | |
|---|---|---|
| SDK | @uipath/coded-functions-js-sdk | uipath |
| Contratos | Interfaces TypeScript ou Esquema JSON | dataclass ou modelo pydastic |
| Chamado como | Um ponto de extremidade HTTP ou um trabalho do Orchestrator | Um trabalho do Orchestrator |
| Alcance quando | Apoiar um aplicativo codificado ou escrever no idioma que sua pilha da web já usa | Processamento com muitos dados ou o ecossistema do Python |
Ambos exportam sua entrada e saída como Esquema JSON, de modo que os campos digitados aparecem diretamente na interface gráfica de associação em cada superfície de invocação, e ambos recuperam credenciais e recursos da plataforma no runtime em vez de enviá-los no pacote.
Cada função é executada como um trabalho do Orchestrator, independentemente da forma como é chamada. Um gatilho HTTP cria um por solicitação, então uma função chamada sobre HTTP ainda aparece em Execuções com sua entrada, saída e logs — as duas opções diferem em como você alcança uma função, não em como ela é executada.
Funções do JavaScript
Uma função JavaScript ou TypeScript se declara com defineFunction. Definir um method e path o expõe como um ponto de extremidade HTTP — o formato que suporta um aplicativo codificado, onde a função contém as credenciais e regras de negócios que o navegador nunca deve ver. Quando method e path não estão definidos, a função é executada como um trabalho, como sua contraparte do Python.
Funções do Python
Uma função Python é um módulo Python digitado que é executado como um trabalho do Orchestrator, recupera recursos da plataforma por meio do UiPath() cliente e emite intervalos de execução por meio do @traced designer.
Quando usar uma função
Uma função se encaixa onde uma solução precisa de lógica determinística de código primeiro — por exemplo:
- O back-end de um aplicativo codificado, buscando apenas o que o usuário conectado pode ver e gravando de volta no sistema de registro.
- Uma etapa de cálculo ou pontuação personalizada em um processo do Maestro.
- Uma integração de API (NetSuite, SAP, qualquer serviço REST) ou um sistema sem conector.
- Transformação de dados ou aplicação de regras de negócios entre etapas do processo.
- Uma biblioteca de código aberto ou lógica de negócios que você já tem no código, tornada reutilizável em automações.
A lógica de raciocínio por modelo orientada por IA pertence a um agente codificado .
Como isso se encaixa
Author (UiPath SDK) → Package (pack) → Publish
↓
Orchestrator package feed
↓
Deploy as a process (in an Orchestrator folder)
↓
Invoke from: Maestro Service Task | Studio Run Job | Orchestrator API | Job trigger
| an HTTP trigger, for JavaScript functions that declare a route
Author (UiPath SDK) → Package (pack) → Publish
↓
Orchestrator package feed
↓
Deploy as a process (in an Orchestrator folder)
↓
Invoke from: Maestro Service Task | Studio Run Job | Orchestrator API | Job trigger
| an HTTP trigger, for JavaScript functions that declare a route
Próximas Etapas
- Comece a usar o JavaScript — estruture um projeto e execute sua primeira função.
- Comece com o Python — instale o SDK e crie sua primeira função.
- Empacotar e publicar — implante no Orchestrator.
- Invocar funções — chame-as de um aplicativo, Maestro ou da API.