agents
latest
false
Importante :
A localização de um conteúdo recém-publicado pode levar de 1 a 2 semanas para ficar disponível.
UiPath logo, featuring letters U and I in white

Guia do Usuário de Agentes

Última atualização 9 de out de 2025

Criação de ferramentas de agente eficazes

Os agentes usam ferramentas da seguinte maneira:

  1. 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.

  2. 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.

  3. 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.

Conversão de automações existentes para serem usadas como ferramentas

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.

Escrevendo descrições de ferramentas eficazes

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.

  1. O que a ferramenta faz?

  2. Quais efeitos colaterais a ferramenta tem?

  3. A ferramenta modifica seu ambiente?

  4. A ferramenta pode realizar atualizações destrutivas para um sistema de registro?

  5. Chamar a ferramenta repetidamente tem algum efeito adicional?

  6. 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.

Fornecendo exemplo de uso em uma solicitação do sistema

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."

Usando barreiras para supervisão adicional

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.

Usando conectores em Fluxos de Trabalho

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:

  1. Crie um novo fluxo de trabalho no Studio Web.

  2. Adicione a atividade do conector.

  3. Defina os argumentos de entrada e saída correspondentes.

  4. Publique o fluxo de trabalho como um processo.

  5. 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.

Esta página foi útil?

Obtenha a ajuda que você precisa
Aprendendo RPA - Cursos de automação
Fórum da comunidade da Uipath
Uipath Logo
Confiança e segurança
© 2005-2025 UiPath. Todos os direitos reservados.