Skip to main content
Este guia se concentra exclusivamente no design e na escrita de prompts eficazes para Agentes de IA e Tarefas de IA. Para conceitos gerais sobre agentes, estrutura, ferramentas e configurações, consulte o Guia Geral para Agentes de IA.

Exemplos de prompts para um Agente de IA

Perguntas Frequentes

Quando precisamos fornecer ao Agente de IA contexto adicional sobre uma empresa para que ele possa responder às consultas dos usuários. Deve-se usar o nó de Agente de IA.

Prompt

Você também pode incluir diretrizes para gerenciar a interação, por exemplo:

Redirecionar o usuário

Quando você precisa redirecionar o usuário para uma parte do fluxo com base em sua intenção. Se for o único propósito (como um roteador), você pode usar uma Tarefa de IA. Se isso faz parte de uma interação, como redirecionar o usuário para um fluxo quando ele solicita, você pode usar um Agente de IA. Isso pode ser alcançado com uma combinação de IA e um nó condicional. Você deve salvar a resposta da IA, que pode ser acessada com {{$memory.variableName}}.

Prompt

Solicitar dados do usuário

Para processos de cadastro ou fluxos onde informações devem ser solicitadas ao usuário.

Prompt

Você pode então acessá-lo com {{$memory.variableName}} para salvá-lo em um nó Datum.

Exemplos de prompts para uma Tarefa de IA

As Tarefas de IA são requisições ao OpenAI/LLM preferido. Seu prompt é mais fácil de escrever e não requer o uso de palavras-chave para finalizar como end_function. Seu objetivo será sempre cumprir o que o prompt diz e salvar a resposta em formato JSON.

Redirecionar o usuário

A diferença é que end_function não é usado.

Resumo de Boas Práticas

Tipos de conteúdo e formato em prompts

  • Mantenha linguagem consistente em todo o prompt.
  • Especifique claramente o formato de saída (JSON recomendado).
  • Se o fluxo precisar terminar, defina explicitamente o uso de end_function.

Design Inteligente de Prompts Condicionais

Para obter melhores resultados, é fundamental minimizar o número de decisões que a IA deve tomar, especialmente quando não estão diretamente relacionadas ao seu objetivo principal. Em vez de carregar o prompt com múltiplas instruções condicionais, é preferível pré-processar a lógica fora do Agente de IA, mantendo o prompt limpo, focado e mais eficaz.

O que evitar

Evite escrever prompts assim:
Se você tiver dados nesta variável {{$memory.variable}}, faça isso, caso contrário, siga estas outras instruções.
Esse tipo de lógica adiciona ambiguidade e ruído ao prompt, o que pode prejudicar a compreensão do modelo e reduzir a precisão da resposta.

Alternativa recomendada

Use lógica condicional prévia em um nó do tipo código para definir quais instruções a IA deve seguir antes de enviar o prompt. Exemplo:
Em seguida, no seu Agente de IA, simplesmente referencie a variável processada:

Benefícios

  • Reduz a carga cognitiva do modelo
  • Diminui o uso de tokens desnecessários
  • Aumenta a clareza do prompt
  • Melhora a consistência das respostas
Essa abordagem ajuda a projetar agentes mais confiáveis e previsíveis, especialmente ao combinar múltiplas fontes de entrada ou condições dinâmicas.
Para considerações sobre modelos (GPT-4.1, contextos longos, CoT e lembretes de agente), consulte o Guia Geral para Agentes de IA.

Ferramenta de Validação de Prompts

Para facilitar a criação de prompts eficazes, você pode usar uma ferramenta beta que atua como um assistente de testes. Se o seu prompt não está funcionando como esperado ou você precisa de um guia rápido para começar, basta acessar o seguinte link, escrever seu prompt ou objetivo e seguir as sugestões do assistente: ChatGPT - Corretor de Prompts para Agentes de IA Esta ferramenta está em beta, portanto ainda está em desenvolvimento. No entanto, é útil para detectar erros comuns, refinar instruções e validar se o prompt está bem estruturado antes de implementá-lo no Brain Studio.

Recursos adicionais

  • OpenAI Platform - Explore recursos para desenvolvedores, tutoriais, documentação de API e exemplos dinâmicos
  • AI Playground - Compare modelos de IA lado a lado: OpenAI GPT, Anthropic Claude, Google Gemini, Llama, Mistral e mais