Fluxos de trabalho da API

Os fluxos de trabalho de API são integrações sem servidor que os agentes podem usar como ferramentas para interagir com sistemas corporativos por meio de APIs. Ao adicionar um fluxo de trabalho de API como uma ferramenta, você habilita seu agente a realizar operações seguras e determinísticas — como recuperar, atualizar ou sincronizar dados — sem exigir acesso direto a sistemas ou credenciais subjacentes.

Quando você inclui um fluxo de trabalho de API como uma ferramenta, o agente pode:

• Chame o fluxo de trabalho no runtime para realizar ações de back-end, como consultar dados de negócios, disparar atualizações ou agregar informações.
• Raciocinar sobre os resultados estruturados retornados pelo fluxo de trabalho para decidir as próximas etapas do plano.
• Combine a lógica de vários sistemas encadeando fluxos de trabalho de API com outras ferramentas, como automações ou conectores do Integration Service.

Os fluxos de trabalho de API são executados em uma infraestrutura totalmente gerenciada na nuvem e sem servidor, garantindo escalabilidade, segurança e governança organizacional. Cada fluxo de trabalho define um contrato de solicitação e resposta no formato JSON, permitindo que os agentes os invoquem programaticamente e interpretem suas saídas para o raciocínio.

Principais benefícios

• Determinística e governada – Fluxos de trabalho de API encapsulam a lógica corporativa por trás de APIs seguras e versionadas com auditabilidade total no Orchestrator.
• Reutilizável entre agentes – O mesmo fluxo de trabalho pode servir como uma ferramenta compartilhada para vários agentes ou processos do Maestro.
• Sem servidor e escalável — A execução é gerenciada automaticamente na UiPath Automation Cloud™, não exigindo nenhuma configuração de infraestrutura.
• Composto e controlado – Combine fluxos de trabalho de API com fluxos de trabalho, automações e conectores de RPA, enquanto aplica políticas consistentes de governança e simulação em todas as ferramentas.

Como os agentes usam fluxos de trabalho de API

Após serem publicados no Orchestrator, os fluxos de trabalho da API aparecem como componentes reutilizáveis dentro da seção Ferramentas de uma definição de agente no Studio Web. Cada ferramenta pode incluir uma descrição que ajuda o agente a entender sua finalidade e quando usá-la. Quando invocado, o agente passa parâmetros de entrada para o fluxo de trabalho, executa sua lógica — por exemplo, fazendo uma chamada de API externa ou transformando dados estruturados — e recupera os resultados como saída JSON.

Assim como outros tipos de ferramentas — por exemplo, fluxos de trabalho ou automações de RPA — você pode:

• Configure diretrizes para controlar quando e como um fluxo de trabalho da API pode ser invocado pelo agente. As diretrizes podem limitar a disponibilidade da ferramenta com base em padrões de entrada, impor políticas de uso ou restringir a execução a fluxos de trabalho aprovados.
• Habilite a simulação de ferramenta para testar o fluxo de raciocínio de um agente sem executar chamadas de API reais. Durante a simulação, o agente recebe dados simulados representativos em vez de disparar o fluxo de trabalho real, permitindo a validação segura da seleção de ferramentas e da lógica de tomada de decisão.

Esses controles garantem que os agentes se comportam de forma previsível, permanecem dentro de limites definidos e podem ser testados com segurança durante o desenvolvimento ou avaliação.

Adicionando um fluxo de trabalho da API como uma ferramenta

1. Do painel Definição, na seção Ferramentas, selecione Adicionar ferramenta.
2. Selecione a guia Fluxo de trabalho da API e pesquise fluxos de trabalho usando a barra de pesquisa ou selecione um na lista disponível. Para acessar um fluxo de trabalho de API como uma ferramenta, é necessário primeiro publicá-la e implantá-la como um processo em uma pasta compartilhada do Orchestrator.
3. Use o prompt do sistema para descrever sua função e quando ela deve ser usada.