|
| 1 | +"""Google ADK multi-agent-remote example: same pipeline as multi-agent but with sub-agents hosted remotely via A2A. |
| 2 | +
|
| 3 | +Demonstrates how to mix local orchestration with remote agent implementations: |
| 4 | +- Coordinator and formatter run locally (they hold the orchestration logic) |
| 5 | +- Specialist sub-agents (research, code) are RemoteA2aAgent instances hosted elsewhere |
| 6 | +- The remote services don't need to know about each other — coordination stays local |
| 7 | +
|
| 8 | +Compare with the multi-agent sample: |
| 9 | + multi-agent: Agent(tools=[search_web]) Agent(tools=[run_python]) |
| 10 | + multi-agent-remote: RemoteA2aAgent(agent_card=...) for each specialist |
| 11 | +
|
| 12 | +The key insight: RemoteA2aAgent cannot have sub_agents (it's not an LlmAgent), |
| 13 | +but a local Agent CAN have RemoteA2aAgent instances as its sub_agents. This lets |
| 14 | +you keep orchestration logic local while moving implementations to remote services. |
| 15 | +
|
| 16 | +Graph structure: |
| 17 | + __start__ → pipeline → coordinator → research_agent (RemoteA2aAgent) |
| 18 | + → code_agent (RemoteA2aAgent) |
| 19 | + → formatter (output_schema=ReportOutput) |
| 20 | + → __end__ |
| 21 | +
|
| 22 | +Schema resolution (handled by the runtime recursively): |
| 23 | + - input_schema: from FIRST sub_agent chain → coordinator.input_schema (ReportInput) |
| 24 | + - output_schema: from LAST sub_agent chain → formatter.output_schema (ReportOutput) |
| 25 | + - output_key: from LAST sub_agent chain → formatter.output_key ("report") |
| 26 | +""" |
| 27 | + |
| 28 | +import os |
| 29 | + |
| 30 | +import httpx |
| 31 | +from a2a.client.client import ClientConfig as A2AClientConfig |
| 32 | +from a2a.client.client_factory import ClientFactory as A2AClientFactory |
| 33 | +from a2a.types import TransportProtocol as A2ATransport |
| 34 | +from google.adk.agents import Agent, SequentialAgent |
| 35 | +from google.adk.agents.remote_a2a_agent import RemoteA2aAgent |
| 36 | +from pydantic import BaseModel, Field |
| 37 | + |
| 38 | + |
| 39 | +class ReportInput(BaseModel): |
| 40 | + """Structured input for the report generation pipeline.""" |
| 41 | + |
| 42 | + topic: str = Field( |
| 43 | + default="Natural Language Processing fundamentals", |
| 44 | + description="The topic to research and analyze", |
| 45 | + ) |
| 46 | + depth: str = Field( |
| 47 | + default="standard", |
| 48 | + description="How deep the analysis should be: 'brief', 'standard', or 'detailed'", |
| 49 | + ) |
| 50 | + |
| 51 | + |
| 52 | +class ReportOutput(BaseModel): |
| 53 | + """Structured output from the report generation pipeline.""" |
| 54 | + |
| 55 | + title: str = Field(description="Report title") |
| 56 | + summary: str = Field(description="Executive summary of findings") |
| 57 | + key_findings: list[str] = Field(description="Key findings as bullet points") |
| 58 | + code_snippet: str = Field(description="A relevant Python code example") |
| 59 | + |
| 60 | + |
| 61 | +# UIPATH_ACCESS_TOKEN is set automatically by `uipath auth` |
| 62 | +_access_token = os.environ.get("UIPATH_ACCESS_TOKEN", "") |
| 63 | + |
| 64 | +_http_client = httpx.AsyncClient( |
| 65 | + headers={"Authorization": f"Bearer {_access_token}"}, |
| 66 | + timeout=httpx.Timeout(300.0), |
| 67 | +) |
| 68 | + |
| 69 | +_a2a_client_factory = A2AClientFactory( |
| 70 | + config=A2AClientConfig( |
| 71 | + httpx_client=_http_client, |
| 72 | + supported_transports=[A2ATransport.jsonrpc], |
| 73 | + streaming=False, |
| 74 | + polling=False, |
| 75 | + accepted_output_modes=["text"], |
| 76 | + ), |
| 77 | +) |
| 78 | + |
| 79 | +# --- Remote Sub-agents --- |
| 80 | +# Replace the URLs with your actual deployed agent endpoints. |
| 81 | +ORG_NAME = "YourOrgName" |
| 82 | +TENANT_NAME = "YourTenantName" |
| 83 | +RESEARCH_AGENT_FOLDER_KEY = "a11f72b1-90fd-4b30-b733-f0285cbf4a19" |
| 84 | +RESEARCH_AGENT_RELEASE_ID = "1234" |
| 85 | +CODE_AGENT_FOLDER_KEY = "b22f83c2-91fe-5c41-c844-g1396dcg5b2a" |
| 86 | +CODE_AGENT_RELEASE_ID = "5678" |
| 87 | + |
| 88 | +research_agent = RemoteA2aAgent( |
| 89 | + name="research_agent", |
| 90 | + agent_card=f"https://cloud.uipath.com/{ORG_NAME}/{TENANT_NAME}/agenthub_/a2a/{RESEARCH_AGENT_FOLDER_KEY}/{RESEARCH_AGENT_RELEASE_ID}/.well-known/agent-card.json", |
| 91 | + description="Remote research specialist that searches the web and summarizes findings", |
| 92 | + a2a_client_factory=_a2a_client_factory, |
| 93 | +) |
| 94 | + |
| 95 | +code_agent = RemoteA2aAgent( |
| 96 | + name="code_agent", |
| 97 | + agent_card=f"https://cloud.uipath.com/{ORG_NAME}/{TENANT_NAME}/agenthub_/a2a/{CODE_AGENT_FOLDER_KEY}/{CODE_AGENT_RELEASE_ID}/.well-known/agent-card.json", |
| 98 | + description="Remote Python developer that writes and executes code examples", |
| 99 | + a2a_client_factory=_a2a_client_factory, |
| 100 | +) |
| 101 | + |
| 102 | + |
| 103 | +# --- Coordinator (local Agent, sub_agents are remote) --- |
| 104 | +coordinator = Agent( |
| 105 | + name="coordinator", |
| 106 | + model="gemini-2.5-flash", |
| 107 | + instruction=( |
| 108 | + "You are a report coordinator. Given a topic:\n" |
| 109 | + "1. Delegate research to research_agent to gather information\n" |
| 110 | + "2. Delegate to code_agent to write a relevant Python code example\n" |
| 111 | + "3. Compile all findings into a comprehensive text report\n" |
| 112 | + "Include the research findings and the code example in your response." |
| 113 | + ), |
| 114 | + sub_agents=[research_agent, code_agent], |
| 115 | + input_schema=ReportInput, |
| 116 | + output_key="research_results", |
| 117 | +) |
| 118 | + |
| 119 | + |
| 120 | +# --- Formatter (local Agent with output_schema) --- |
| 121 | +formatter = Agent( |
| 122 | + name="formatter", |
| 123 | + model="gemini-2.5-flash", |
| 124 | + instruction=( |
| 125 | + "You are a report formatter. Take the research results from the previous " |
| 126 | + "step and format them into a structured report with a title, summary, " |
| 127 | + "key findings, and a code snippet. Output valid JSON matching the schema." |
| 128 | + ), |
| 129 | + output_schema=ReportOutput, |
| 130 | + output_key="report", |
| 131 | +) |
| 132 | + |
| 133 | + |
| 134 | +# --- Root: SequentialAgent pipeline --- |
| 135 | +agent = SequentialAgent( |
| 136 | + name="pipeline", |
| 137 | + sub_agents=[coordinator, formatter], |
| 138 | +) |
0 commit comments