feat: Add local agent orchestrator example and comprehensive docs#24
Merged
pcarranzav merged 8 commits intomainfrom Dec 10, 2025
Merged
feat: Add local agent orchestrator example and comprehensive docs#24pcarranzav merged 8 commits intomainfrom
pcarranzav merged 8 commits intomainfrom
Conversation
pcarranzav
force-pushed
the
feat/local-agent-example
branch
from
d8547ae to
d267636
Compare
pcarranzav
force-pushed
the
feat/example-migration
branch
from
f731092 to
c29fda3
Compare
pcarranzav
force-pushed
the
feat/local-agent-example
branch
3 times, most recently
from
11d4366 to
e206a62
Compare
tmigone
approved these changes
Dec 8, 2025
pcarranzav
force-pushed
the
feat/local-agent-example
branch
2 times, most recently
from
4c9aef7 to
a0c21b7
Compare
pcarranzav
force-pushed
the
feat/example-migration
branch
from
b2b790f to
611ddd8
Compare
pcarranzav
force-pushed
the
feat/local-agent-example
branch
6 times, most recently
from
e29de79 to
0a461ac
Compare
…e docs Add local agent example demonstrating multi-agent orchestration using X402RemoteAgentToolset with comprehensive documentation. Local Agent Orchestrator Example: - Uses X402RemoteAgentToolset to provide remote agents as tools - Demonstrates agent discovery and delegation - Per-agent conversation context management - Smart Account + EOA support with auto-detection - Defaults to staging subgraph service Comprehensive Documentation: - examples/README.md - Complete getting started guide - Quick start with staging (testnet, free) - All 4 examples documented with architecture diagrams - Troubleshooting section - Ampersend-first approach - examples/docs/environment-variables.md - Complete reference - Smart Account vs Standalone mode tables - Staging vs Production URLs - Setup instructions for both modes - Security notes and best practices Documentation highlights Ampersend benefits: - Spend limits and monitoring - Production-ready security - Free testnet for getting started - Clear upgrade path to production All examples follow consistent pattern: - Getting Started (testnet) shown first - Standalone Alternative for testing - Production upgrade clearly documented 🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-Authored-By: Claude <noreply@anthropic.com>
SmartAccountConfig has OWNABLE_VALIDATOR as default.
Document that users can use 'adk web' to start a web UI interface as an alternative to the interactive CLI 'adk run' command.
- Clarify that examples connect to The Graph subgraph services - Explain services provide blockchain data (ENS, Uniswap, etc) - Add example query: 'What were the last 2 ENS registrations?' - Help users understand what to ask the agents
The local orchestrator uses Gemini model which requires GOOGLE_API_KEY. Document this in both the agent.py docstring and examples/README.md.
adk web requires the parent directory containing agent folders, not the agent folder itself (e.g., src/examples/a2a/buyer not .../adk).
pcarranzav
force-pushed
the
feat/local-agent-example
branch
from
0a461ac to
5dafb72
Compare
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
2 participants
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Summary
Adds local agent orchestrator example demonstrating X402RemoteAgentToolset with comprehensive documentation for all examples.
Builds on: #23 (Example Migration)
Chain: This PR targets
feat/example-migrationbranch (will rebase tomainafter #22 and #23 merge)What's Included
New: Local Agent Orchestrator Example
Location:
examples/src/examples/a2a/buyer/local_agent/agent.pyDemonstrates building a local ADK agent that orchestrates multiple remote A2A agents as tools.
Features:
X402RemoteAgentToolsetfrom feat: Add X402RemoteAgentToolset for local agent orchestration #22How it works:
x402_a2a_list_agentsx402_a2a_send_to_agentComprehensive Documentation
Examples README
Location:
examples/README.mdComplete getting started guide with:
Environment Variables Reference
Location:
examples/docs/environment-variables.mdComplete reference documentation:
Documentation Highlights
Ampersend-first approach - All docs promote:
Benefits emphasized:
Testing
PR Chain
All PRs in this chain are ready for review:
🤖 Generated with Claude Code