ahmeego.com

The Complete 5-Day
AI Agents Crash Course

From Absolute Zero to Deploying Multi-Agent Systems

A Step-by-Step Tutorial for Every Experience Level

FREEOPEN SOURCE28 ACTIONS 6 SUB-AGENTS5 WHITE PAPERSMCP + A2A 5 GAMESAPA 7th42 PAGES ANTHROPIC ACADEMYINTERACTIVE QUIZZESXP + BADGES
Day 1 Day 2 Day 3 Day 4 Day 5

CLICK TO MARK DAYS COMPLETE · PROGRESS SAVED LOCALLY

COURSE COMPLETE

You've finished all 5 days. You now understand AI agents from fundamentals to production multi-agent systems.

Start Your Free AuditExplore All Tools

You've learned how AI agents work. Now use one — connect your Google Ads account and let Buddy audit it for free.


Author

John Williams — Senior Paid Media Specialist at Seer Interactive. 15+ years, $350M+ managed. Creator of ahmeego.com. Hero Conf 2025 + 2026 speaker. Former WSU football (2002–2005). Casteel HS assistant coach.

Choose Your Path

Path Who Focus Time/Day
🟢 OBSERVER Executives, strategists Concepts only 2–3 hrs
🔵 BUILDER Marketers, analysts Hands-on + games 4–6 hrs
🟣 ARCHITECT Developers, engineers Deep theory + prod 6–8 hrs

5-Day Curriculum

Day Topic White Paper Game
0 Environment Setup
1 Introduction to AI Agents Introduction to Agents 🎮 Tetris
2 Agent Tools & MCP Agent Tools & MCP 🎮 Zelda
3 Context Engineering Sessions & Memory 🎮 Football
4 Agent Quality Agent Quality 🎮 Mario
5 Production & Multi-Agent Prototype to Production 🎮 Duck Hunt + RPG

The ahmeego.com Through-Line

🤖 GOOGLEADSAGENT.AI
An open-source AI agent with 28 custom Python API actions and 6 Disney-named sub-agents (🦁 Simba, 🐠 Nemo, ❄️ Elsa, 🧞 Aladdin, 🌊 Moana, 🤖 Baymax) managing Google Ads via live API. Built on Claude. Every course concept maps to a real component.
Concept Implementation Day
Brain Claude by Anthropic (Sonnet 4.6 baseline, user-selectable models) 1
Tools 28 Python API actions with live read/write 2
MCP Adapter layer: tool_executor.py 2
Context CEP Protocol + Session State Manager 3
Quality Top-Down Reporting + CONFIRM write-safety 4
Multi-Agent 🦁 Simba · 🐠 Nemo · ❄️ Elsa · 🧞 Aladdin · 🌊 Moana · 🤖 Baymax 5
Production CLI · REST API · Docker · Python SDK 5

Version 5.0 · March 2026 · Free & Open Source · It All Started With A Idea

PLATFORM ARCHITECTURE 2026 — From Prototype to Production
The table above describes the open-source Python CLI agent (the course's reference implementation). The live platform at ahmeego.com has evolved significantly:

Concept Open-Source (Course) Live Platform (2026)
Brain Claude via Python SDK Server-side orchestrator (brain.js) on Cloudflare Workers with SSE streaming
Tools 28 Python actions + tool_executor.py 27+ tool_use functions via Anthropic/OpenAI/Gemini APIs with live Google Ads API v22
Context CEP Protocol + Session State Manager 6-layer context packing: system prompt, business context, KV-backed sessions (7-day TTL), cross-session memory ledger, entity graph, and live tool results
Quality CONFIRM protocol + Top-Down Reporting 3-tier intent classification (regex → cache → Sonnet), credit gating on response quality, cache-served data discounts
Multi-Agent 6 Disney sub-agents as separate processes delegate_to_specialist tool with 5 specialist modes, server-side parallel execution
Deployment CLI · REST API · Docker Cloudflare Pages + Workers, KV/R2/D1/Vectorize, browser-based SaaS with OAuth
This evolution is itself a lesson: every production system starts as a prototype. The course teaches the concepts; the live platform shows how they scale.

Preface

Why This Course Exists

In 15+ years of managing over $350M+ in digital advertising spend across Google Ads, Meta, Microsoft, and Amazon — at NortonLifeLock, Gen Digital, Avast, and Farmers Insurance — I've watched the industry transform three times. Programmatic buying. ML bidding. And now, the agentic era.

The industry is moving from AI that suggests to AI that acts. Google CEO Sundar Pichai declared at I/O 2025 that agentic capabilities represent "the direction where we are investing the most," and predicted 2026 as "the year people use agentic experiences more broadly" (Alphabet Inc., 2025).

I built ahmeego.com — 28 API actions, 6 sub-agents, live Google Ads access, built on Claude — because this future was arriving faster than practitioners realized.

📖 CITATION
"We think of agents as systems that combine the intelligence of advanced AI models with access to tools, so they can take actions on your behalf and under your control."
— Sundar Pichai, Google I/O 2025 · source ↗
📖 CITATION
"Over the last year, we have been investing in developing more agentic models, meaning they can understand more about the world around you, think multiple steps ahead, and take action on your behalf."
— Demis Hassabis, Gemini 2.0 Launch · source ↗

How to Use This Course

Sequential: Section 0 → Day 1 → Day 5. Best for first-time learners.

Reference: Sidebar navigation. Each section is self-contained.

Workshop: Each day has labs, games, and assessments — classroom-ready.

Quick scan: Executive Summary + Glossary + Resource Library.

Acknowledgments

Google's Kaggle team (Wiesinger, Marlow, Vuskovic) for the white paper series. Anthropic's MCP and Claude. Google's A2A team. LangChain, CrewAI, AutoGen communities. Microsoft's AI Agents course. Colleagues at Seer Interactive and Casteel High School coaching staff.

Executive Summary

AI agents — autonomous systems that reason, plan, and execute — are replacing dashboards and manual optimization. Google, Anthropic, OpenAI, and Microsoft are investing billions.

This 5-day course covers: (1) Agent fundamentals and ReAct loops; (2) Tool architecture and MCP; (3) Context engineering and scratchpad patterns; (4) Evaluation, observability, and guardrails; (5) Multi-agent orchestration, A2A, and Google's Universal Commerce Protocol.

Each day: required readings · resource matrix · hands-on labs · screen verification callouts · vibe coding game · learning objectives · key takeaways · self-assessment.

Three paths (🟢 Observer, 🔵 Builder, 🟣 Architect). Free. Open source. 42 pages. APA 7th Edition.

Section 0: Complete Environment Setup

Install and verify all tools before Day 1. Time: 30–45 minutes.

Part A: Claude AI

Primary AI assistant. Powers ahmeego.com.

1
Navigate to claude.ai. Any modern browser.
2
Sign Up → Continue with Google (fastest) or email.
3
Email: enter address, retrieve 6-digit code, enter it.
4
Phone verification (SMS). One phone per account; 18+.
5
Accept Terms of Service.
6
Chat interface loads. Ready.
💻 WHAT YOU SHOULD SEE
Clean interface with 'What can I help you with?' input. Left sidebar: New Chat + history. Account icon bottom-left.
Feature Free Pro ($20/mo)
Model Sonnet Opus (most intelligent)
Messages/day ~30–45 5× more
Uploads / Artifacts / Search
💡 PRO TIP
Free tier is sufficient for this entire course. ahmeego.com early prototypes were built on free tier.

Verification

You are a Research Agent. Explain what an AI agent is in\n3 sentences as if speaking to a colleague at a coffee shop,\nthen provide one real-world example.

Part B: ChatGPT

1
Go to chatgpt.com. Sign up.
2
Complete verification. Chat loads.

Part C: Cursor IDE

"Vibe coding" — describe what you want, AI writes the code (Karpathy, 2025).

1
cursor.com → Download (auto-detects OS).
2
Install. Launch. Sign in via gear icon.
3
Open AI Chat: Cmd+I (Mac) / Ctrl+I (Win).
💻 WHAT YOU SHOULD SEE
Three panels: Left = File Explorer. Center = editor. Bottom = Terminal. Right = AI Chat.

Part D: Kaggle

1
kaggle.com → Register.
2
Phone verify: Settings → Phone Verification.
⚠️ CRITICAL
Phone verification is MANDATORY for running the interactive Codelabs with the white papers.

Part E: GitHub

1
github.com → Sign Up. Verify email.
2
Bookmark: White Papers · Microsoft Course · A2A · MCP

Part F: Python 3.12+

1
python.org → Download 3.12+.
2
CHECK 'Add Python to PATH' before Install.
3
Verify: python --version → 3.12.x

Pre-Course Checklist

Tool Action Verify
Claude Account at claude.ai Test prompt works
ChatGPT Account at chatgpt.com Test prompt works
Cursor Downloaded + installed Editor visible
Kaggle Account + phone verified Notebooks accessible
GitHub Account created 4 repos bookmarked
Python Installed with PATH python --version = 3.12+

All verified? → Day 1.

Day 1: Introduction to AI Agents

🤖 GOOGLEADSAGENT.AI
ahmeego.com is a production AI agent — not a chatbot. It has a brain (Claude), tools (28 API actions with live Google Ads access), and an orchestration loop (6 Disney-named sub-agents: 🦁 Simba for reporting, 🐠 Nemo for research, ❄️ Elsa for optimization, 🧞 Aladdin for Shopping/PMax, 🌊 Moana for creative, 🤖 Baymax for innovation).

🎯 Learning Objectives

  • Define an AI agent and distinguish it from a chatbot
  • Identify the three components: Brain, Tools, Loop
  • Explain the ReAct loop and autonomous reasoning
  • Compare five agent architecture patterns
  • Build a functional game with vibe coding

What Is an AI Agent?

An AI agent is software that uses a large language model as its reasoning engine to autonomously perceive, decide, and act to accomplish goals (Google, 2025). The key difference from a chatbot is autonomy: agents decompose goals, select tools, execute, evaluate, and iterate.

📖 CITATION
"This combination of reasoning, logic, and access to external information that are all connected to a Generative AI model invokes the concept of an agent."
— Google, 'Introduction to Agents' White Paper · source ↗

Analogy: Ask a chatbot about vacation → it describes beaches. Give an agent the same request → it researches flights, compares prices, books the optimal option, reserves a hotel, adds calendar entries, sends confirmation. The chatbot generates text. The agent generates outcomes.

The Three Components

1. The Brain (Foundation Model)

Claude, GPT, or Gemini — the reasoning engine. Interprets intent, formulates plans, selects tools. In ahmeego.com: Claude Sonnet 4.6 as the baseline, with user-selectable models including GPT-5.4-pro and Gemini 3 Flash.

2. The Tools

Executable functions: APIs, databases, search engines, file systems. Without tools, the model reasons but cannot act. ahmeego.com: 28 Python API actions in actions/main-agent/.

Category Example Actions Count
Campaign Budget Manager, RSA Ad Manager, Campaign Creator 6
Analysis Search Term Manager, Device Performance, Change History 5
Optimization Recommendations, Bidding Strategy, Ad Schedule 4
Organization Label Manager, Negative Keywords, Asset Manager 3
Targeting Audience Manager, Geo & Location Manager 2
Infrastructure API Gateway, Session Manager, Package Installer 6
Creative Cloudinary Creative Tools 1
PMax PMax Asset Group Manager 1

3. The Loop (ReAct Orchestration)

Reason → Act → Observe → Repeat. ahmeego.com's "The Loop":

1
User submits a question.
2
CEP Protocol: Agent asks clarifying questions (Account? Date range? Threshold?).
3
Top-Down Reporting: account summary first, then drill-down.
4
Adapter Layer: load action → inject secrets → filter → execute via tool_executor.py.
5
Google Ads API: real data, real mutations, all costs in dollars.
6
Claude analyzes, validates completeness against account totals.
7
Write Safety: Writes require CONFIRM with current-vs-proposed preview.
8
Heavy tasks delegated to Disney-named sub-agents.

Chatbot vs. Agent

Dimension Chatbot AI Agent
Interaction Reactive (responds) Goal-directed (pursues)
Memory Single conversation Persistent across sessions
Tools None (text only) APIs, databases, search, files
Error Recovery 'I don't know' Tries alternatives
Output Text responses Real-world actions
Verification None Cross-validates data
Example Claude answering a question ahmeego.com auditing $50K/mo

Architecture Patterns

Pattern Mechanism Use Case Example
ReAct (Single) Think→Act→Observe loop Focused tasks Search agent
Router Classify + delegate Multi-domain Customer service triage
Parallel Multi-Agent Concurrent execution Independent tasks Multi-source research
Sequential Multi-Agent Pipeline: A→B→C Dependent workflows ahmeego.com audits
Hierarchical Manager → workers Enterprise scale Automated campaign mgmt

Required Reading

Primary: Google & Kaggle. (2025). "Introduction to Agents." kaggle.com/whitepaper-agents ↗

Supplementary: Microsoft. AI Agents for Beginners, Lessons 1–3. GitHub ↗

Resource Matrix

Resource Format Cost
Google/Kaggle: Introduction to Agents White Paper (42 pp.) Free
Anthropic: Claude 101 Course + Certificate Free
Anthropic: AI Fluency Course + Certificate Free
Microsoft: AI Agents for Beginners Course (12 lessons) Free
Hugging Face: AI Agents Course Course + Certificate Free
DeepLearning.AI: Agents in LangGraph Short Course Free
Agent Academy Course + Certificate Free

Lab 1A: Agent-Style Reasoning

1
Open Claude. New conversation.
2
Enter this prompt:
You are a Google Ads Audit Agent. A client runs 15 Search\ncampaigns at $50,000/month. CPA has increased 40% over 3 months.\n\nCreate a systematic audit plan. For each step, specify:\n(a) The exact data required\n(b) The API endpoint or tool to retrieve it\n(c) Metrics and red flags to evaluate\n(d) Conditional recommendations based on findings
💻 WHAT YOU SHOULD SEE
Claude produces a 6–10 step audit plan with data requirements, API endpoints, metrics, and conditional recommendations — mirroring ahmeego.com's Audit Agent workflow.

🎮 Vibe Coding: Tetris

1
Open Claude. New conversation.
2
Enter:
Build a fully playable Tetris game as a single HTML file.\n- Classic rules: 7 tetrominoes, rotation, line clearing\n- Arrow keys to move/rotate, spacebar for hard drop\n- Score, next piece preview, level progression\n- Game over + restart, dark bg, smooth animations\n- Ghost piece showing landing position
💻 WHAT YOU SHOULD SEE
Fully playable Tetris in Claude's Artifact panel. Arrow keys control. Spacebar hard-drops. Lines clear with animation. Ghost piece visible.
💡 PRO TIP
To iterate: 'Add hold-piece (C key)' or 'Add touch controls for mobile.'

AI Agents Across Ad Platforms

The Brain + Tools + Loop pattern applies to every major advertising platform. Each platform has its own API, data structures, and optimization levers — but the agent architecture is identical.

Platform API Agent Use Cases Key Metrics
Google Ads Google Ads API + GAQL Search term mining, bid optimization, RSA generation, negative keyword management, budget reallocation CPA, ROAS, Quality Score, Impression Share
Meta Ads Marketing API + Graph API Creative fatigue detection, audience expansion, Advantage+ optimization, CAPI event management CPM, CTR, Frequency, Cost per Result
Microsoft Ads Bing Ads API Google-to-Microsoft mirroring, LinkedIn audience targeting, Copilot-assisted optimization CPC, Impression Share, Audience Overlap
Amazon Ads Sponsored Ads API Bid optimization, search term harvesting, listing optimization, ACoS management ACoS, TACoS, Organic Rank, BSR

Google Ads: Where Agents Shine

Google Ads is the most agent-ready platform because of its mature API, rich data model (GAQL), and complex optimization surface. ahmeego.com demonstrates this with 28 live API actions covering:

Meta Ads: Creative Intelligence

On Meta, the #1 performance lever is creative — and AI agents excel at creative analysis and generation:

PRACTITIONER INSIGHT
"After $350M+ in managed spend across Google, Meta, Microsoft, and Amazon, the highest-ROI use case for AI agents in advertising is automated search query analysis. An agent reviewing 10,000 search terms finds patterns a human would miss — and it does it in seconds, not days."
— John Williams, Senior Paid Media Specialist, Seer Interactive
PLATFORM EVOLUTION — Day 1 Concepts in Production
On the live platform, the ReAct loop runs server-side in brain.js with SSE streaming. The intent engine classifies every message through a 3-tier system (regex → in-memory cache → Sonnet) before the loop even starts. The Brain supports multiple foundation models — Claude Sonnet 4.6 as baseline, with GPT-5.4-pro and Gemini 3 Flash selectable by the user. Try it: Open the Buddy chat widget on this page and ask "What tools do you have?" to see the live agent respond.

✅ Key Takeaways

  • Agents differ from chatbots in autonomy, tool access, and iterative reasoning.
  • Every agent: Brain (LLM) + Tools (functions) + Loop (ReAct orchestration).
  • ahmeego.com: Claude as Brain, 28 actions as Tools, The Loop as orchestration.
  • Vibe coding — natural-language software development — is the foundational agent skill.
  • The same agent architecture applies to Google Ads, Meta, Microsoft, and Amazon — only the APIs differ.

🧪 Day 1 Quiz — 5 Questions · 50 XP

Score: / 5

1. What is the core loop pattern agents use for autonomous reasoning?

2. What are the three components every AI agent has?

3. Which sub-agent handles Reporting in ahmeego.com?

4. What makes an AI agent different from a chatbot?

5. When is using an AI agent unnecessarily complex?

TRY IT NOW — Day 1 Concepts Live
You just learned Brain + Tools + Loop. Now see it in action:

1. Talk to the agent: Open the Buddy chat widget (bottom-right) and ask: "What tools do you have?" — watch the ReAct loop respond with its full capability set.

2. Run a live audit: Open the Audit Engine — it uses the exact agent architecture from this lesson to run a 250-point Google Ads audit.

3. Build ads with AI: Open the Google Ads Builder — AI-powered RSA generation with character-limit guardrails.

4. Go deeper: Tutorial: Building Your First AI Agent | The AI Playbook Blog (42 articles)
✓ MARK DAY 1 COMPLETE

Day 2: Agent Tools & MCP

🤖 GOOGLEADSAGENT.AI
Each of ahmeego.com's 28 API actions is a tool. The adapter layer (tool_executor.py) loads actions, injects credentials, filters parameters, and executes — standardized interface between brain and Google Ads API. MCP formalizes this as an industry standard.

🎯 Learning Objectives

  • Explain how agents use tools to interact with external systems
  • Trace the six-step tool-use execution cycle
  • Define MCP and its three architectural components
  • Analyze implications of universal tool interoperability
  • Design a tool schema for an MCP server

The Tool-Use Cycle

1
Goal Reception: User provides objective ('Find wasted spend').
2
Reasoning: LLM determines tool needed ('Search Term Manager').
3
Structured Call: LLM outputs formatted request: {{ action: 'search_term_manager', params: {{ date_range: '30d' }} }}
4
Execution: Infrastructure processes request. tool_executor.py loads action, injects credentials, calls API.
5
Result Injection: Raw API data returned to LLM context.
6
Synthesis: LLM interprets: 'You're spending $3,200/month on irrelevant terms. Here are 15 negative keyword recommendations.'

Tool Categories in ahmeego.com

Category Actions Count
Campaign Budget, Campaign Creator, RSA Ad Manager, Bid & Keyword, Mutate, Campaign & Ad Group 6
Analysis Search Term, Query Planner, Device Performance, Change History, Conversion Tracking 5
Optimization Recommendations, Bidding Strategy, Experiments, Ad Schedule 4
Organization Label Manager, Negative Keywords, Asset Manager 3
Targeting Audience Manager, Geo & Location Manager 2
Infrastructure API Gateway, Session Manager, Package Installer, Scripts, Account Access, Check User 6
Creative / PMax Cloudinary Creative Tools, PMax Asset Group Manager 2

Model Context Protocol (MCP)

MCP is an open standard by Anthropic (Nov 2024) providing a universal interface for connecting AI to tools. Analogy: USB-C — before it, every device needed a unique cable. Before MCP, every AI app needed custom integration code. MCP standardizes the connection.

📖 CITATION
"We're excited to announce that our Gemini API and SDK are now compatible with MCP tools."
— Sundar Pichai, Google I/O 2025 · source ↗

MCP Architecture

Host: The AI application (Claude Desktop, Cursor). User-facing interface.

Client: Embedded in the host. Manages connections to MCP servers.

Server: Lightweight service exposing: Tools (functions), Resources (data), Prompts (templates).

💡 PRO TIP
If ahmeego.com's 28 actions were an MCP server, ANY compatible app — Claude, ChatGPT, Cursor — could instantly manage Google Ads without custom code.

Resource Matrix

Resource Format Cost
Google/Kaggle: Agent Tools & MCP White Paper Free
Anthropic: Intro to MCP Course + Certificate Free
Anthropic: MCP Advanced Topics Course + Certificate Free
Anthropic: Claude Code in Action Course + Certificate Free
MCP Official Docs Technical Free — modelcontextprotocol.io
MCP GitHub SDKs Open Source Free — GitHub
MCP Server Directory Directory Free — mcp.so

Lab 2A: Observing Tool Use

Search the web for the latest MCP announcements from the past\n30 days. Summarize the top 3 developments and analyze\nimplications for digital advertising.
💻 WHAT YOU SHOULD SEE
Claude activates web search — 'Searching…' indicator appears. Results return with citations. This is the same pattern as ahmeego.com's 28 tool calls.

Lab 2B: Design a Tool Schema

Design a tool schema for a Google Ads Search Term Analyzer.\nSpecify: (1) tool name + description, (2) typed input parameters,\n(3) structured output format, (4) error cases.\nFormat as JSON for an MCP server definition.

🎮 Vibe Coding: Zelda Adventure

Build a Zelda-style top-down adventure game as a single HTML file.\n- Arrow keys/WASD movement, spacebar sword attack\n- Overworld: grass, trees, water, paths\n- 3+ enemy types with patterns and damage\n- 3 hearts, rupees, health pickups\n- Multiple connected rooms with edge transitions\n- Mini-map showing explored rooms\n- SNES pixel-art aesthetic

Tools Across Advertising Platforms

Each advertising platform exposes tools through its API. Here's how agents interact with the major platforms:

Google Ads API — GAQL in Practice

Google Ads Query Language (GAQL) is how agents retrieve data. Instead of clicking through the UI, an agent writes structured queries:

SELECT campaign.name, metrics.cost_micros, metrics.conversions,
       metrics.cost_per_conversion
FROM campaign
WHERE segments.date DURING LAST_30_DAYS
  AND metrics.cost_micros > 0
ORDER BY metrics.cost_per_conversion DESC
LIMIT 10

ahmeego.com's Search Term Manager uses GAQL to pull thousands of search queries, then Claude analyzes intent patterns and recommends negatives. This is the same pattern any MCP-connected agent could use.

Meta Marketing API — Creative Analysis

Meta's API enables agents to monitor creative performance and detect fatigue:

# Meta Marketing API — Ad creative insights
GET /act_{ad_account_id}/insights
  ?fields=ad_name,impressions,clicks,spend,
          actions,cost_per_action_type,
          frequency,video_avg_time_watched_actions
  &date_preset=last_30d
  &level=ad
  &filtering=[{"field":"impressions","operator":"GREATER_THAN","value":1000}]

An agent monitors frequency (>3.0 signals fatigue), CTR decay (>20% drop week-over-week), and cost per result trends to automatically flag creatives that need refreshing.

Google Ads Scripts — Accessible Automation

For practitioners who aren't developers, Google Ads Scripts offer the most accessible automation entry point. Scripts run directly in the Google Ads UI:

// Pause keywords with high CPA and no conversions (30 days)
function main() {
  var keywords = AdsApp.keywords()
    .withCondition("Conversions = 0")
    .withCondition("Cost > 50")
    .forDateRange("LAST_30_DAYS")
    .get();
  while (keywords.hasNext()) {
    var kw = keywords.next();
    kw.pause();
    Logger.log("Paused: " + kw.getText() + " ($" + kw.getStatsFor("LAST_30_DAYS").getCost() + ")");
  }
}

AI-Powered Tool Frameworks

Framework Best For Advertising Use Case
Claude Projects No-code custom assistants Account strategist with brand guidelines as knowledge base
LangChain / LangGraph Stateful agent workflows Multi-step campaign audit with memory between steps
CrewAI Role-based multi-agent Analyst + Strategist + Creative agent teams
n8n / Make No-code workflow automation Slack alerts when CPA exceeds threshold
OpenAI Agents SDK Production agent deployment Client-facing reporting bots
Google ADK Google ecosystem agents Vertex AI + Google Ads integration
PLATFORM EVOLUTION — Day 2 Concepts in Production
The live platform's 27+ tools are defined in the BUDDY_TOOLS array in brain.js — each with a JSON schema that the model sees via the tools API parameter. Tool execution happens server-side: the Brain receives a tool_use block from Claude, routes it to the appropriate handler (Google Ads API, web search, file export, etc.), injects OAuth credentials from encrypted KV storage, and returns results back to the model's context. This is the same 6-step tool-use cycle taught in this lesson, running at production scale on Cloudflare Workers.

✅ Key Takeaways

  • Tools transform an LLM from text generator into an agent that acts.
  • MCP standardizes AI-tool connections, eliminating custom integration.
  • Tool-use cycle: goal → reasoning → structured call → execution → result → synthesis.
  • MCP adoption by Google, OpenAI, Microsoft signals industry convergence.
  • GAQL, Meta Marketing API, and Google Ads Scripts are the three most important tool interfaces for advertising agents.
  • Frameworks like LangChain, CrewAI, and n8n make it accessible to build agents without deep engineering.

🧪 Day 2 Quiz — 4 Questions · 40 XP

Score: / 4

1. What is MCP (Model Context Protocol)?

2. What are the three MCP architectural components?

3. How many Python API actions does ahmeego.com have?

4. What is the correct order of the tool-use execution cycle?

TRY IT NOW — Day 2 Tools Live
You just learned the 6-step tool-use cycle. Now watch tools execute in real-time:

1. See tool schemas: Open the Marketing Auditor — connect your API key and ask Buddy to show available tools. Watch the structured call → execution → synthesis cycle live.

2. Try keyword tools: Keyword Analyzer — 3 analysis modes using live SERP data. This is the tool-use cycle applied to keyword research.

3. Generate ad copy: Social Media Ad Builder — Generate copy for 8 platforms with one prompt. The build_creative tool in action.

4. View the source: GitHub: All 28 API Actions — read the actual tool definitions.
✓ MARK DAY 2 COMPLETE

Day 3: Context Engineering

🤖 GOOGLEADSAGENT.AI
ahmeego.com's CEP Protocol (Clarifying Exchange Protocol) is context engineering in action: before any API call, the agent asks qualifying questions (Which account? ENABLED only? Date range? Spend threshold?). The Session & State Manager (Action #17) maintains state. Sub-agents write findings to shared context.

🎯 Learning Objectives

  • Define context engineering vs. prompt engineering
  • Identify the six layers of agent context
  • Explain the scratchpad pattern for multi-step workflows
  • Describe RAG and its role in grounding responses
  • Compare five memory management strategies

What Is Context Engineering?

The discipline of designing the complete information payload that flows into an agent's prompt at each step. It determines what the agent knows, remembers, and how it personalizes behavior.

📖 CITATION
"Context Engineering is concerned with the entire payload, dynamically constructing a state-aware prompt based on the user, conversation, and external data… transforming an agent from an expert on facts to an expert on the user."
— Google, 'Context Engineering' White Paper · source ↗

Six Layers of Context

Layer Contents ahmeego.com
1. System Instructions Identity, rules, capabilities Main agent system prompt (The Loop)
2. User Profile Identity, preferences, access Account ID, credential pattern, permissions
3. Short-Term Memory Current conversation Active thread with Q&A
4. Long-Term Memory Persistent cross-session Previous audits, baselines
5. RAG Documents pulled on demand Google Ads docs, best practices
6. Tool Results Data from tool execution Live metrics, search terms, budgets
IMPLEMENTATION DEEP-DIVE — 6 Layers in brain.js
The live platform's buildMessagesForAI() function implements all 6 layers in a single context-packing pass:

Layer 1 (System Instructions): The SYSTEM_PROMPT constant — conversation quality rules, CONFIRM protocol, tool categories, and execution rules. Sent with cache_control: { type: 'ephemeral' } for Anthropic prompt caching.
Layer 2 (User Profile): Business context from OAuth (session.businessContext), account fingerprint with spend tier and CPA, detected user domain vs. platform domain.
Layer 3 (Short-Term): Last 30 messages with compression — recent 5 in full, older messages with data tables replaced by summaries. Old [LIVE DATA] blocks are truncated to save tokens.
Layer 4 (Long-Term): Cross-session memory via the Context Ledger in Cloudflare KV (90-day TTL). Decision track record with outcome tracking. Competitor data persisted across sessions.
Layer 5 (RAG): Context Layer with entity graph, semantic compression (hot/warm/cold tiers), and Vectorize for embedding-based retrieval.
Layer 6 (Tool Results): Account snapshots formatted as structured summaries (~80% fewer tokens than raw JSON), pending operations with params, and recent write history.

The companion chat widget uses a lighter version: KV-backed sessions (companion:{sessionId}) with 24-hour TTL, client-side history as fallback, and page/UTM/referrer context enrichment.

The Scratchpad Pattern

Instead of raw conversation history (noisy, overflows context), the agent maintains a structured working document. In ahmeego.com: 🦁 Simba writes to Reporting section, ❄️ Elsa to Optimization, 🐠 Nemo to Research. Final synthesis reads the complete scratchpad.

RAG: Retrieval-Augmented Generation

Query a vector database, retrieve only semantically relevant chunks. Grounds responses in source material rather than potentially outdated training data. Scales to massive knowledge bases.

Memory Strategies

Strategy Mechanism Pro Con
Full History Every message in each call Maximum accuracy Context overflow
Sliding Window Keep recent N messages Bounded memory Loses early context
Summarization Condense older messages Preserves key facts Info loss risk
Scratchpad Structured findings doc Best balance Requires schema design
RAG Vector DB retrieval Scales massively Infrastructure needed
IMPLEMENTATION DEEP-DIVE — Memory Strategies in Production
The live platform uses all five strategies simultaneously, layered by recency and importance:

Full History: Stored in KV (SESSIONS) — up to 60 messages per session, 7-day TTL. The complete conversation persists across browser closes.
Sliding Window: buildMessagesForAI() takes the last 30 messages for the prompt. Messages 31+ are summarized.
Summarization: Messages older than 30 are reduced to topic snippets. Assistant messages with large data tables (detected by |---| patterns) are compressed to their first paragraph when older than 5 turns.
Scratchpad: The Context Ledger (context-layer.js) stores structured decisions, findings, and preferences that persist across sessions — not raw data, but understanding. Entries are priority-ranked (critical/high/medium/low) with 90-day TTL.
RAG: Cloudflare Vectorize (buddy-memory) for embedding-based retrieval of relevant past findings. Entity graph tracks relationships between campaigns, keywords, and actions.

For Anthropic specifically, the platform also uses the vendor's context_management beta: auto-compaction triggers at 120K input tokens, and stale tool-use clearing at 80K tokens (keeping the 3-5 most recent).

🎮 Vibe Coding: Football (Tecmo Bowl)

Build an American football arcade game (Tecmo Bowl style)\nas a single HTML file.\n- Top-down field with yard lines and end zones\n- Arrow keys control QB/ball carrier\n- 5 offense vs 5 defense players\n- Play selection screen (4 plays)\n- Spacebar to pass, arrows to aim\n- Tackle detection, scoring, downs system\n- Touchdown celebration, 8-bit aesthetic

Context Engineering for Advertising

Advertising agents need specialized context that general-purpose agents don't. Here's what makes ad context engineering unique:

Prompt Engineering for Ads

Before context engineering, you need solid prompts. The four essential patterns for advertising agents:

Pattern How It Works Ad Example
System Prompt Sets identity, rules, constraints "You are a Google Ads audit agent. Always validate data sums against account totals. Never recommend budget changes >20% without CONFIRM."
Few-Shot Provide examples of desired behavior Show 3 examples of good vs. bad negative keyword recommendations with reasoning
Chain-of-Thought Step-by-step reasoning "First calculate CPA by campaign, then identify outliers >2x average, then check search terms for those campaigns..."
Role Prompting Assign a persona with expertise "You are a senior PPC strategist with 15 years managing $350M+ in spend. Analyze this account like you would for a client paying $500/month."

RAG for Advertising Knowledge

RAG (Retrieval-Augmented Generation) is critical for grounding ad agents in current, accurate data:

RAG IMPLEMENTATION
A practical RAG setup for ad agents: Embed your Google Ads best practices, client SOPs, and industry benchmarks into a vector database (Pinecone, ChromaDB, or Qdrant). When the agent needs to make a recommendation, it retrieves the 5 most relevant chunks and includes them in context. This prevents hallucinated benchmarks and ensures recommendations align with your methodology.

Context Across Platforms

Platform Unique Context Needed Data Volume
Google Ads Search terms, Quality Scores, auction insights, ad extensions, GAQL schema 10K+ search terms/month typical
Meta Ads Creative performance, audience overlap, frequency curves, pixel events, attribution windows Hundreds of ad variations
Microsoft Ads Import mapping from Google, LinkedIn audience data, competitive metrics Mirrors Google + unique MSN data
Amazon Ads Product catalog, BSR, organic rank, review sentiment, FBA fees Thousands of ASINs

✅ Key Takeaways

  • Context engineering is complete information management — broader than prompt engineering.
  • Six layers: system, user, short-term, long-term, RAG, tool results.
  • Scratchpad pattern: optimal efficiency-accuracy balance for multi-step agents.
  • CEP Protocol: qualifying questions before any API execution.
  • RAG is essential for grounding ad agents in current benchmarks, policies, and account history.
  • Each ad platform requires unique context — search terms for Google, creative data for Meta, catalog data for Amazon.

🧪 Day 3 Quiz — 4 Questions · 40 XP

Score: / 4

1. How many layers of context does an agent use?

2. What is the scratchpad pattern?

3. What does CEP stand for in ahmeego.com?

4. What is RAG (Retrieval-Augmented Generation)?

TRY IT NOW — Day 3 Context in Action
You just learned the 6 layers of context and memory strategies. Now see them live:

1. Test multi-turn memory: Open the Buddy chat widget, ask a question, then ask a follow-up that references your first question. The companion chat uses KV-backed sessions — Buddy remembers across messages.

2. See session persistence: Open the Dashboard — connect via OAuth to see how user profile context (Layer 2) and tool results (Layer 6) flow into every agent response.

3. Watch context compression: Run a multi-step audit — the agent maintains a structured scratchpad of findings across tool calls, compressing older data tables while preserving key metrics.

4. Go deeper: 18 Tutorials — step-by-step implementations of agent context patterns.
✓ MARK DAY 3 COMPLETE

Day 4: Agent Quality

🤖 GOOGLEADSAGENT.AI
Quality mechanisms: (1) Top-Down Reporting validates details sum to account totals; (2) CONFIRM protocol requires user approval before mutations with current-vs-proposed preview; (3) Sub-agent principles: 🦁 'Summarize, don't dump' · ❄️ 'Preview before execute' · 🐠 'Insight over information.'

🎯 Learning Objectives

  • Name the three pillars of agent quality
  • Explain LLM-as-a-Judge evaluation
  • Describe input, output, and action guardrails
  • Analyze why hallucination is dangerous in advertising
  • Identify key observability metrics

The Quality Problem

A model hallucinating 5% of the time in casual conversation = minor annoyance. Hallucinating 5% while managing $50,000/month in ad spend = financial liability. Agent quality engineering closes this gap.

Three Pillars

Pillar 1: Evaluation

Unit: Test individual tool calls. Does Search Term Manager return accurate data?
Trajectory: Test reasoning path. Did it select the right tools in the right order?
Final Response: Is the audit report accurate and actionable?

Pillar 2: Observability

Logging: Timestamped records of every tool call and decision (flight recorder).
Tracing: End-to-end path from input through all tool calls to output.
Metrics: Latency, token usage, tool success rate, accuracy.

Pillar 3: Guardrails

Input: Validate requests fall within authorized scope.
Output: Verify responses for accuracy before delivery.
Action: Require human approval for high-impact operations. ahmeego.com's CONFIRM protocol: displays current vs. proposed, explains rationale, waits for confirmation before executing.

IMPLEMENTATION DEEP-DIVE — Guardrails in Production
The live platform implements all three guardrail types with multiple layers:

Input Guardrails: The companion chat has regex-based injection detection (INJECTION_PATTERNS) and off-topic keyword filtering. The intent engine uses a 3-tier classification system: instant regex matching (~90% of messages), in-memory cache with 5-minute TTL (eliminates duplicate Sonnet calls), and Claude Sonnet classifier for truly ambiguous messages. This is guardrail engineering applied to both safety and cost.

Output Guardrails: The verify_output tool self-checks character limits, math consistency, and data accuracy. Account snapshots are formatted as structured summaries instead of raw JSON — this prevents the model from misreading nested data structures.

Action Guardrails: CONFIRM protocol is enforced server-side in brain.js — the tool handler checks lastUserMsg for confirmation patterns before executing any mutation. Credit deduction is gated on response quality: errors and empty responses don't charge the user, and cache-served data gets a 0.5x cost multiplier. This means quality guardrails protect both the user's ad account and their wallet.

LLM-as-a-Judge

A separate LLM scores agent outputs against rubrics (accuracy, completeness, relevance, safety). Returns structured scores with justification. High correlation with human evaluators at dramatically lower cost.

Resource Matrix

Platform Function Cost
LangSmith LLM monitoring & tracing Free tier
Braintrust Evaluation platform Free tier
Arize Phoenix Open source tracing Free (OSS)
RAGAS RAG evaluation framework Free (OSS)

🎮 Vibe Coding: Super Mario Bros

Build a Super Mario Bros-style platformer as a single HTML file.\n- Side-scrolling, arrow keys + spacebar jump\n- Platforms, pipes, bricks, question-mark blocks\n- Breakable blocks yield coins from below\n- 2+ enemy types, jump to defeat\n- Coin counter, score, pit death, 3 lives\n- Flag pole to complete level\n- NES-era physics: momentum, gravity, acceleration

Quality for Advertising AI

Advertising introduces unique quality challenges that general AI applications don't face:

AI Safety in Ad Management

Risk Impact Guardrail
Budget Hallucination Agent recommends $50K budget when client cap is $5K Hard budget limits in system prompt + API-level validation
Policy Violation AI-generated ad copy violates Google editorial policies Output filtering against policy regex + human review queue
Prompt Injection Malicious search term data manipulates agent reasoning Input sanitization + sandboxed data processing
Metric Misreporting Agent confuses impressions with clicks in analysis Top-Down Reporting: totals must match account summary
Unauthorized Mutations Agent pauses profitable campaigns without approval CONFIRM protocol with current-vs-proposed preview

Creative Quality with AI

AI-generated ad creative needs specialized quality checks:

Search Query Quality System

One of the highest-value quality applications is automated search query analysis — the system ahmeego.com calls SQOS (Search Query Optimization System):

1
Extract — Pull all search terms with spend from the Google Ads API (GAQL)
2
Classify — LLM categorizes each query by intent: branded, high-intent, informational, irrelevant, competitor
3
Score — Calculate relevance score based on conversion rate, CPA, and intent match
4
Recommend — Generate negative keyword list (exact + phrase) for irrelevant queries; expansion keywords for high-performers
5
Validate — Human reviews recommendations; CONFIRM protocol before applying changes

Conversion Tracking Quality

Agents can also audit measurement infrastructure — the Marketing Analytics Auditor on ahmeego.com demonstrates this:

✅ Key Takeaways

  • Quality = Evaluation + Observability + Guardrails.
  • LLM-as-a-Judge: scalable, cost-effective evaluation against rubrics.
  • Hallucination in advertising = direct financial loss. Non-negotiable quality.
  • CONFIRM protocol: human checkpoints before data mutations.
  • SQOS (Search Query Optimization System) is the highest-ROI agent quality application for search advertisers.
  • Creative quality checks must cover editorial compliance, brand voice, character limits, and image policies across platforms.
  • Measurement quality (GA4, GTM, CAPI) is the foundation — agents are only as good as the data they analyze.

🧪 Day 4 Quiz — 4 Questions · 40 XP

Score: / 4

1. What are the three pillars of agent quality?

2. What does the CONFIRM protocol do?

3. Why is hallucination uniquely dangerous in advertising?

4. What is LLM-as-a-Judge?

TRY IT NOW — Day 4 Quality Guardrails
You just learned Evaluation, Observability, and Guardrails. Now see them enforced:

1. Test the CONFIRM protocol: Open the Marketing Auditor, connect your Google Ads account, and ask Buddy to add a negative keyword. Watch the CONFIRM protocol: current-vs-proposed preview, then explicit confirmation before any mutation.

2. See output guardrails: Google Ads Builder — generate RSA ads and watch how character limits (30-char headlines, 90-char descriptions) are enforced by the verify_output tool.

3. Test input guardrails: Try asking Buddy an off-topic question (recipes, weather). Watch the input guardrail redirect to advertising topics — the same injection/off-topic patterns from the lesson.

4. Go deeper: 14 Expert Articles — deep-dives into agent quality and optimization.
✓ MARK DAY 4 COMPLETE

Day 5: Production & Multi-Agent Systems

🤖 GOOGLEADSAGENT.AI
6 Disney-named sub-agents:
🦁 Simba (Sonnet 4.6, 8 actions): Reporting — 'Summarize, don't dump.'
🐠 Nemo (Sonnet 4.6, 4 actions): Research — 'Insight over information.'
❄️ Elsa (Sonnet 4.6, 8 actions): Optimization — 'Preview before execute.'
🧞 Aladdin (Sonnet 4.6, 7 actions): Shopping/PMax — 'ROAS is king.'
🌊 Moana (Sonnet 4.6, 2 actions): Creative — 'Visual first.'
🤖 Baymax (Sonnet 4.6, 2 actions): Innovation — 'Receive → Process → Return.'

🎯 Learning Objectives

  • Contrast prototype vs. production requirements
  • Define A2A and how it complements MCP
  • Trace a multi-agent audit through 6 sub-agents
  • Explain Google's Universal Commerce Protocol
  • Architect a complete multi-agent system

The Prototype-to-Production Gap

Building a demo = cooking for friends. Deploying production = opening a restaurant.

Dimension Prototype Production
Error Handling Crash + debug Graceful fallbacks, retry, alerting
Auth Hardcoded keys OAuth 2.0, rotation, least-privilege
Monitoring Manual logs Real-time dashboards, anomaly detection
Scaling Single user Queue management, rate limiting
Testing Manual Automated suites, CI/CD
Privacy Test data PII handling, encryption, GDPR/CCPA
Cost Unbounded Token budgets, model routing, alerts
Human Oversight None CONFIRM protocol for critical actions

Agent-to-Agent Protocol (A2A)

Google's open standard (April 2025) enabling agents to communicate regardless of framework or vendor. If MCP = USB-C for tools, A2A = telephone network for agents.

📖 CITATION
"A2A focuses on enabling agents to collaborate in their natural, unstructured modalities, even when they don't share memory, tools and context."
— Google Developers Blog, April 2025 · source ↗

MCP vs. A2A

MCP A2A
Purpose Connect AI → Tools Connect Agent → Agent
Analogy USB-C Telephone network
Relationship Client → Server Peer → Peer
Creator Anthropic (Nov 2024) Google (Apr 2025)
In ahmeego.com 28 tool actions Sub-agent collaboration

Architecture Walkthrough: "Audit my Google Ads account"

1
User → Orchestrator: CEP Protocol activates. 'Which account? Date range? Threshold?'
2
→ 🦁 Simba (Reporting): Pulls account-level data. 'Summarize, don't dump.' → '3 campaigns with 0 conversions, $2,400 spend.'
3
→ 🐠 Nemo (Research): Analyzes search terms + competitive landscape. → '62% irrelevant queries. "free" in 28%.'
4
→ ❄️ Elsa (Optimization): Evaluates bids, budgets, recommendations. → 'Reallocate $3,200/mo for +28% ROAS.'
5
→ 🌊 Moana (Creative): Reviews ad assets. → '8 ads Poor/Average strength. 4 campaigns missing RSAs.'
6
Orchestrator Synthesizes: Reads scratchpad, cross-validates totals, resolves contradictions, compiles unified report with prioritized recommendations.

Google's Agentic Commerce Vision

📖 CITATION
"Announced Universal Commerce Protocol (UCP) for agentic commerce — compatible with A2A, Agent Payments Protocol, MCP. Built with Shopify, Etsy, Wayfair, Target, Walmart."
— Sundar Pichai, NRF 2026 (Jan 12, 2026) · source ↗

🎮 Vibe Coding: Duck Hunt

Build a Duck Hunt-style shooting gallery as a single HTML file.\n- Click to shoot flying ducks\n- Randomized flight patterns, crosshair cursor\n- Gunshot sound + muzzle flash (Web Audio API)\n- Hit ducks tumble, dog retrieves\n- 10 ducks/round, 3 rounds, increasing difficulty\n- 3 shots per duck, score + accuracy %\n- Classic NES aesthetic

🎮 Capstone: AI Game Master RPG

Build an AI-powered text RPG Game Master as a single HTML file.\n- Character creation: name, class (Warrior/Mage/Rogue)\n- Stats: HP, Attack, Defense, Magic, Level, XP\n- Inventory with equippable items + consumables\n- Turn-based combat with enemy AI\n- Adaptive narrative (3+ branching points)\n- Shop between encounters\n- Boss encounter, HP bars, dark-fantasy styling, save/load
🤖 WHY THIS IS AGENTIC
Brain (game AI) + Tools (combat calc, inventory, story engine) + Memory (character state, story progress) + Orchestration (all systems simultaneously) = the same architecture as ahmeego.com, applied to games.

Multi-Platform Agent Architecture

Production advertising agents don't manage just one platform. The real power emerges when agents orchestrate across Google, Meta, Microsoft, and Amazon simultaneously.

Cross-Platform Budget Orchestration

The most valuable production use case is AI-driven budget allocation across platforms:

Signal Agent Action Platforms Affected
Google CPA up 30% week-over-week Shift 15% budget to Meta prospecting Google Ads, Meta
Meta frequency >4.0 on core audience Expand to Microsoft Audience Network Meta, Microsoft
Amazon ACoS below target by 40% Increase Amazon Sponsored Brand spend; reduce Google Shopping Amazon, Google
Black Friday approaching (7 days) Pre-load budgets across all platforms; shift to conversion campaigns All platforms

Automated Reporting Across Platforms

The highest-value, most immediately adoptable AI use case for agencies is automated cross-platform reporting:

Building AI Ad Tools as Products

The journey from script → tool → product is how ahmeego.com was built. Key production considerations:

Stage What You Build Example
Script One-off automation for yourself Google Ads Script that pauses low-QS keywords
Tool Reusable, parameterized, shareable 250-Point Audit Engine with UI
Product Multi-tenant, authenticated, monetizable ahmeego.com — full SaaS with 28 actions and 6 sub-agents

AI Tools You Can Use Today

TOOLS ON GOOGLEADSAGENT.AI
250-Point Audit Engine — Full Google Ads account audit. MCP-connectable. Auto-strategy generation.
Google Ads Builder — AI-powered RSA headline/description generation. Claude, GPT, or Gemini.
Keyword Analyzer — 3 analysis modes: seed expansion, competitor mining, SERP intelligence.
Social Media Ad Builder — Generate copy for Google, Meta, LinkedIn, TikTok, X, Pinterest, Reddit, Amazon.
Marketing Analytics Auditor — GA4 + GTM + pixel auditor with auto-remediation code.
Business Discovery Engine — Lead discovery from public data: 65 categories, 4 sources, 9 email methods.
PLATFORM EVOLUTION — Day 5 Concepts in Production
The live platform demonstrates every row in the prototype-to-production gap table: Error handling — the Brain has provider fallback chains (Anthropic → OpenAI → Gemini) and graceful degradation at every layer. Auth — Google OAuth with encrypted token storage in Cloudflare KV, HKDF-derived AES-GCM encryption. Cost — credit system with intent-based pricing, model multipliers, and loop-count scaling; errors don't deduct credits; cache-served data gets 0.5x cost. Monitoring — the companion chat now tracks conversations in KV sessions, enabling data-driven UX decisions. The widget on this page is a live example of the production system — multi-turn memory, suggestion chips, and page-context awareness, all running on the architecture you just studied.

✅ Key Takeaways

  • Production = error handling, auth, monitoring, scaling, testing, privacy, cost, human oversight.
  • MCP connects agents to tools. A2A connects agents to each other. Complementary.
  • Multi-agent systems: specialized sub-agents coordinated by orchestrator.
  • Google's UCP: agents as direct participants in commerce transactions.
  • Cross-platform budget orchestration is the highest-value multi-agent use case.
  • Automated reporting across Google + Meta + Microsoft is the most immediately adoptable AI for agencies.
  • The script → tool → product pipeline is how you go from automation to SaaS.

🧪 Day 5 Quiz — 4 Questions · 40 XP

Score: / 4

1. What is A2A (Agent-to-Agent Protocol)?

2. How does MCP differ from A2A?

3. What is Simba's governing principle?

4. What was announced at NRF 2026 for agentic commerce?

TRY IT NOW — Day 5 Production System
You've completed the course. The production system you just studied is live and free to use:

1. Use the full agent: Open the Marketing Auditor — connect your Google Ads account via OAuth and run a complete audit. This is the multi-agent orchestration from Day 5, executing live against your real data.

2. Explore all 15+ tools: Browse the tools directory — every tool uses the Brain + Tools + Loop architecture you've learned.

3. Start your free audit: Connect Google Ads — Free 250-Point Audit

4. Keep learning: 12-Week Advanced Learning Curriculum | ahmeego.com Home
✓ MARK DAY 5 COMPLETE

Appendix A: Complete Resource Library

Google/Kaggle White Papers

# Title Access
1 Introduction to Agents kaggle.com ↗
2 Agent Tools & MCP Google Agents Intensive
3 Context Engineering Kaggle ↗
4 Agent Quality Google Agents Intensive
5 Prototype to Production Google Agents Intensive

All 5 compiled: github.com/sameeerjadhav/google-agents-resources ↗

Free Courses

Provider Course Certificate
Anthropic Claude Code in Action Yes
Anthropic Claude 101 Yes
Anthropic AI Fluency: Framework & Foundations Yes
Anthropic Building with the Claude API Yes
Anthropic Intro to MCP + MCP Advanced Yes
Anthropic Intro to Agent Skills Yes
Microsoft AI Agents for Beginners (12 lessons) No
Hugging Face AI Agents Course Yes
DeepLearning.AI Agents in LangGraph Yes
Agent Academy Understanding Agentic AI Yes
NEW: ANTHROPIC ACADEMY
Anthropic now offers 13 free courses with certificates on their Skilljar platform. See the full breakdown in the Anthropic Academy section.

Protocols

Protocol Creator Date Docs
MCP Anthropic Nov 2024 modelcontextprotocol.io ↗
A2A Google Apr 2025 google.github.io/A2A ↗
UCP Google Jan 2026 Announced at NRF 2026

Frameworks

Framework Language URL
Google ADK Python GitHub ↗
LangGraph Python/JS langchain.com ↗
CrewAI Python crewai.com ↗
AutoGen Python GitHub ↗

Observability

Platform Type URL
LangSmith Monitoring langsmith.com ↗
Braintrust Evaluation braintrust.dev ↗
Arize Phoenix Tracing (OSS) GitHub ↗
RAGAS RAG Eval (OSS) ragas.io ↗

Appendix B: Glossary

22 key terms.

Term Definition
A2A Google's open standard for agent-to-agent communication regardless of framework.
Agent Software using an LLM to autonomously perceive, reason, decide, and act.
CEP Protocol Clarifying Exchange Protocol — ahmeego.com's pre-execution qualifying questions.
CONFIRM Protocol Write-safety requiring user approval before mutations, with current-vs-proposed preview.
Context Engineering Designing the complete information payload flowing into an agent's prompt.
Context Window Maximum text (tokens) an LLM processes in one interaction.
Foundation Model The LLM serving as an agent's reasoning engine (Claude, GPT-4, Gemini).
Guardrails Safety mechanisms (input, output, action) constraining agent behavior.
Hallucination When AI confidently produces incorrect or fabricated information.
LLM-as-a-Judge Using a separate LLM to evaluate agent outputs against rubrics.
MCP Anthropic's standard for universally connecting AI to tools and data.
Multi-Agent System Multiple specialized agents collaborating on complex tasks.
Orchestrator Coordinating agent that delegates to sub-agents and synthesizes outputs.
RAG Retrieval-Augmented Generation — searching vector DBs for relevant context.
ReAct Loop Reason → Act → Observe → Repeat. Core agent orchestration pattern.
Scratchpad Structured working document of categorized findings during multi-step tasks.
Sub-Agent Specialized agent for one domain (e.g., 🦁 Simba for Reporting).
The Loop ahmeego.com's architecture: ask → clarify → execute → validate → loop.
Tool Executable function extending agent capabilities beyond text generation.
Top-Down Reporting Validation: account summary first, details must sum to totals.
UCP Universal Commerce Protocol — Google's standard for agentic commerce.
Vibe Coding Building software through natural-language description (Karpathy, 2025).

Appendix C: ahmeego.com Technical Reference

Component Specification
Foundation Model Claude Sonnet 4.6 (baseline) + user-selectable: GPT-5.4-pro, Gemini 3 Flash
Tools 28 Python API actions with live Google Ads read/write
Sub-Agents 6 Disney-named specialists
Credential Patterns A (5-key, 12 actions) · B (4-key, 13) · C (Cloudinary, 1) · D (none, 2)
Safety CONFIRM protocol with current-vs-proposed + rollback labeling
Context CEP Protocol + Session State Manager (Action #17)
Validation Top-Down Reporting: details cross-validated against totals
Deployment CLI · REST API · Docker · Python SDK
Repository 66 files, 12 directories
License Open source
URL ahmeego.com

Sub-Agent Specifications

Name Model Actions Domain Principle
🦁 Simba Sonnet 4.6 8 Reporting 'Summarize, don't dump.'
🐠 Nemo Sonnet 4.6 4 Research 'Insight over information.'
❄️ Elsa Sonnet 4.6 8 Optimization 'Preview before execute.'
🧞 Aladdin Sonnet 4.6 7 Shopping/PMax 'ROAS is king.'
🌊 Moana Sonnet 4.6 2 Creative 'Visual first.'
🤖 Baymax Sonnet 4.6 2 Innovation 'Receive → Process → Return.'

All 28 Actions

# Action Category Cred
01 Label Manager Organization A
02 Conversion Tracking Analysis A
03 Audience Manager Targeting B
04 Asset Manager Organization B
05 Budget Manager Campaign B
06 RSA Ad Manager Campaign B
07 Bid & Keyword Manager Campaign B
08 Negative Keywords Organization B
09 Campaign & Ad Group Mgr Campaign B
10 Google Ads Mutate Campaign B
11 Account Access Checker Infrastructure B
12 Scripts Manager Infrastructure A
13 Experiments Manager Optimization A
14 Package Installer Infrastructure D
15 Check User Access Infrastructure B
16 API Gateway Infrastructure B
17 Session & State Manager Infrastructure D
18 Cloudinary Creative Creative C
19 Query Planner Analysis A
20 Recommendations Manager Optimization A
21 Search Term Manager Analysis B
22 Geo & Location Manager Targeting B
23 Device Performance Analysis A
24 Change History Manager Analysis A
25 Campaign Creator Campaign A
26 Ad Schedule Manager Optimization A
27 Bidding Strategy Manager Optimization A
28 PMax Asset Group Mgr PMax A

References (APA 7th Edition)

Alphabet Inc. (2025, July 23). Q2 2025 earnings call transcript. https://abc.xyz/investor/

Anthropic. (2024, November). Introducing the Model Context Protocol. https://anthropic.com/news/model-context-protocol

Google. (2025). Introduction to agents [White paper]. Kaggle. https://kaggle.com/whitepaper-agents

Google. (2025). Agent tools and interoperability with MCP [White paper]. Kaggle Agents Intensive.

Google. (2025). Context engineering: Sessions and memory [White paper]. Kaggle.

Google. (2025). Agent quality [White paper]. Kaggle Agents Intensive.

Google. (2025). Prototype to production [White paper]. Kaggle Agents Intensive.

Google. (2025, April 9). Announcing the Agent2Agent Protocol. Google Developers Blog. developers.googleblog.com

Google. (2025, April 9). Cloud Next 2025 announcements. Google Blog. blog.google

Google DeepMind. (2025, March 6). Gemini 2.0: Built for the agentic era. Google Blog.

Karpathy, A. (2025, February). Vibe coding [Post]. X. https://x.com/karpathy

Microsoft. (2025). AI agents for beginners [Course]. GitHub. github.com

Pichai, S. (2025, May 20). Google I/O 2025 keynote. Google Blog. blog.google

Pichai, S. (2026, January 12). NRF 2026 remarks. Google Blog. blog.google

Yao, S., et al. (2022). ReAct: Synergizing reasoning and acting in language models. arXiv. arxiv.org/abs/2210.03629

About the Author

AUTHOR E-E-A-T CREDENTIALS
Experience: 15+ years managing $350M+ in digital advertising spend across Google Ads, Meta, Microsoft, Amazon
Expertise: Senior Paid Media Specialist at Seer Interactive · 28 custom API actions · 6 sub-agent architecture
Authority: Hero Conf 2025 + 2026 speaker · 19+ open-source tools on GitHub · NortonLifeLock 192% YoY growth
Trust: Open-source under MIT license · APA 7th citations · Verifiable data and references throughout

John Williams is a Senior Paid Media Specialist at Seer Interactive with 15+ years managing $350M+ in digital advertising spend across Google Ads, Meta, Microsoft, Amazon, and other platforms. Previous: NortonLifeLock (192% YoY paid search growth), Gen Digital, Avast, Farmers Insurance.

Creator of ahmeego.com — open-source AI agent with 28 API actions and 6 sub-agents. Operates "It All Started With A Idea," his consultancy and product studio. Speaker at Hero Conf 2025 + 2026. 19+ open-source marketing automation tools on GitHub.

Assistant football coach at Casteel High School (WR, DB, special teams). Former Washington State University football player (2002–2005).


This course is free and open source. Share it. Teach it. Fork it.
The future of AI agents belongs to everyone.

LAST UPDATED:

↗ GITHUB ↗ LINKEDIN ↗ AGENT ↗ PROFILE ↗ AI PLAYBOOK ↗ FREE TOOLS

Anthropic Academy — Free Courses & Certificates

Anthropic's official learning platform offers 13 free courses with certificates. These complement the crash course — take them alongside or after to deepen specific skills.

ALL COURSES ARE FREE
Every course below is free on Anthropic Academy (Skilljar). No Anthropic account required — just create a free Skilljar login. Certificates of completion are issued for all courses.

Featured Courses

AI Fluency

Anthropic's framework for effective human-AI collaboration. The Four Ds: Delegation (when to use AI), Description (how to communicate), Discernment (evaluating outputs), Diligence (responsible use).

Developer & Technical

Cloud Deployment

New Products to Know

Product What It Is Launched
Claude Code AI coding assistant with agentic architecture for multi-step programming tasks. IDE integration, GitHub, MCP. 2025
Claude Cowork Agentic AI workspace for file-based tasks — organizing, spreadsheets, reports, documents. Sub-agent coordination. Jan 2026
Skills Reusable SKILL.md workflows. Extend Claude Code and Cowork. Claude applies them automatically. 2026
MCP Open protocol connecting LLMs to external data, tools, and systems. Now supported by Google, Microsoft, OpenAI. Nov 2024

🧪 Anthropic Academy Quiz — 3 Questions · 30 XP

Score: / 3

1. What are the Four Ds of AI Fluency?

2. What are the three MCP primitives?

3. What is Claude Cowork?

Course Roadmap & Expansion Plan

The 5-day core course covers AI agent fundamentals through production multi-agent systems. This roadmap identifies 8 categories and 30+ modules that will expand the curriculum into a comprehensive AI-for-advertising education platform.

GUIDING PRINCIPLE
Every module ties back to ahmeego.com as the reference implementation. Theory is taught through practice. Concepts map to live tools and real campaign data.
PHASE 1 — ADDITIONS TO CORE COURSE (IN PROGRESS)

Quick wins that strengthen the existing 5-day structure without breaking its flow.

Module 1.1

Prompt Engineering Deep Dive

System prompts, few-shot, chain-of-thought, tree-of-thought. Role prompting and persona design. Prompt testing and evaluation frameworks.

COMING SOON
Module 1.2

RAG (Retrieval-Augmented Generation)

Vector databases, embedding models, chunking strategies, hybrid search. The #1 production pattern for grounding agents in real data.

COMING SOON
Module 1.3

Fine-Tuning & Model Customization

When to fine-tune vs. prompt vs. RAG. LoRA/QLoRA for open-source models. Distillation for brand voice and compliance.

PLANNED
Module 1.4

AI Safety, Ethics & Guardrails

Prompt injection defense, output filtering, Constitutional AI, Guardrails frameworks. Responsible AI in advertising.

COMING SOON
Module 1.5

Evaluation & Benchmarking

LLM-as-judge, human eval frameworks, A/B testing AI outputs. Cost/latency/quality tradeoff analysis for ad use cases.

PLANNED
Module 1.6

Reasoning Models & Chain-of-Thought

o1/o3, Claude thinking mode, Gemini thinking. When to use reasoning models for complex advertising analysis.

PLANNED
Module 1.7

Computer Use / Browser Agents

Claude Computer Use, OpenAI Operator. Browser automation for ad platform management with Stagehand and Playwright.

PLANNED
Module 1.8

Voice & Multimodal AI

Voice agents, vision models for creative analysis, video understanding for video ad review, audio transcription.

PLANNED

Coming Next

Phase Modules Status
Phase 2 — Platform Tracks 15 modules: Google Ads (6), Meta (4), Microsoft (3), Amazon (2) Planned
Phase 3 — Advanced 17 modules: Cross-Platform AI (7), Frameworks (6), Emerging (4) Planned

Phase 2 covers deep-dive platform tracks (Google Ads API, Meta Marketing API, Microsoft Ads, Amazon Ads). Phase 3 covers cross-platform budget orchestration, MCP server development, LangChain/CrewAI, and deploying AI tools as products. 2 modules are already LIVE ON SITE as tools: Creative Asset Validation and Conversion Tracking.

WANT A MODULE PRIORITIZED?
This roadmap is shaped by practitioner feedback. Connect on LinkedIn or open an issue on GitHub to vote for the modules you need most.
🔰 Novice
0 XP
🔥 0 streak
📝 0/6 quizzes
🎯💯🏆🔥🎓