Prompts e argumentos

Um agente de alto desempenho requer uma solicitação que determine claramente um plano de ação, incorpore entradas de forma bem estruturada e forneça orientação sobre quando executar ferramentas, acessar o contexto empresarial ou escalonar para um humano. Você consegue isso definindo argumentos de agente e escrevendo prompts do sistema e do usuário.

Argumentos de solicitação

Os argumentos de solicitação permitem que um agente aceite 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:

1. Criar argumentos na aba Argumentos.Isso permite que o agente saiba que precisa coletar esses valores, mas não os passa como parte da solicitação.
2. 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. Consulte os exemplos para Prompts do sistema e Prompts do usuário para saber como utilizar argumentos em um prompt real.

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.

Observação: para que os argumentos sejam substituídos no prompt do usuário com sucesso, os nomes devem corresponder exatamente. Se um argumento for chamado EXAMPLE_ARG, ele deve ser substituído usando a seguinte sintaxe: {{EXAMPLE_ARG}}.

Definição de esquemas de entrada/saída

Use as guias Esquema de entrada e Esquema de saída para definir seus argumentos de entrada e saída. Para cada argumento, você pode configurar o nome, tipo, descrição e se ele é necessário ou não.

Habilite o botão de alternância Editar esquema bruto para definir seus argumentos no formato JSON.

Tipos de argumentos compatíveis

Os seguintes tipos de argumento são suportados:

• String
• Número
• Número inteiro
• Booleano
• Object
• Matriz

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.

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.
   1. Comece lendo atentamente o e-mail do cliente solicitando um reembolso.
2. Identifique a ID do pedido:
   1. 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.
   2. 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:
   1. 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.
   2. Reembolsos aprovados: se o valor do reembolso for inferior a US$ 100, o reembolso será aprovado automaticamente e considerado bem-sucedido.
   3. 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.
4. Enviar comunicação ao cliente. Se o reembolso for aprovado, redija uma mensagem de confirmação para o cliente. Isso deve incluir:
   1. Uma saudação gentil.
   2. Uma confirmação de que o reembolso correspondente à ID do pedido específico foi processado.
   3. O tempo estimado para que o reembolso apareça na conta (normalmente de 3 a 5 dias úteis).
   4. Agradecemos por sua paciência.
   5. O valor reembolsado.
   6. Inclua esta mensagem dentro das tags <refund_confirmation> em sua resposta.
   7. Certifique-se de que Reply_Email_ID esteja exatamente como aparece no prompt 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:
   1. 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>

   2. Use um tom cortês e profissional durante a resposta.

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.

Use a sintaxe {{exampleInput}} para substituir o argumento de entrada nomeado exampleInput no prompt do usuário no runtime.

Aqui está um exemplo de um prompt do usuário usando a sintaxe correta:

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.

Use a sintaxe {{}} para garantir que os argumentos de entrada sejam aprovados com sucesso.