Como criar um agente de IA: passo a passo, custos e LGPD

Para criar um agente de IA, você define uma tarefa, escreve as instruções, conecta as ferramentas que ele vai usar (agenda, CRM, WhatsApp), escolhe o modelo e testa com casos reais antes de liberar. Sem programar, dá para fazer isso no n8n ou no Microsoft Copilot Studio. Com código, os caminhos atuais são o OpenAI Agents SDK e o Claude Agent SDK.

Este guia mostra como criar um agente de IA do zero, em sete passos, com os custos de novembro de 2026, um modelo de instruções para copiar, um roteiro de testes e o que a LGPD exige. Se ainda não está claro o que um agente faz de diferente de um chatbot, comece por o que são agentes de IA.

Antes de começar: a ficha do agente

O erro mais comum é abrir a ferramenta antes de saber o que o agente vai fazer. Preencha esta ficha primeiro. Se não conseguir preencher, o processo ainda não está pronto para um agente.

Essa ficha vira, quase palavra por palavra, as instruções do agente.

Como criar um agente de IA em 7 passos

1. Escolha uma tarefa só

Uma tarefa, um canal, um tipo de cliente. “Atender o WhatsApp” é amplo demais. “Agendar consultas de avaliação pelo WhatsApp” é um bom começo. Você amplia depois que o primeiro agente estiver funcionando.

2. Mapeie o processo atual

Peça para quem faz a tarefa hoje descrever o passo a passo, incluindo as exceções. As exceções são o que quebra agentes: o paciente que quer trazer o filho junto, o cliente que manda áudio, o pedido que veio de outra loja. Anote as 10 perguntas mais comuns e as respostas certas.

3. Escolha a ferramenta

A escolha depende de quem vai manter o agente e de quais sistemas ele precisa alcançar. A tabela da próxima seção compara as opções.

4. Escreva as instruções

As instruções (também chamadas de prompt de sistema) dizem quem o agente é, o que ele pode fazer e como se comportar. Mais abaixo há um modelo para copiar.

5. Conecte as ferramentas e os dados

Cada ação vira uma “ferramenta” que o agente pode chamar: consultar_horarios, criar_agendamento, buscar_paciente. Dê a cada uma um nome claro e uma descrição curta, porque é com base nela que o modelo decide quando usar. Conecte também a base de conhecimento (FAQ, políticas, tabela de serviços).

6. Teste com casos reais

Antes de qualquer cliente falar com o agente, rode pelo menos 30 conversas de teste, incluindo as difíceis. Detalhes na seção de testes.

7. Lance com supervisão e solte aos poucos

Nas primeiras semanas, o agente pode sugerir respostas para um humano aprovar, ou atender só fora do horário comercial. Leia as conversas toda semana, corrija as instruções e só então amplie a autonomia.

Ferramentas para criar agentes de IA

Sem código

n8n é a opção que mais usamos com pequenas empresas: tem um nó de “AI Agent” ao qual você conecta um modelo (OpenAI, Anthropic, Google), uma memória e as ferramentas, e centenas de integrações prontas. Se a ferramenta é nova para você, veja o que é n8n e como funciona.

Copilot Studio faz sentido se a sua empresa vive no Microsoft 365. O agente lê documentos do SharePoint, conversa no Teams e chama fluxos do Power Automate.

As plataformas de WhatsApp são o caminho mais rápido para um agente de atendimento, mas você fica limitado às integrações que elas oferecem. Para esse caso específico, veja nosso guia de chatbot para WhatsApp.

OpenAI Agent Builder: vale a pena em 2026?

Não para projetos novos. O OpenAI Agent Builder foi lançado em outubro de 2025 como parte do AgentKit: uma tela visual para montar agentes arrastando blocos. Em junho de 2026, a OpenAI avisou que o Agent Builder será desligado em 30 de novembro de 2026, e indica migrar para o Agents SDK ou para os workspace agents do ChatGPT (OpenAI, descontinuações). O ChatKit, componente de chat do mesmo pacote, continua disponível.

Se você tem um agente rodando no Agent Builder, exporte a lógica agora e reconstrua no Agents SDK ou no n8n.

Com código

O OpenAI Agents SDK é leve e direto: você define agentes com instruções e ferramentas (funções Python), e ele cuida do ciclo de chamar o modelo, executar a ferramenta e voltar. Os guardrails validam entrada e saída, e o tracing mostra cada passo para você depurar. O guia da API da OpenAI explica como criar a chave e acompanhar o consumo.

O Claude Agent SDK (antes chamado Claude Code SDK) é mais indicado para agentes que trabalham com arquivos e documentos: ler uma pasta de contratos, gerar relatórios, manipular planilhas. Os pacotes atuais são claude-agent-sdk (Python) e @anthropic-ai/claude-agent-sdk (npm). Mais sobre o ecossistema em Claude Code e API da Anthropic.

Escolha código quando: o volume for alto, você precisar de lógica que nenhuma ferramenta visual oferece, ou quiser o agente dentro do seu próprio produto.

Modelo de instruções para copiar

Adapte este modelo. Ele cobre o que mais falta nas instruções que vemos por aí: limites, exceções e quando parar.

Você é a assistente de agendamento da Clínica Sorriso, em Campinas.
Seu único trabalho é agendar, remarcar e confirmar consultas.

Como agir:
- Trate o paciente por "você", com frases curtas e educadas.
- Antes de agendar, confirme nome completo e telefone.
- Use consultar_horarios antes de oferecer qualquer horário.
  Ofereça no máximo 3 opções.
- Depois de agendar, confirme data, hora e endereço.

Limites:
- Não responda dúvidas sobre sintomas, tratamentos ou preços.
  Diga: "Vou pedir para a equipe te responder sobre isso."
  e use transferir_para_humano.
- Não agende fora de seg-sex 8h-18h e sáb 8h-12h.
- Nunca invente horários, preços ou informações.
  Se não souber, diga que vai confirmar.

Passe para um humano quando:
- O paciente pedir.
- O paciente reclamar ou demonstrar irritação.
- Você não entender o pedido depois de 2 tentativas.

Como testar um agente de IA antes de lançar

Testar agente é diferente de testar software comum, porque a mesma pergunta pode gerar respostas diferentes. Monte uma planilha com casos de teste e rode cada um mais de uma vez.

O que medir durante o piloto:

• Taxa de resolução: conversas concluídas sem humano.
• Taxa de transferência: quantas foram para humano, e por quê.
• Erros graves: informação errada, ação errada. A meta é zero; cada um vira uma correção nas instruções.
• Satisfação: uma pergunta simples no fim (“Consegui te ajudar?”).

Quanto custa criar um agente de IA

O custo tem quatro partes: plataforma, modelo, canal e trabalho humano.

1. Plataforma. n8n na nuvem a partir de €20/mês no plano Starter (2.500 execuções/mês) ou €50/mês no Pro (10.000), com cobrança anual; a edição comunitária self-hosted não tem mensalidade, mas exige um servidor (n8n, novembro de 2026). Copilot Studio a US$ 200/mês por pacote de 25.000 créditos (Microsoft).

2. Modelo de IA. Cobrado por milhão de tokens (pedaços de texto; mil tokens equivalem a algumas centenas de palavras). Preços de novembro de 2026:

Exemplo ilustrativo: 1.000 conversas por mês, cada uma com cerca de 8 mil tokens de entrada (instruções, histórico, documentos) e mil de saída. Preços de tabela de novembro de 2026, sem descontos de cache.

Ou seja: para uma pequena empresa, o modelo raramente é a conta mais alta. Mesmo um modelo intermediário fica na casa de dezenas de dólares por mil conversas.

3. Canal. No WhatsApp, a Meta cobra por mensagem entregue, conforme a categoria. As respostas dentro da janela de 24 horas eram gratuitas, mas desde 1º de outubro de 2026 passam a ser cobradas depois das primeiras 1.000 por número a cada mês (Meta). Mensagens de marketing e lembretes (utilidade) têm preço próprio para o Brasil.

4. Trabalho. Montar, testar e ajustar. Para um agente simples, isso é a maior parte do custo, seja o seu tempo, de alguém da equipe ou de uma agência. Reserve também algumas horas por mês para ler conversas e atualizar a base de conhecimento: preços e horários mudam, e o agente não fica sabendo sozinho.

Segurança e LGPD: checklist

Um agente que conversa com clientes trata dados pessoais, então a LGPD se aplica do mesmo jeito que a qualquer sistema. Antes de lançar:

• Base legal definida para cada dado coletado (execução de contrato, consentimento, legítimo interesse).
• Coleta mínima: o agente pede só o que a tarefa exige. Nada de CPF para agendar se não precisa.
• Aviso ao cliente de que está falando com um assistente automatizado, com opção de falar com uma pessoa.
• Contrato com fornecedores (OpenAI, Anthropic, Microsoft, plataforma de WhatsApp) com cláusula de tratamento de dados, e verificação de se os dados são usados para treinar modelos.
• Dados sensíveis (saúde, religião, biometria) com cuidado extra, ou fora do agente.
• Permissões mínimas: o agente lê a agenda, mas não apaga clientes do CRM.
• Registro das ações (logs) e de quem aprovou o quê.
• Prazo de retenção das conversas definido e aplicado.
• Canal para o titular pedir acesso ou exclusão dos dados.

A ANPD publica guias e orientações para agentes de tratamento. Se a sua empresa trata dados de saúde ou de crianças, converse com um advogado antes de lançar.

Erros comuns ao criar agentes de IA

• Dar ferramentas demais. Com 20 ferramentas, o modelo escolhe errado com mais frequência. Comece com três a cinco.
• Instruções vagas. “Seja prestativo” não diz nada. “Ofereça no máximo três horários” diz.
• Não testar exceções. O agente funciona no caminho feliz e falha no primeiro áudio de 2 minutos.
• Sem saída para humano. Todo agente precisa de um botão de “falar com uma pessoa”, e alguém do outro lado.
• Ninguém dono do agente. Sem alguém lendo conversas e ajustando, a qualidade cai em semanas.
• Automatizar o que devia ser simplificado. Se o processo é confuso para a equipe, vai ser confuso para o agente.

Um bom primeiro projeto costuma ser o atendimento, porque o volume é alto e o resultado é fácil de medir; veja o que manter com pessoas no guia de atendimento automatizado com IA. Se quiser ajuda para tirar o primeiro agente do papel, a opsmigo monta, testa e acompanha o piloto com você.