Como criar Agentes de IA Funcionais

Por Monique Tostes Oliveira Atualizado em 11/12/2025

Criar um agente funcional é mais do que dar um nome e um objetivo — é garantir que ele tenha um propósito claro, acesso aos dados corretos e capacidade de responder de forma útil.

Este guia mostra como definir as diretrizes dos agentes para que eles realmente ajudem no seu dia a dia.

Siga os passos abaixo para estruturar seu agente.

1. Nome do Agente

Crie um nome que ajude você a identificá-lo mais facilmente na sua lista de agentes.

2. Classificação

Defina a área de atuação do agente. Se não souber qual escolher, você pode selecionar “Nenhuma”.

3. Modelo de Chat

Selecione o modelo de linguagem (LLM) que você gostaria de usar, como ChatGPT, Gemini, entre outros.

4. Integrações

Selecione uma ou mais integrações às quais seu agente precisa ter acesso para operar como esperado.

5. Definição das Diretrizes do Agente

As diretrizes são o "manual interno" do agente, também conhecido como prompt.

Uma boa estrutura para as diretrizes segue o modelo abaixo:

Função: "Você é um agente especialista em [área], integrado ao ERP da Olist."
Objetivo: "[Definir o que ele deve entregar]."
Estilo de resposta: "[Formato preferido: tabela, planilha, texto, etc.]."
Regras: "[Defina as regras de atuação do agente]."
Exemplos (Opcional):
- Entrada: "[Exemplifique como uma solicitação pode ser feita]."
- Saída: "[Defina um formato de resposta padrão]."

Exemplo prático de diretrizes:

Função: "Você é o Agente Especialista em Margem de Contribuição, integrado ao ERP da Olist."
Objetivo: "Você deve calcular e apresentar a margem de contribuição de produtos, separada por pedidos e canais de venda, considerando sempre a fórmula: Valor de Venda Final - Frete - Custo do Produto - Impostos - Descontos - Outras Despesas Variáveis."
Estilo de resposta: "Envie um resumo no chat e, depois, crie e compartilhe o link de uma planilha do Google Sheets. A resposta pode incluir porcentagens e a variação em relação a períodos anteriores. Use gráficos comparativos quando solicitado."
Regras:
- Sempre valide os dados no ERP antes de responder.
- Nunca utilize valores que não estejam disponíveis no ERP.
- Se a solicitação não for clara (período, produto, canal), peça mais detalhes antes de calcular.
- Apresente os cálculos de forma transparente, mostrando a fórmula utilizada quando for relevante.
- Crie a planilha com as colunas: Canal, Vendas (R$), Frete (R$), Custo do Produto(R$), PIS (R$), COFINS (R$), IOF (R$), Margem de Contribuição (R$), Margem de Contribuição (%), Variação Mês Anterior (%).

Exemplos:

Entrada: "Mostre a margem de contribuição por canal no mês de julho."
Saída: "Olá! Sua margem de contribuição média foi de 15% por pedido. A fórmula utilizada foi: MC = (Vendas – Frete – Custos – Impostos – Despesas Variáveis) / Vendas. Aqui está a [planilha](link-da-planilha) com os dados detalhados."

6. Resumo

O resumo ajuda você e seu time a identificarem rapidamente a função de cada agente, portanto, evite descrições genéricas.

❌ Exemplo ruim: “Agente de Margem”
✅ Exemplo bom: “Responsável por gerar relatórios de margem de contribuição, considerando vendas por canal, deduções e variações percentuais comparativas.”

7. Melhoria Contínua

Analise as respostas e os históricos de interações com seu novo agente. Identifique pontos de melhoria ou respostas que não foram satisfatórias. Após a análise, faça ajustes nas diretrizes. Este processo de ajuste contínuo personaliza o agente para as suas necessidades e garante resultados cada vez mais precisos.

Checklist Rápido

Defina um papel claro para o agente.
Crie diretrizes detalhadas com exemplos reais.
Configure os acessos corretos às integrações.
Escolha o melhor modelo de linguagem para sua necessidade.
Faça testes para garantir a qualidade das respostas.
Teste o agente e faça ajustes contínuos com base nos resultados.

Este artigo foi útil para você?

Deixe sua opinião sobre o artigo