Skip to content

Commit 27edb1a

Browse files
haranrkcopybara-github
authored andcommitted
docs: simplify sample graph guidance in adk-sample-creator skill
Guide sample READMEs to draw a simple agent -> tools/sub-agents topology (covering `LlmAgent` and `ManagedAgent`) instead of a request/response data-flow sequence, which is noisy and adds little value over the topology. This is the systematic fix behind the graph feedback on the remote MCP sample. Co-authored-by: Haran Rajkumar <haranrk@google.com> PiperOrigin-RevId: 947245446
1 parent 0a62d39 commit 27edb1a

1 file changed

Lines changed: 2 additions & 2 deletions

File tree

  • .agents/skills/adk-sample-creator

.agents/skills/adk-sample-creator/SKILL.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -89,7 +89,7 @@ Each sample should have a `README.md` with the following structure:
8989

9090
- **Overview**: What the sample does.
9191
- **Sample Inputs**: Examples of inputs to test with. Each prompt must be wrapped in backticks. If a prompt has an explanation, always add a blank line between the prompt and the explanation, and indent the explanation by two spaces.
92-
- **Graph**: Visualization of the graph flow (Mermaid recommended). For Workflow root agents, visualize the graph flow of nodes. For LlmAgent root agents that orchestrate tools or sub-agents, visualize the topology of the agent and its tools/sub-agents instead of internal workflow nodes.
92+
- **Graph**: Visualization of the graph flow (Mermaid recommended). For Workflow root agents, visualize the graph flow of nodes. For agents that orchestrate tools or sub-agents (e.g., `LlmAgent`, `ManagedAgent`), visualize the topology of the agent and its tools/sub-agents instead of internal workflow nodes. Keep it a simple topology diagram (a few nodes and edges). Do **not** draw a request/response data-flow sequence (e.g., `user -> agent -> API -> tool -> ... -> user`); those are noisy and add little value over the topology.
9393
- **How To**: Explanation of key techniques used (e.g., `ctx.run_node`).
9494
- **Related Guides**: Links to relevant developer guides in `docs/guides/` that explain the concepts or classes used.
9595

@@ -118,7 +118,7 @@ graph TD
118118
START --> MyNode
119119
```
120120

121-
For LlmAgent root agents:
121+
For agents that orchestrate tools or sub-agents (`LlmAgent`, `ManagedAgent`, ...):
122122
```mermaid
123123
graph TD
124124
MyAgent[my_agent] -->|calls| MyTool(my_tool)

0 commit comments

Comments
 (0)