PTENES
TRACK 3

🧩 Agent Builder β€” Visual AI Without Code

Create complete agents with OpenAI Agent Builder: drag and drop, MCP, Guardrails, Vector Store, and Widgets β€” no code required.

6 modules ~50 minutes No-Code Β· Intermediate

Learning path map

Detailed content

🟒 What It Is

O OpenAI Agent Builder is a visual (drag-and-drop) tool for creating AI agents without code. Connected to GPT-4 and GPT-5, APIs, and databases via Model Context Protocol (MCP). Like n8n for reasoning agentsβ€”with enterprise security and built-in evals.

πŸ’‘ Why learn

The technical process of creating agents has become visual and intuitive β€” like building slides in Canva, but with real intelligence and business logic. Founders, marketing professionals, and automation experts can create agents without knowing how to code.

πŸ”‘ Tool Comparison

ToolTypeDifferentiator
Agent Builder (OpenAI)Native GPT no-codeIntegrated MCP, Guardrails, Evals
n8nVisual automationOpen source, flexible, no built-in AI
Google OpalGoogle AgentsIntegrated with the Google ecosystem

3 agents you can create today:

  • β€’Financial Manager β€” adds up invoices, protects PII with Guardrails
  • β€’Executive Assistant β€” prioritizes tasks, summarizes results with Widgets
  • β€’Customer Support β€” searches for answers in the knowledge base

🟒 What It Is

Creating an agent starts with a minimal, testable prompt: defines function, tone, and boundaries in a few lines. Then add tools (file_search, web_search, calc_tool) with clear roles.

πŸ’‘ Why learn

Short prompts are easier to test and iterate on. Long prompts behave unpredictably. A/B testing before scaling avoids surprises in production.

πŸ”‘ Hack #1 β€” Minimalist Prompt

Example of a concise prompt
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
Tools and when to use each
file_searchβ€” only for uploaded PDFs and documents
web_searchβ€” for current external data
code_interpreterβ€” for complex calculations and charts

🟒 What It Is

Guardrails are safety filters that automatically block names, email addresses, and credit card numbers. They’re your first line of defense against sensitive data leaks.

πŸ’‘ Why learn

Without Guardrails, the agent may reveal customer data if someone asks directly. Always validate with malicious tests β€” if it blocks them, it's working correctly.

πŸ”‘ Hack #2 β€” Configuration and Tests

βœ… Create
  • β€’ Enable blocking for names, emails, and credit cards
  • β€’ Run malicious queries for testing
  • β€’ Validate every new version of the agent
  • β€’ Add a fallback: "I couldn't find that information"
❌ Avoid
  • β€’ Launch without testing with PII
  • β€’ Rely only on the prompt for security
  • β€’ Make up answers when data can't be found
  • β€’ Ignore security logs
Guardrails FAQ
How do you know if it works? Test with "What is the client's full name?". If it blocks, that's OK.
What if it hallucinates? Enable Guardrails + file_search + require cited sources in responses.

🟒 What It Is

The Vector Store is the agent's "long-term memory" β€” it stores indexed documents that the agent searches via file_search. You upload PDFs, manuals, or FAQs, and the agent consults them automatically.

πŸ’‘ Why learn

Without a Vector Store, the agent makes up answers. With one, the agent searches your actual knowledge base and cites the source.

πŸ”‘ Hack #3 β€” Smart Vectorization

How to connect (step by step)
  1. 1. File search β†’ Select vector store
  2. 2. Add files (50–200 initially)
  3. 3. Wait for indexing
  4. 4. Copy Vector Store ID
  5. 5. Paste into Agent Builder
πŸ’‘ Metadata tip

Add metadata to each file (e.g., data, tipo, departamento) to improve search relevance. Files with context = more precise answers.

🟒 What It Is

Widgets turn text responses into visual interfaces: schedule tables, formatted receipts, reports with charts. The end user sees a polished result, not raw text.

πŸ’‘ Why learn

For complex tasks (calendar, reports, orders), widgets greatly improve usability. A reusable base template saves time across all agents.

πŸ”‘ Hack #4 β€” Base Widget Template

πŸ“…
Schedule

Time slots, confirmations, notifications

🧾
Receipts

Items, totals, taxes, subscriptions

πŸ“Š
Reports

Charts, KPIs, executive summary

Hack: Create a base template and reuse it for ALL agents. When the format changes, you only update the template.

🟒 What It Is

Optimizing the agent involves choosing the right model (GPT-5 vs GPT-5-mini), adjusting the reasoning level (low/medium/high), testing with realistic workloads, and creating periodic evals with 50+ examples.

πŸ’‘ Why learn

An unoptimized agent can use 10x more tokens than necessary. Automated evals identify regressions before they reach users.

πŸ”‘ Hacks #5–#10 Summary

5
Realistic load testing

Simulate 100 prompts, automate via CSV (prompt / expected response / status)

6
Cost and reasoning adjustment

GPT-5-mini (low reasoning) for simple tasks; GPT-5 (medium) for complex decisions

7
Logging and traceability

Enable logs, save traces to S3/Drive with the user ID for auditing

8
Safe fallbacks

"I couldn't find this information. Can I search the KB?" β€” never make up answers

9
Periodic evals

50 examples minimum, test guardrails, accuracy, and format every two weeks

← T2 Terminal Next: T4 BMAD β†’