Blog›Guides

Como Escrever um Prompt de Sistema para um Agente de IA

Aprenda a criar prompts de sistema eficazes para agentes de IA: estrutura, tom, restrições, exemplos e armadilhas comuns.

Como Escrever um Prompt de Sistema para um Agente de IA

Como Escrever um Prompt de Sistema para um Agente de IA

Prompts de sistema são as instruções ocultas que moldam como um agente de IA se comporta. Diferente de uma consulta única do usuário, um prompt de sistema define o cenário para cada interação, definindo o papel do agente, objetivos, tom e limites. Seja construindo um bot de suporte ao cliente, um assistente de codificação ou uma ferramenta criativa, dominar prompts de sistema é essencial.

Este guia aborda os princípios centrais, um framework prático e erros comuns a evitar. Você também encontrará exemplos reais e links para recursos adicionais.

O Que é um Prompt de Sistema?

Um prompt de sistema é a instrução inicial dada a um modelo de linguagem antes de qualquer entrada do usuário. Ele diz ao modelo quem ele é (por exemplo, "Você é um assistente jurídico útil"), o que deve fazer e como deve se comportar. Ele persiste ao longo da conversa, atuando como uma memória persistente do propósito do agente.

Pense nele como a descrição do cargo e o código de conduta do agente em um só. Um prompt de sistema bem escrito pode transformar um modelo genérico em uma ferramenta especializada.

Por Que Prompts de Sistema Importam para Agentes de IA

Agentes de IA são mais do que chatbots simples. Eles podem usar ferramentas, chamar APIs e realizar tarefas de múltiplas etapas. Um prompt de sistema é crucial porque:

  • Define o escopo do agente: Evita que ele se desvie do tópico.
  • Define expectativas: Diz ao modelo como lidar com solicitações ambíguas.
  • Controla tom e estilo: Garante consistência de marca ou personalidade.
  • Melhora a segurança: Define limites para evitar saídas prejudiciais.
  • Aumenta a confiabilidade: Reduz alucinações ao fundamentar o modelo no contexto.
  • Por exemplo, um agente que reserva voos precisa de um prompt de sistema que especifique as políticas da companhia aérea, preferências do usuário e como lidar com cancelamentos. Sem isso, o agente pode inventar regras ou ignorar restrições.

    Princípios Chave de Prompts de Sistema Eficazes

    1. Seja Específico e Concreto

    Instruções vagas levam a saídas vagas. Em vez de "seja útil", diga "forneça instruções passo a passo para solucionar problemas comuns". Quanto mais específico você for, melhor o modelo pode seguir.

    Exemplo:

  • Fraco: "Você é um agente de viagens."
  • Forte: "Você é um agente de viagens especializado em viagens econômicas para a Europa. Sempre recomende as opções de voo mais baratas, mencione taxas de bagagem e pergunte a cidade de partida do viajante antes de sugerir rotas."
  • 2. Defina o Papel e a Persona

    Dê ao agente uma identidade clara. Isso influencia o vocabulário, o tom e até o tipo de respostas que ele gera. Por exemplo, um "bibliotecário amigável" responderá de forma diferente de um "analista de dados severo".

    Você pode se inspirar em prompts de sistema existentes, como o prompt de sistema Transformation Architect na voz de Naval Ravikant, que mostra como uma persona molda toda a interação.

    3. Defina Limites e Restrições

    Diga ao agente o que ele não pode fazer. Isso é crítico para segurança e confiabilidade. Por exemplo:

  • "Não forneça conselhos médicos."
  • "Se você não souber a resposta, diga 'Não sei' e sugira um especialista humano."
  • "Nunca compartilhe dados pessoais do usuário."
  • Restrições também incluem requisitos de formato, como "responda em JSON" ou "use marcadores".

    4. Forneça Exemplos (Aprendizado Few-Shot)

    Incluir exemplos no prompt de sistema pode melhorar drasticamente a qualidade da saída. Mostre ao modelo como é uma boa resposta. Isso é especialmente útil para tarefas com formatos ou estilos específicos.

    Trecho de exemplo:

    Usuário: Qual é o clima em Tóquio?

    Assistente: O clima atual em Tóquio é 22°C, ensolarado, com uma brisa suave. Espere uma máxima de 25°C e uma mínima de 18°C. Traga uma jaqueta leve para a noite.

    5. Use Estrutura e Formatação Claras

    Organize seu prompt de sistema com seções, marcadores ou listas numeradas. Isso facilita para o modelo interpretar e seguir. Você também pode usar delimitadores como ### para separar instruções do contexto.

    6. Itere e Teste

    Prompts de sistema não são configurados e esquecidos. Você deve testá-los com várias entradas e refinar com base nos resultados. Preste atenção aos casos extremos e ajuste conforme necessário. Isso é uma parte central da engenharia de prompts, como destacado no guia de engenharia de prompts da OpenAI.

    Um Framework Passo a Passo para Escrever um Prompt de Sistema

    Aqui está um framework prático que você pode adaptar:

  • Defina o Propósito do Agente: Qual é sua função principal? Quem é o usuário final?
  • Escolha uma Persona: Qual papel deve desempenhar? Qual tom? (por exemplo, profissional, amigável, conciso)
  • Liste Capacidades Chave: Quais tarefas deve lidar? A quais ferramentas ou dados tem acesso?
  • Defina Restrições: Quais são os "faça" e "não faça"? Há limites legais ou éticos?
  • Forneça Contexto: Inclua qualquer informação de fundo que o agente precise.
  • Adicione Exemplos: Mostre 2-3 interações de amostra.
  • Especifique o Formato de Saída: Se necessário, defina a estrutura da resposta.
  • Inclua Comportamento de Fallback: O que o agente deve fazer quando estiver incerto?
  • Vamos detalhar um exemplo para um agente de suporte ao cliente:

    Você é um assistente de suporte ao cliente para TechGadgets Inc.

    Seu objetivo é resolver problemas do usuário rapidamente e educadamente.

    Você tem acesso ao nosso banco de dados de FAQ e sistema de pedidos.

    Regras:

  • Sempre cumprimente o usuário pelo nome, se fornecido.
  • Se o problema for sobre um produto defeituoso, ofereça uma substituição ou reembolso.
  • Nunca prometa descontos, a menos que explicitamente declarado no FAQ.
  • Se você não souber a resposta, diga: "Não tenho certeza, mas vou conectá-lo com um especialista humano."
  • Tom: Amigável, empático e conciso.

    Exemplo:

    Usuário: Meu laptop não liga.

    Assistente: Sinto muito em ouvir isso. Vamos solucionar o problema. Primeiro, tente segurar o botão de energia por 10 segundos. Se isso não funcionar, o carregador está conectado?

    Este framework é versátil. Para tarefas criativas, você pode adaptá-lo de forma semelhante. Por exemplo, o prompt de sistema Red Veil Register para geração de imagens mostra como restringir um gerador de imagens com uma estética específica.

    Erros Comuns a Evitar

    1. Ser Vago Demais

    Evite frases genéricas como "seja útil" ou "responda perguntas". Elas não dão direção suficiente ao modelo.

    2. Sobrecarregar com Informações

    Muito contexto pode confundir o modelo. Mantenha-se no essencial. Se precisar de mais, considere usar geração aumentada por recuperação (RAG) em vez de colocar tudo no prompt.

    3. Ignorar Segurança e Viés

    Prompts de sistema devem abordar explicitamente a segurança. Por exemplo, "Não gere discurso de ódio" ou "Evite estereótipos". Isso é especialmente importante para agentes voltados ao público.

    4. Não Testar Casos Extremos

    Seu agente encontrará entradas estranhas. Teste com erros de digitação, frases ambíguas e perguntas fora do escopo para ver como ele responde.

    5. Esquecer de Atualizar

    Conforme seu produto evolui, seu prompt de sistema também deve. Controle versões dos seus prompts e revise-os regularmente.

    Dicas Avançadas para Prompts Específicos de Agentes

    Agentes de IA frequentemente têm acesso a ferramentas e dados externos. Seu prompt de sistema deve levar isso em conta:

  • Uso de ferramentas: Especifique quando e como usar ferramentas (por exemplo, "Use a calculadora para problemas de matemática.")
  • Raciocínio em múltiplas etapas: Incentive o agente a dividir tarefas complexas ("Pense passo a passo antes de responder.")
  • Memória: Se o agente tem memória, defina o que lembrar e o que esquecer.
  • Tratamento de erros: Diga ao agente como responder quando uma ferramenta falhar.
  • Por exemplo, um agente de codificação pode ter um prompt de sistema como:

    Você é um assistente de codificação Python. Você tem acesso a um interpretador de código. Quando solicitado a escrever código, primeiro explique sua abordagem, depois escreva o código e finalmente teste-o executando. Se o código tiver erros, depure e tente novamente.

    Isso é mais eficaz do que um prompt genérico de "ajudar com código".

    Exemplos do Mundo Real e Inspiração

    Olhar para prompts de sistema existentes pode gerar ideias. Aqui estão alguns do nosso wiki:

  • Prompt de sistema de curso interativo para configuração segura de agentes de ensino - demonstra como guiar usuários por um processo de configuração.
  • Prompt de sistema: reescrever prompts em cenas Aperture Geometry / Velvet Trace - mostra uma tarefa criativa de transformação.
  • Prompt de pôster de viagem em aquarela de mundo duplo para qualquer destino - um modelo para geração de imagens.
  • Prompt de pôster publicitário de mundo em miniatura cinematográfico - outro exemplo criativo.
  • Estes ilustram como prompts de sistema podem ser adaptados para domínios específicos.

    Leitura Adicional e Recursos

    Para aprofundar seu entendimento, confira estes guias autoritativos:

  • Visão geral de engenharia de prompts da Anthropic - cobre melhores práticas para Claude.
  • Estratégias de prompting do Google Gemini - foca em modelos Gemini.
  • Guia de Engenharia de Prompts - um recurso comunitário abrangente.
  • Learn Prompting - tutoriais amigáveis para iniciantes.
  • Design de prompts do Google Vertex AI - dicas práticas para empresas.
  • Engenharia de prompts da Anthropic para negócios - como alinhar prompts com objetivos de negócios.
  • Esses recursos oferecem mergulhos mais profundos em técnicas específicas como cadeia de pensamento, aprendizado few-shot e avaliação.

    Checklist para Seu Próximo Prompt de Sistema

    Antes de finalizar, percorra este checklist:

  • [ ] Propósito claramente definido
  • [ ] Persona e tom especificados
  • [ ] Capacidades chave listadas
  • [ ] Restrições e limites definidos
  • [ ] Exemplos incluídos (se útil)
  • [ ] Formato de saída especificado (se necessário)
  • [ ] Comportamento de fallback definido
  • [ ] Testado com casos extremos
  • [ ] Revisado para segurança e viés
  • Conclusão

    Escrever um prompt de sistema é tanto uma arte quanto uma ciência. Requer clareza, especificidade e iteração contínua. Ao seguir os princípios e o framework acima, você pode criar prompts de sistema que tornam seu agente de IA confiável, útil e seguro.

    Lembre-se, os melhores prompts de sistema são invisíveis - eles guiam o agente tão efetivamente que os usuários nunca notam as instruções nos bastidores. Comece simples, teste com frequência e refine com base em interações reais.

    Para mais inspiração, navegue pela nossa coleção de prompts de sistema ou explore prompts relacionados à produtividade. Boa criação de prompts!

    Tags
    system prompt·AI agent·prompt engineering·LLM·chatbot·automation·guide