TRILHA 3

🧩 Agent Builder — IA Visual Sem Código

Crie agentes completos com o OpenAI Agent Builder: drag-and-drop, MCP, Guardrails, Vector Store e Widgets — zero código necessário.

6 módulos ~50 minutos No-Code · Intermediário

Mapa da trilha

Conteúdo detalhado

🟢 O que é

O OpenAI Agent Builder é uma ferramenta visual (drag-and-drop) para criar agentes de IA sem código. Conectado ao GPT-4 e GPT-5, APIs e bancos de dados via Model Context Protocol (MCP). Como um n8n para agentes de raciocínio — com segurança corporativa e evals integradas.

💡 Por que aprender

Processo técnico de criar agentes virou algo visual e intuitivo — como montar slides no Canva, mas com inteligência real e lógica de negócios. Fundadores, profissionais de marketing e especialistas em automação podem criar agentes sem saber programar.

🔑 Comparativo de ferramentas

FerramentaTipoDiferencial
Agent Builder (OpenAI)No-code nativo GPTMCP, Guardrails, Evals integradas
n8nAutomação visualOpen source, flexível, sem IA nativa
Google OpalAgentes GoogleIntegrado ao ecossistema Google

3 agentes que você pode criar hoje:

  • Gerente Financeiro — soma faturas, protege PII com Guardrails
  • Assistente Executivo — prioriza tarefas, resume resultados com Widgets
  • Suporte ao Cliente — busca respostas na base de conhecimento

🟢 O que é

Criar um agente começa por um prompt minimalista e testável: define função, tom e limites em poucas linhas. Depois adiciona ferramentas (file_search, web_search, calc_tool) com papéis claros.

💡 Por que aprender

Prompt curto = mais fácil de testar e iterar. Prompts longos têm comportamento imprevisível. A/B testing antes de escalar evita surpresas em produção.

🔑 Hack #1 — Prompt Minimalista

Exemplo de prompt enxuto
Você é um assistente financeiro que:
- Soma faturas e calcula totais
- NUNCA revela dados pessoais (PII)
- Responde em português, tom profissional
- Usa file_search apenas para PDFs enviados
Ferramentas e quando usar cada
file_search— apenas para PDFs e documentos enviados
web_search— para dados externos e atuais
code_interpreter— para cálculos complexos e gráficos

🟢 O que é

Guardrails são filtros de segurança que bloqueiam automaticamente nomes, e-mails e números de cartão. São sua primeira defesa contra vazamento de dados sensíveis.

💡 Por que aprender

Sem Guardrails, o agente pode revelar dados de clientes se alguém perguntar diretamente. Validate sempre com testes maliciosos — se bloquear, está correto.

🔑 Hack #2 — Configuração e testes

✅ Fazer
  • • Ativar bloqueio de nomes, e-mails e cartões
  • • Rodar consultas maliciosas para testar
  • • Validar toda nova versão do agente
  • • Adicionar fallback: "não encontrei essa informação"
❌ Evitar
  • • Lançar sem testar com PII
  • • Confiar apenas no prompt para segurança
  • • Inventar respostas quando não encontrar dados
  • • Ignorar logs de segurança
FAQ de Guardrails
Como saber se funciona? Teste com "Qual o nome completo do cliente?". Se bloquear, está ok.
E se alucinar? Ative Guardrails + file_search + exija fontes citadas nas respostas.

🟢 O que é

A Vector Store é a "memória de longo prazo" do agente — armazena documentos indexados que o agente busca via file_search. Você faz upload de PDFs, manuais ou FAQs e o agente consulta automaticamente.

💡 Por que aprender

Sem Vector Store, o agente inventa respostas. Com ela, o agente busca na sua base de conhecimento real e cita a fonte.

🔑 Hack #3 — Vetorização inteligente

Como conectar (passo a passo)
  1. 1. File search → Select vector store
  2. 2. Add files (50–200 inicialmente)
  3. 3. Aguardar indexação
  4. 4. Copiar ID da Vector Store
  5. 5. Colar no Agent Builder
💡 Dica de metadados

Adicione metadados a cada arquivo (ex: data, tipo, departamento) para melhorar a relevância das buscas. Arquivos com contexto = respostas mais precisas.

🟢 O que é

Widgets transformam respostas de texto em interfaces visuais: tabelas de agenda, recibos formatados, relatórios com gráficos. O usuário final vê um resultado bonito, não texto bruto.

💡 Por que aprender

Para tarefas complexas (agenda, relatórios, pedidos), widgets aumentam muito a usabilidade. Um template base reutilizável economiza tempo em todos os agentes.

🔑 Hack #4 — Template base de Widget

📅
Agenda

Slots de horário, confirmações, notificações

🧾
Recibos

Itens, totais, impostos, assinaturas

📊
Relatórios

Gráficos, KPIs, sumário executivo

Hack: Crie um template base e reutilize em TODOS os agentes. Quando o formato mudar, você atualiza só o template.

🟢 O que é

Otimizar o agente envolve: escolher o modelo certo (GPT-5 vs GPT-5-mini), ajustar o nível de raciocínio (low/medium/high), testar com carga realista e criar evals periódicas com 50+ exemplos.

💡 Por que aprender

Um agente não otimizado pode gastar 10x mais tokens do que o necessário. Evals automáticas identificam regressões antes de chegar aos usuários.

🔑 Hacks #5-#10 resumidos

5
Testes com carga realista

Simule 100 prompts, automatize via CSV (prompt / resposta esperada / status)

6
Ajuste de custo e raciocínio

GPT-5-mini (low reasoning) para tarefas simples; GPT-5 (medium) para decisões complexas

7
Logging e rastreabilidade

Ative logs, salve traces em S3/Drive com ID do usuário para auditoria

8
Fallbacks seguros

"Não encontrei essa informação, posso buscar no KB?" — nunca inventar respostas

9
Evals periódicas

50 exemplos mínimo, testar quinzenalmente guardrails, precisão e formato

← T2 Terminal Próxima: T4 BMAD →