google / google/adk-python

Documentation Bug: root_agent logic placed in description instead of instruction in ADK Blog Post

Offen
#5,700 4 Kommentare 0 Reaktionen 1 zugewiesene Person Zugewiesen an @polong-lin Auf GitHub ansehen
documentation needs review
Vorherrschende Sprache
Python
Sterne
21.5k
Forks
4k
Ø Merge
1 T. 14 Std.
Gemergte PRs (30 T.)
37

Beschreibung

**Location**: [Google Developers Blog - ADK Post](https://developers.googleblog.com/en/agent-development-kit-easy-to-build-multi-agent-applications/)

**Description**:
In the "Building a multi-agent application" section of the blog post, the sample code for the root_agent contains a configuration error. The behavioral instructions, delegation rules, and tool usage guidelines are currently assigned to the description parameter.

In the ADK framework, the description is metadata used by the orchestrator for delegation routing, whereas the instruction acts as the System Prompt. By placing the logic in description, the agent is not provided with its operational guidelines during its execution cycle.

**Current Code Snippet (from blog):**

**Python**
root_agent = Agent(
name="weather_agent_v2",
model="gemini-2.0-flash-exp",
description="You are the main Weather Agent, coordinating a team. - Your main task: Provide weather using the `get_weather` tool. Handle its 'status' response ('report' or 'error_message'). - Delegation Rules: - If the user gives a simple greeting (like 'Hi', 'Hello'), delegate to `greeting_agent`. - If the user gives a simple farewell (like 'Bye', 'See you'), delegate to `farewell_agent`. - Handle weather requests yourself using `get_weather`. - For other queries, state clearly if you cannot handle them.",
tools=[get_weather],
sub_agents=[greeting_agent, farewell_agent]
)

**Recommended Fix:**
The behavioral text should be moved to the instruction parameter, leaving a concise summary for the description.

Python
root_agent = Agent(
name="weather_agent_v2",
model="gemini-2.0-flash-exp",
description="Main coordinator agent for weather services, greetings, and farewells.",
instruction=(
"You are the main Weather Agent. Coordinate your team as follows: "
"1. For 'Hi/Hello', delegate to greeting_agent. "
"2. For 'Bye/See you', delegate to farewell_agent. "
"3. For weather requests, use the get_weather tool. "
"4. If you cannot handle a query, state it clearly."
),
tools=[get_weather],
sub_agents=[greeting_agent, farewell_agent]
)

Beitragsleitfaden

Beitragsleitfaden öffnen

Bewertung

Dieses Issue wurde noch nicht bewertet.

Neue Issues direkt in Ihr Postfach

Eine kurze Übersicht über anfängerfreundliche GitHub-Issues.