Documentação / Instruções do agente
Instruções do agente
Defina objetivo, tom, limites e uso de ferramentas para uma conversa consistente.
Instruções explicam ao agente como conduzir a conversa. Comece com um objetivo específico e teste situações reais antes de acrescentar regras.
Antes de começar
Crie um agente e abra suas instruções no editor. Escreva em texto como ele deve se apresentar, quais informações deve pedir e como deve responder.
Estruture as instruções
Separe papel, objetivo, conversa, ferramentas e limites. Faça uma pergunta por vez e indique o que deve acontecer quando faltar informação.
# Papel
Você atende clientes de uma loja em português, com frases curtas.
# Objetivo
Ajude o cliente a consultar o status de um pedido.
# Conversa
Pergunte o número do pedido se ele ainda não foi informado.
Confirme o número antes de consultar. Faça uma pergunta por vez.
# Ferramentas
Use consultar_pedido somente após obter o número do pedido.
Explique o resultado com base na resposta da ferramenta.
Se a consulta falhar, informe que não conseguiu verificar o status.
# Limites
Não invente prazos, status ou confirmações de atualização.
Se não puder resolver, explique como falar com a equipe.
A instrução para usar uma ferramenta só funciona se ela estiver criada e habilitada nas configurações do agente. Configure seu nome, descrição e parâmetros em HTTP API ou MCP.
Personalize com contexto
Use apenas os dados disponíveis na conversa. Peça informações que ainda faltam e evite colocar dados de um cliente nas instruções fixas de todos os usuários.
Verifique o comportamento
Teste um pedido válido, um número ausente, uma consulta com erro e uma pergunta fora do escopo. Confira o que o agente disse e quais ações executou. Ajuste uma regra por vez.
Tempos de silêncio, duração e interrupções são configurações da conversa. Uma instrução de tom não substitui esses controles. Regras no prompt também não substituem validação e autorização no sistema consultado.
Continue em Testes e Publicação.
