Aumo Docs

Escrever o prompt

O que colocar nas instruções permanentes de um agente e o que deixar de fora.

O Prompt de resposta ao usuário são as instruções permanentes do Agente. Elas entram em toda mensagem, antes do histórico e dos trechos recuperados das Coleções.

O editor tem formatação, prévia lado a lado e uma Biblioteca de Prompts com textos reaproveitáveis.

O que o prompt decide

Instruções permanentes são boas para quatro coisas:

  • Papel: quem o Agente é e para quem responde.
  • Escopo: o que está dentro e o que está fora do assunto dele.
  • Formato: tamanho, estrutura e idioma das respostas.
  • Comportamento na dúvida: o que fazer quando a resposta não está no material.

O texto padrão do formulário já cobre formato e comportamento na dúvida. Costuma valer acrescentar papel e escopo, que são específicos do seu caso.

O que não colocar

  • Conhecimento: fatos, tabelas e políticas pertencem a uma Coleção, não ao prompt. Conteúdo no prompt é pago em toda mensagem e não pode ser atualizado sem reeditar o Agente.
  • Segredos: chaves e senhas nunca vão no prompt. Acesso a sistemas é feito por Credenciais e ferramentas.
  • Regras que já são guardrails: filtros de dado sensível valem para a organização inteira e não dependem de cada Agente lembrar deles.

Colar uma política inteira no prompt é o erro mais caro que dá para cometer aqui. Cada mensagem trocada passa a custar aquele texto todo, em todas as conversas, para sempre.

Escrevendo para um Agente com Coleções

Quando o Agente tem conhecimento associado, o prompt deve dizer o que fazer com ele.

Duas instruções que resolvem a maioria dos casos: responder a partir do material recuperado, e dizer que não sabe quando o material não cobre a pergunta. Sem a segunda, o modelo tende a completar a lacuna com o que aprendeu no treino, o que produz respostas plausíveis e erradas.

Ajustando depois

A forma mais rápida de avaliar um prompt é conversar com o Agente sobre casos reais, não sobre casos ideais. Perguntas ambíguas e fora de escopo revelam mais que perguntas bem formuladas.

Mude uma coisa por vez. Reescrever o prompt inteiro entre dois testes torna impossível saber o que melhorou.

Próximos passos

Nesta página