Criação de ferramentas de agente eficazes

Projete ferramentas de agentes com nomes claros, descrições e esquemas de entrada para que os agentes possam selecioná-las e executá-las com precisão dentro do Agents.

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:

Exemplo de uso da ferramenta ValidateInvoiceStatus

Entrada:

{
  "InvoiceNumber": "INV-2024-1837"
}

Saída:

{
  "IsValid": true,
  "PaymentStatus": "Paid",
  "DueDate": "2025-06-30"
}

Interpretação dos resultados

Condição do resultado	Interpretação do agente
ÉVálido = verdadeiro, StatusdePagamento = Pago	A fatura INV-2024-1837 é válida e já foi paga.
ÉVálido = verdadeiro, StatusdePagamento = Não pago	A fatura INV-2024-1837 é válida, mas não está paga. O vencimento é 30 de junho de 2025.
ÉVálido = Falso	Não há fatura válida com o número INV-2024-1837 no sistema.

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 de ferramentas de agentes, permitindo que um humano revise o uso da ferramenta, bloqueando-a inteiramente e muito mais. Leia mais sobre proteções de ferramentas.

Usando conectores em Fluxos de Trabalho

Você pode adicionar muitas atividades do conector do Integration Service diretamente como uma ferramenta para seu agente. Para usar conectores e atividades que ainda não são compatíveis 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.