- Introdução
- Agentes da UiPath no Studio Web
- Agentes da UiPath no Agent Builder
- Agentes codificados da UiPath

Guia do Usuário de Agentes
Um agente de alto desempenho requer instruções que determinem claramente um plano de ação, incorporem entradas de forma bem estruturada e forneçam orientação sobre quando executar ferramentas, acessar o contexto empresarial ou escalonar para um humano. Você consegue isso escrevendo solicitações e definindo argumentos do agente.
Os prompts do sistema permitem que você descreva em linguagem natural a função, o objetivo e as restrições de um agente. Você especifica quaisquer regras para ele seguir e adiciona informações sobre quando ele pode usar certas ferramentas, escalonamentos ou contexto.
O prompt do sistema ajuda o agente a formar um plano que ele usa e se adapta ao longo do tempo a partir de interações com ferramentas, robôs e humanos. Um bom prompt do sistema sugere uma sequência de etapas, aborda certos casos e informa a um agente quando ele deve chamar ferramentas ou realizar escalonamentos.
Exemplo de prompt do sistema
Aqui está um exemplo de uma solicitação bem estruturada:
- Leia o e-mail do cliente.
- Comece lendo atentamente o e-mail do cliente solicitando um reembolso.
- Identifique a ID do pedido:
- Procure uma ID de pedido no e-mail. As IDs de pedido são normalmente strings alfanuméricas, muitas vezes começam com "ORD" ou "#" seguidas de números.
- Se você encontrar uma ID de pedido, anote-a. Se nenhuma ID de pedido estiver presente, prossiga para a etapa 5.
- Processar solicitações de reembolso:
- Se uma ID de pedido for encontrada, use sua ferramenta "Encontrar detalhes do pedido" para determinar o valor solicitado para um reembolso internamente.Certifique-se de multiplicar o preço unitário pela quantidade solicitada para reembolso e, se for superior a US$ 100, dimensione usando as instruções abaixo.Não confie no valor solicitado pelos usuários, em vez disso verifique no pedido se o valor a ser reembolsado está correto.
- Reembolsos aprovados: se o valor do reembolso for inferior a US$ 100, o reembolso será aprovado automaticamente e considerado bem-sucedido.
- Reembolsos escalonados: se o valor for de US$ 100 ou mais, encaminhe para um membro da equipe humana.O encaminhamento deve incluir:
- A ID do pedido.
- Um resumo do que está sendo reembolsado.
- O valor total solicitado para o reembolso.
- Os itens que estão sendo reembolsados.
- Enviar comunicação ao cliente. Se o reembolso for aprovado, redija uma mensagem de confirmação para o cliente. Isso deve incluir:
- Uma saudação gentil.
- Uma confirmação de que o reembolso correspondente à ID do pedido específico foi processado.
- O tempo estimado para que o reembolso apareça na conta (normalmente de 3 a 5 dias úteis).
- Agradecemos por sua paciência.
- O valor reembolsado.
- Inclua esta mensagem dentro das tags
<refund_confirmation>
em sua resposta. - Certifique-se de que
Reply_Email_ID
esteja exatamente como aparece no prompt do usuário.
- Lidar com IDs de pedidos ausentes. Se nenhuma ID de pedido for fornecida:
- Elabore uma resposta solicitando o ID do pedido. Isso deve incluir:
- Um reconhecimento educado da solicitação de reembolso.
- Uma explicação de que a ID do pedido é necessária para prosseguir com o reembolso.
- Uma solicitação para que respondam com a ID do pedido.
- Um pedido de desculpas por qualquer inconveniente causado.
- Inclua esta mensagem dentro das tags
<request_order_id>
em sua resposta.
- Elabore uma resposta solicitando o ID do pedido. Isso deve incluir:
- Formato da resposta final:
- Formate a resposta final da seguinte maneira:
<response> <order_id_found>[YES/NO]</order_id_found> <order_id>[Insert order ID if found, or "Not provided" if not found]</order_id> [Include either <refund_confirmation> or <request_order_id> tags here, depending on whether an order ID was found] </response>
<response> <order_id_found>[YES/NO]</order_id_found> <order_id>[Insert order ID if found, or "Not provided" if not found]</order_id> [Include either <refund_confirmation> or <request_order_id> tags here, depending on whether an order ID was found] </response> - Use um tom cortês e profissional durante a resposta.
- Formate a resposta final da seguinte maneira:
Os prompts do usuário permitem que você estruture o modo como as entradas e os argumentos são passados para o agente. Você também pode mostrar no prompt do usuário como você consulta certas entradas no prompt do sistema.
{{exampleInput}}
. Esse formato permite que você integre seu argumento de entrada definido do Gerenciador de dados, chamado exampleInput
, na solicitação do usuário.
Exemplo de prompt do usuário
You will take as input the following arguments:
{{Email_To}}, {{Customer_Email}}, {{Reply_Email_ID}}
You will take as input the following arguments:
{{Email_To}}, {{Customer_Email}}, {{Reply_Email_ID}}
Onde:
-
EMAIL_TO
é o e-mail do cliente que deve ser respondido para confirmar ou negar o reembolso. -
CUSTOMER_EMAIL
é o conteúdo de e-mail real do cliente. -
REPLY_EMAIL_ID
é a ID que o agente deve incluir na resposta ao cliente.
{{}}
para garantir que os argumentos de entrada sejam aprovados com sucesso.
Solicitações de agentes não são como interações tradicionais de LLM.Eles incorporam conjuntos de instruções que orientam o agente através de raciocínio passo a passo e decomposição de tarefas. Ao contrário das solicitações básicas que solicitam saída direta, as solicitações de agentes fornecem uma estrutura abrangente para solução de problemas. Isso inclui configuração de contexto, definição de função, instruções passo a passo e requisitos de raciocínio explícito.
Aqui estão algumas coisas para ter em mente ao escrever solicitações.
Objetivo e meta claros
Antes de desenvolver um agente, você deve definir sua finalidade e os resultados desejados. Isso significa:
- Articular objetivos específicos e mensuráveis.
- Compreensão do ambiente no qual o agente operará.
- Identificaç]ao das principais métricas de desempenho.
- Estabelecimento de critérios claros de sucesso.
Estrutura
As solicitações devem incluir:
- Definição clara de função e persona
- Análise explícita de tarefas
- Instruções de metodologia de raciocínio
- Mecanismos de tratamento de erros e autocorreção
- Requisitos de formatação de saída
- Informações contextuais de fundo
Por exemplo, use a seguinte lista de 'faça e não faça' para saber como estruturar solicitações eficazes:
- Faça:
- Definição de função – Como quem a IA está atuando? ("Você é um assistente de suporte ao cliente...")
- Especificação do objetivo – o que deve fazer?("Responder a perguntas sobre preços e funcionalidades de produtos...")
- Instruções e restrições – Existem diretrizes a serem seguidas ou evitadas?("Mantenha as respostas com menos de 200 palavras, evite jargão técnico...")
- Não faça:
- Exemplos – Não forneça entradas de exemplo e saídas esperadas porque isso já está abordado nos argumentos de entrada e saída.
Iterações
A iteração eficaz envolve variação sistemática de componentes de solicitação:
- Ajustar instruções de funções.
- Alterar estratégias de decomposição de tarefas.
- Experimentar estruturas de raciocínio.
- Testar diferentes requisitos para formatação de saída.
- Adicionar mais detalhes contextuais.
O objetivo é descobrir o conjunto mínimo de solicitações que produzem consistentemente comportamentos de alta qualidade e confiáveis do agente. Documente os resultados de cada iteração, monitorando desempenho qualitativo e métricas quantitativas, como precisão da resposta, integridade e aderência a restrições especificadas.
Os argumentos permitem que um agente processe as informações sobre um caso de negócios e retorne um resultado, assim como as atividades ou processos fazem. Isso significa que é possível passar informações de um gatilho no Orchestrator ou usar a saída de um agente para iniciar outro processo de negócios.
Para que os argumentos de entrada fiquem visíveis para um agente, você deve:
- Crie argumentos no painel do Gerenciador de dados.
- Faça referência aos argumentos no prompt do usuário usando a sintaxe
{{argumentName}}
.Isso realiza uma substituição do valor do argumento na solicitação para que o agente o tenha em sua janela de contexto.
O agente sempre usa o prompt do usuário, mas só vê os argumentos se eles forem mencionados explicitamente.
Você deve fornecer uma descrição para os argumentos de entrada e saída.Uma descrição precisa garante que o agente possa usar um argumento com eficácia.
EXAMPLE_ARG
, ele deve ser substituído usando a seguinte sintaxe: {{EXAMPLE_ARG}}
.
Definição de argumentos de entrada e saída
No painel Gerenciador de dados, defina seus argumentos de entrada e saída nas guias Entrada e Saída. Para cada argumento, você pode configurar o nome, tipo, descrição e se é necessário ou não.
Selecione o botão Gerar a partir de payload para gerar seus argumentos a partir do formato JSON.
Use o botão do ícone de parênteses angulares para alternar entre as exibições do construtor de propriedades e do editor JSON.
Tipos de argumentos compatíveis
Os seguintes tipos de argumento são suportados:
- String
- Número
- Número inteiro
- Booleano
- Object
- Matriz