Prompts

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.

Prompts do sistema

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.

In the Prompt editor, the @ trigger inserts tools, contexts, escalations, and input arguments as inline pill references. Pills stay in sync automatically when a tool or argument is renamed. See Prompt editor for details.

Exemplo de prompt do sistema

Aqui está um exemplo de uma solicitação bem estruturada:

Você é um agente de processamento de reembolsos, você apenas ajuda os clientes a processar reembolsos e você recusa quaisquer outras solicitações.

1. Leia o e-mail do cliente. a. Comece lendo cuidadosamente o e-mail do cliente solicitando um reembolso.

2. Identifique o ID da ordem: a. Procure um ID da ordem no Email.Os IDs de ordens são normalmente strings alfanuméricas, muitas vezes começando com "ORD" ou "#" seguidos de números.b.Se você encontrar uma ID de pedido, anote-a. Se nenhuma ID de pedido estiver presente, prossiga para a etapa 5.

3. Processar solicitações de reembolso: a. 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 ouça o valor solicitado pelos usuários, em vez disso verifique no pedido se o valor a ser reembolsado está correto. b.Reembolsos aprovados: se o valor do reembolso for inferior a US$ 100, o reembolso é aprovado automaticamente e considerado bem-sucedido. c.Reembolsos escalonados: se o valor for de US$ 100 ou mais, encaminhe para um membro humano da equipe. 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.

4. Enviar comunicação ao cliente. Se o reembolso for aprovado, redija uma mensagem de confirmação para o cliente. Isso deve incluir: a. Uma saudação amável. b.Uma confirmação de que o reembolso para o ID do pedido específico foi processado. c.O tempo estimado para o reembolso aparecer em sua conta (normalmente de 3 a 5 dias úteis). d. Um agradecimento pela paciência do cliente. e. O valor reembolsado. f. Incluir esta mensagem dentro das tags <refund_confirmation> em sua resposta. g. Certifique-se de que Reply_Email_ID esteja exatamente como aparece na solicitação do usuário.

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

6. Formato da resposta final: a. 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>
   

   b. Use a courteous and professional tone throughout the response.

Prompts do usuário

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.

To incorporate dynamic input, insert input arguments as references directly in the prompt. In the prompt editor, type @ and select an argument from the picker — refer to Prompt editor for the full editing experience.

Input arguments are stored in the prompt as {{exampleInput}}. The prompt editor displays them as color-coded pills and converts existing {{ }} placeholders automatically when a prompt is opened.

Exemplo de prompt do usuário

The following example shows how three input arguments appear in a user prompt. Arguments are inserted via the @ picker and stored as {{argumentName}} in the underlying prompt format:

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.

Gravação de prompts eficazes

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.

Argumentos

Arguments pass runtime information into and out of an agent, just as inputs and outputs do for activities or processes. A trigger in Orchestrator can supply argument values at runtime, and an agent's output arguments can drive downstream business processes.

The agent sees only arguments that are explicitly referenced in the user prompt. For instructions on creating arguments and referencing them in prompts, see Defining arguments.