Prompts de Sistema

O prompt de sistema é o conjunto de instruções que define como o agente deve pensar, responder e agir. É a parte mais importante da configuração do agente.

Os dois modos do editor

Na aba Prompt do editor, o SquadOS oferece dois modos:

• Visualizar (padrão): o prompt renderizado como markdown, somente leitura.

• Editar Prompt: editor markdown com toolbar (negrito, headings, listas, código, citações) e um painel lateral Ferramentas disponíveis. Clicar numa ferramenta insere automaticamente o placeholder {{tool:nome_da_ferramenta}} no prompt, que vira referência ativa quando a ferramenta é chamada. À direita de cada ferramenta há um ícone de informação (ℹ️) que abre uma sugestão de uso pronta — veja Referenciando ferramentas no prompt.

Ao lado, o botão Editar com AgentMaker abre o copiloto que te ajuda a reescrever o prompt conversando — veja AgentMaker.

O que colocar no prompt

Um bom prompt costuma ter estas partes:

• Papel: quem o agente é.
• Objetivo: qual problema ele resolve.
• Contexto: informações da empresa, produto ou processo.
• Regras: o que ele deve sempre fazer ou evitar.
• Tom: estilo de comunicação.
• Fluxo: etapas que ele deve seguir.
• Uso de ferramentas: quando chamar ferramentas ou bases de conhecimento.

Exemplo simples

Você é um assistente de suporte da Acme.
Seu objetivo é ajudar clientes a resolver dúvidas sobre acesso, cobrança e configuração da conta.

Responda de forma clara, curta e cordial.
Quando não tiver certeza, pergunte antes de assumir.
Se a pergunta depender de dados internos, use a base de conhecimento conectada.
Se o usuário pedir algo fora do escopo de suporte, explique que você não pode ajudar com isso.

Boas práticas

• Seja específico sobre quando o agente deve agir.
• Prefira regras observáveis a frases vagas como “seja bom”.
• Explique quando o agente deve fazer perguntas.
• Descreva limites: o que ele não deve prometer, calcular ou executar.
• Inclua exemplos quando o comportamento for sensível.

Referenciando ferramentas no prompt

Se o agente tiver ferramentas, oriente quando elas devem ser usadas. No editor direto, o painel Ferramentas disponíveis insere o placeholder {{tool:nome}} — útil para deixar referências consistentes:

Use a {{tool:consultar_base}} apenas quando o usuário informar o e-mail da conta.
Se o e-mail estiver ausente, pergunte antes de chamar a ferramenta.

Isso reduz chamadas erradas e melhora a previsibilidade.

Sugestão de uso pronta

Não precisa escrever a instrução do zero. Clique no ícone de informação (ℹ️) ao lado de uma ferramenta no painel Ferramentas disponíveis para abrir o quadro Sugestão de uso no prompt, com dois textos prontos para copiar:

• Frase completa: uma instrução em linguagem natural já redigida (ex: “Utilize a ferramenta search_courses para acessar a integração externa quando precisar dos dados que ela fornece.”). Cole no prompt e ajuste ao seu caso.
• Nome da ferramenta: só o nome técnico da ferramenta, para você montar a sua própria frase.

Cada ferramenta — nativa, de integração ou MCP — já vem com uma sugestão própria. É um ponto de partida: depois de colar, personalize do jeito que fizer sentido para o seu agente.

Revisando o prompt

Depois de salvar, teste o agente com perguntas reais. Ajuste o prompt sempre que notar:

• respostas genéricas demais;
• chamadas de ferramenta sem dados suficientes;
• tom inadequado;
• resistência em perguntar quando falta informação;
• respostas fora do escopo.