- Introdução
- Agentes da UiPath no Studio Web
- Sobre os agentes da UiPath
- Licenciamento
- Construção de um agente no Studio Web.
- Agentes de conversa
- Prompts
- Atividades
- Agentes
- Automações
- Ferramentas integradas
- Criação de ferramentas de agente eficazes
- Proteções
- Configuração de simulações para ferramentas de agente
- Contexts
- Escalonamentos e memória do agente
- Avaliações
- Traços de agente
- Pontuação do agente
- Gerenciamento de agentes UiPath
- Agentes da UiPath no Agent Builder
- Agentes codificados da UiPath

Guia do Usuário de Agentes
Os agentes usam ferramentas da seguinte maneira:
-
Seleção de ferramenta: o agente seleciona uma ferramenta com base no nome, na descrição e no contexto fornecidos na solicitação do sistema.
-
Execução da ferramenta: o agente fornece argumentos de entrada, usando o esquema de entrada definido da ferramenta e qualquer uso de exemplo na solicitação para inferir formato e valores.
-
Interpretação da saída: após a execução, o agente interpreta a saída usando contexto e exemplos da solicitação.
Se não for fornecido contexto suficiente, os agentes podem inferir incorretamente como fornecer argumentos ou interpretar os resultados de uma ferramenta. Você pode melhorar a confiabilidade aplicando várias estratégias de design na configuração da ferramenta, exemplos de uso e barreiras.
Você pode usar fluxos de trabalho existentes como ferramentas ao publicar como processos ou importá-los para sua solução do Studio Web.Revise os argumentos de entrada e saída para garantir que eles usem tipos compatíveis. Os tipos de argumento não suportados podem impedir que o agente chame o processo.
A inclusão dos seguintes Detalhes nas descrições da ferramenta pode ajudar o agente e outros desenvolvedores a usar a ferramenta de forma eficaz em processos agenciais.
-
O que a ferramenta faz?
-
Quais efeitos colaterais a ferramenta tem?
-
A ferramenta modifica seu ambiente?
-
A ferramenta pode realizar atualizações destrutivas para um sistema de registro?
-
Chamar a ferramenta repetidamente tem algum efeito adicional?
-
A chamada da ferramenta permite para o agente interagir com outros agentes, usuários ou sistemas de forma não estruturada? Isso pode introduzir risco adicional e pode exigir um aumento correspondente na supervisão.
As descrições devem permanecer concisas, mas informativas, escritas em idioma simples que suporte o raciocínio do agente.
Incluir um exemplo na solicitação do sistema que demonstra como usar a ferramenta e interpretar sua saída pode melhorar significativamente a Precisão da ferramenta.
Por exemplo, um agente deseja usar um fluxo de trabalho de RPA para marcar o status de uma fatura em um sistema interno. Na solicitação do sistema do agente, você pode dar o seguinte exemplo de uso:
Example Usage of ValidateInvoiceStatus Tool
Input:
{
"InvoiceNumber": "INV-2024-1837" // the unique invoice identifier
}
Output:
{
"IsValid": true, // boolean indicating if the invoice exists
"PaymentStatus": "Paid", // payment status of the invoice
"DueDate": "2025-06-30" // when payment is due (if unpaid)
}
Interpreting the Results:
Result Condition Agent Interpretation
IsValid = true, PaymentStatus = Paid "Invoice INV-2024-1837 is valid and has already been paid."
IsValid = true, PaymentStatus = Unpaid "Invoice INV-2024-1837 is valid but unpaid. It is due by June 30, 2025."
IsValid = false "There's not a valid invoice with number INV-2024-1837 in the system."
Example Usage of ValidateInvoiceStatus Tool
Input:
{
"InvoiceNumber": "INV-2024-1837" // the unique invoice identifier
}
Output:
{
"IsValid": true, // boolean indicating if the invoice exists
"PaymentStatus": "Paid", // payment status of the invoice
"DueDate": "2025-06-30" // when payment is due (if unpaid)
}
Interpreting the Results:
Result Condition Agent Interpretation
IsValid = true, PaymentStatus = Paid "Invoice INV-2024-1837 is valid and has already been paid."
IsValid = true, PaymentStatus = Unpaid "Invoice INV-2024-1837 is valid but unpaid. It is due by June 30, 2025."
IsValid = false "There's not a valid invoice with number INV-2024-1837 in the system."
As proteções de ferramentas permitem que você aplique políticas na entrada fornecida e na saída recebida das ferramentas do agente, permitindo que um ser humano revise o uso da ferramenta, bloqueando-a totalmente e muito mais. Leia mais sobre as proteções das ferramentas.
Você pode adicionar muitas atividades de conector do Integration Service diretamente como uma ferramenta para seu agente. Para usar conectores e atividades que ainda não são suportados diretamente:
-
Crie um novo fluxo de trabalho no Studio Web.
-
Adicione a atividade do conector.
-
Defina os argumentos de entrada e saída correspondentes.
-
Publique o fluxo de trabalho como um processo.
-
Adicione o processo como uma ferramenta e descreva seu uso na solicitação.
Esse método permite que você exponha qualquer conector ou chamada de API ao agente de forma estruturada e confiável.