Configuração de propriedades do agente

No Maestro, os agentes são tratados como participantes de um processo de negócios. Dentro de um fluxo de trabalho BPMN, os agentes são representados usando tarefas Serviço, que podem invocar agentes hospedados pela UiPath ou agentes externos. Cada tarefa do agente pode ser configurada com parâmetros de entrada e saída específicos, que permitem que o Maestro passe dados sensíveis ao contexto para o agente e receba resultados estruturados em troca.

Consulte Tarefas na modelagem BPMN para obter uma visão geral das tarefas Serviço no Maestro.

Modos de execução do agente

O comportamento do agente é definido no painel Propriedades de uma tarefa Serviço. Você pode configurar a tarefa para chamar um agente da UiPath ou um agente externo, dependendo de suas necessidades de negócios.

Iniciar e aguardar o agente

Use essa opção para invocar um agente implantado em seu locatário UiPath. Isso inclui:

• Agentes de pouco código criados usando ferramentas como o Agent Builder.
• Agentes codificados desenvolvidos em Python ou outras linguagens e implantados no Orchestrator.

No runtime, o Maestro envia parâmetros de entrada ao agente no formato JSON. Quando o agente conclui a execução, ele retorna uma resposta contendo valores de saída esperados pelo processo.

Iniciar e aguardar o agente externo

Use esta opção para se conectar a sistemas de terceiros ou externos. Você deve especificar:

• Conector: o destino da integração (por exemplo, CrewAI, Salesforce ou outro serviço)
• Conexão: uma instância configurada do conector, representando um agente específico ou um conjunto de credenciais específico do contexto.
  Observação: você pode usar o mesmo agente com diferentes permissões ou comportamentos, definindo várias conexões.

Entradas e saídas

As entradas e saídas para agentes são configuradas da mesma forma que outros tipos de tarefas do Maestro.

• Entradas: variáveis ou expressões passadas ao agente no runtime.
• Saídas: variáveis preenchidas pela resposta JSON do agente.

O Maestro envia parâmetros de entrada como uma carga JSON no formato:

{
  "key1": "value1",
  "key2": "value2"
}

O agente deve retornar uma resposta JSON usando os mesmos nomes de parâmetros esperados pelo Maestro. Esses valores são mapeados para variáveis de processo utilizando a seção Saída > Resposta no painel Propriedades da tarefa.

Exemplos de entrada e saída

Tabela 1. Entradas de exemplo (do Maestro para o agente)

Parâmetro	Description
role	Função ou contexto para a tarefa (por exemplo, validação versus sumarização).
prompt	Instruções fornecidas ao agente, muitas vezes incluindo dados específicos do processo
tools	Lista de ferramentas que o agente pode usar para concluir a tarefa
user_id	Identificador exclusivo compartilhado entre o processo e o contexto do agente

Exemplo de prompt:"Conclua a validação do empréstimo para {loan_application_number}. Responda no formato JSON usando o parâmetro 'loan_application_status'."

Tabela 2. Exemplo de saídaso (do agente para o Maestro)

Parâmetro	Description
conversation_id	Referência à sessão de diálogo ou interação
loan_application_status	Resultado de status retornado pelo agente
tokens_used	Metadados sobre o uso de recursos

Importante:

Para usar a saída do agente em seu fluxo de trabalho, você deve atribuir cada parâmetro de saída a uma variável de processo na configuração de Saída > Resposta da tarefa.