Skip to content

Update agent-development.md with uv run adk tip and warning#1152

Open
zeroasterisk wants to merge 2 commits intomainfrom
docs/agent-dev-cleanup
Open

Update agent-development.md with uv run adk tip and warning#1152
zeroasterisk wants to merge 2 commits intomainfrom
docs/agent-dev-cleanup

Conversation

@zeroasterisk
Copy link
Copy Markdown
Collaborator

This PR updates the agent development guide to mention uv run adk as an alternative for restricted environments, and adds a warning that instructions to copy a2ui_schema.py are outdated.

Copy link
Copy Markdown
Contributor

@gemini-code-assist gemini-code-assist bot left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Code Review

This pull request updates the agent development guide to include a tip for using uv and adds a warning regarding outdated A2UI schema instructions. A review comment suggests improving the warning's clarity by specifying that the entire section is legacy and highlighting the generate_system_prompt() method.

Comment on lines +106 to +110
> **WARNING: Outdated Instructions**
> The instructions below regarding copying `a2ui_schema.py` are outdated. The A2UI schema is now managed by the `a2ui` package provided by the SDK. Please refer to the working samples in `samples/agent/adk/restaurant_finder/agent.py` to see how to use `A2uiSchemaManager` to get the schema and inject it into the prompt.

For historical reference or if you are using an older version, the previous instructions were:
Copy the `a2ui_schema.py` from the contact lookup example.
Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

medium

The warning is helpful, but the current phrasing might lead users to believe only the file copying step is outdated. Since the entire following section (including imports and prompt construction) uses the legacy approach, it's better to clarify that the whole section is for historical reference. Also, mentioning generate_system_prompt() provides a more direct path to the modern implementation.

Suggested change
> **WARNING: Outdated Instructions**
> The instructions below regarding copying `a2ui_schema.py` are outdated. The A2UI schema is now managed by the `a2ui` package provided by the SDK. Please refer to the working samples in `samples/agent/adk/restaurant_finder/agent.py` to see how to use `A2uiSchemaManager` to get the schema and inject it into the prompt.
For historical reference or if you are using an older version, the previous instructions were:
Copy the `a2ui_schema.py` from the contact lookup example.
> **WARNING: Outdated Instructions**
> The instructions and code examples in the rest of this section regarding `a2ui_schema.py` are outdated. The A2UI schema and prompt injection are now managed by the `A2uiSchemaManager` class in the `a2ui` package. Please refer to the implementation in `samples/agent/adk/restaurant_finder/agent.py` to see how to use `generate_system_prompt()` to automatically include the schema and examples.
For historical reference, the previous instructions were:
Copy the `a2ui_schema.py` from the contact lookup example.

@zeroasterisk zeroasterisk force-pushed the docs/agent-dev-cleanup branch from 363e06a to b38668a Compare April 12, 2026 00:19
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

Status: Todo

Development

Successfully merging this pull request may close these issues.

3 participants