* docs(tutorials): fix ToolContext, output_key and persistence claims
* Update agent-team.md
* docs: address review — revert get-started changes, move streaming note
Reverts docs/get-started/python.md entirely and drops the edit to the
retired quickstart-streaming.md page. The corrected streaming caveat now
lands on docs/live/get-started/streaming-python.md, scoped to the
run_async path and naming SequentialAgent as the only workflow agent
with live support.
---------
Co-authored-by: Joe Fernandez <931947+joefernandez@users.noreply.github.com>
The site rendered one language under two names. Tab labels were split
137 `TypeScript` / 53 `Typescript`, with three pages carrying both
spellings at once (custom-agents.md 7/7, patterns.md 1/7,
function-tools.md 4/1), and the language-support badges were split 67/18
the same way. Because pymdownx.tabbed slugifies tab labels to lowercase,
both variants rendered and linked fine, so no link check or build warning
ever flagged it -- it was visible only to readers, as two names for one
SDK.
Every user-visible occurrence is normalized to `TypeScript`, plus the two
inconsistencies that turned up while doing it. 80 changed lines, accounted
for exactly:
53 tab label === "Typescript" -> === "TypeScript"
18 badge span lst-typescript">Typescript -> TypeScript
3 prose mention cloud-run.md, mcp-tools.md, workflows/patterns.md
2 api-reference/index.md card heading and link text
1 badge div attr title="...Python and Typescript."
1 mkdocs.yml nav Typescript ADK -> TypeScript ADK
1 code fence ```javascript -> ```typescript on a .ts include
1 artifacts/index.md closing summary sentence
---
80
The first six rows are pure casing: 78 lines that differ from their
originals by nothing but `Typescript` -> `TypeScript`. The last two are
not, and are the reason this is not a `sed`:
llm-agents.md:872 fenced `--8<-- ".../capital_agent.ts"` as ```javascript.
It was the only javascript-fenced `.ts` include in docs/ (the other 189
TypeScript fences are correct), and it cost that one snippet its
TypeScript highlighting.
artifacts/index.md:1084 closed the page by naming languages and got the
list wrong. It described reaching the artifact methods "using Python's
context objects or directly interacting with the `BaseArtifactService` in
Java" -- a two-language enumeration at the end of a page that carries
Python, TypeScript, Go, Java and Kotlin tabs (11/10/10/10/11), and one
that contradicts :556, which correctly names four of them. The
enumeration is dropped rather than extended: the sentence now describes
the two ways to reach these methods -- through the context object, or
through `BaseArtifactService` -- which is what the page actually teaches
and does not rot when a sixth language is added.
docs/api-reference/index.md is included even though the rest of
docs/api-reference/ is generated output that must not be touched. That
tree holds 3,140 generated HTML files and exactly one hand-authored page:
this one. It is Markdown, it is the only api-reference entry mkdocs.yml
lists as `.md` rather than `index.html` (:272, :441), it uses Material
`grid cards` and `:fontawesome-*:` shortcodes, and it carries a
`CONTRIBUTORS:` note citing issues #1716 and #1717. Its TypeScript card
already said "TypeScript" twice in its body text while its heading and
link text said "Typescript"; those two are now consistent with the body.
No generated file is modified.
Not in this change: the broken `SseConnectionParams` sample in
mcp-tools.md (docs-ts/p6c-mcp-ts-sample) and the `@google/adk` example
version bumps (docs-ts/p6b-example-versions). Only the casing of the
prose line above that sample is touched here.
Verified: `mkdocs build` exits 0 with an empty warning set on both main
and this branch, and the two warning sets are identical. A rendered
before/after diff of the whole site shows every `__tabbed_*` id, every
tab radio id and every heading anchor unchanged. Zero `=== "Typescript"`
and zero `lst-typescript">Typescript` remain anywhere in the repo.
Co-authored-by: Amaad Martin <amaadmartin@google.com>
* docs: update ADK Go imports to v2 for core concepts and tutorials
* docs: update ADK Go imports and APIs to v2 for runtime and safety
* docs: update ADK Go imports to v2 for features (workflows, tools, skills, sessions, plugins)
* docs: update ADK Go imports to v2 for operations and integrations
---------
Co-authored-by: Kristopher Overholt <koverholt@google.com>
* docs: update GOOGLE_GENAI_USE_VERTEXAI to GOOGLE_GENAI_USE_ENTERPRISE in configs and models
* docs: update GOOGLE_GENAI_USE_VERTEXAI in deployment and setup guides
* docs: update GOOGLE_GENAI_USE_VERTEXAI and Client parameter in integrations and streaming docs
* docs: update GOOGLE_GENAI_USE_VERTEXAI in tutorials and examples
---------
Co-authored-by: Joe Fernandez <931947+joefernandez@users.noreply.github.com>
* wip: temporary staging
* Consolidate Google Cloud and Agent Platform connection info
* remove gcp-mentions file
* adding links to central GCP connection page
* minor updates
* responded to review comments
* Update version for ADK Kotlin to 0.2.0
* Update version for ADK Kotlin examples to 0.2.0
* Update install steps on multi-tool-agent page
* Update ADK Kotlin API reference docs to 0.2.0
* Remove runner parameter from AdkWebServer constructor
* Add Kotlin to hero / front page
* Add quickstart page for Kotlin
* Complete Kotlin quickstart guide and fix hero code sample (#2)
* Replace GitHub repo links with language icons in header (#3)
* Fix header icon FOUC and homepage font weight regression (#4)
* Testing staging pipeline
* Revert test edit (for staging pipeline)
* Update language icon tooltips to indicate GitHub destination (#5)
* Add link to ADK Kotlin release notes (#7)
* Initial commit of ADK Kotlin API reference docs (#6)
* Add script to generate ADK Kotlin API reference docs (#8)
* Update links and link checker ignore list (temporarily) (#9)
* Add ADK Kotlin for Android getting started guide to Advanced setup page (#10)
* Add advanced setup page with steps to "Use ADK Kotlin in Android projects"
* Update temp link checker rules
* Add placeholder folder for adk-samples (#13)
* adding linter/compilation checks for kotlin snippets (#12)
* adding linter/compilation checks for kotlin snippets
* Add Kotlin validation scripts
* Initial commit of Kotlin sample agents for adk-samples (#15)
* Adding kotlin snippet for llm agents (#16)
* Adding kotlin snippets to Events (#17)
* Pull changes to docs/events/index.md from glaforge-kotlin-snippets
* fixing kotlin event timestamp and longRunningToolIds
* Fix language tags (#19)
* Fix language tags
* Update
* Fix wrapping
* Fix wrapping (again)
* Fix wrapping/format
* Fix language tag on integration page
* Enable check_paths in PyMdown Snippets Extension to make the build fail if a snippet can't be found (#20)
* Update mkdocs config (#21)
* Fix broken links, update URLs to adk.dev, and improve (temp) lychee config (#22)
* Add Kotlin/maven badge to README (#23)
* Adding Kotlin snippets for artifacts (#18)
* Pull Kotlin snippets for artifacts from glaforge-kotlin-snippets
* Add comprehensive Kotlin snippets for artifacts
* Refactor artifacts documentation to use external Kotlin snippets
* Update Kotlin model to gemini-flash-latest
* Fix GCS initialization in Kotlin artifact snippet
* afixi failing test with capital-agent added to files_to_check
* Fix snippet label syntax for MkDocs build
* Configure proper Gradle project for Kotlin snippets and fix dependencies
* Add KSP support and generated sources to Kotlin snippets build
* fixing capital_agent turnComplete
* Fix syntax error in build.gradle.kts by removing invalid placeholders (#25)
* Adding Kotlin snippets to google-gemini.md (#27)
Pulling kotlin changes to google-gemini.md from glaforge-kotlin-snippets
* Add a warning about not adding an api key to production code. (#28)
* Add a warning about not adding an api key to production code.
* Update note
---------
Co-authored-by: Kristopher Overholt <koverholt@google.com>
* Add ADK Demo App sample showcasing Gemini-powered agents (#29)
This sample demonstrates how to use the Google ADK (Agent Development Kit) in an Android application to create a chat interface powered by a Gemini-based "Fun Facts" agent. The implementation features:
* Integration with the Kotlin ADK core and processor libraries.
* A `FunFactsAgent` defined using `LlmAgent` and the Gemini model.
* A `ChatViewModel` utilizing `InMemoryRunner` for asynchronous message streaming.
* A modern UI built with Jetpack Compose and Material 3.
* Build configuration logic for secure API key management via environment variables or `local.properties`.
* Update Kotlin docs and samples to align with adk-kotlin API changes (#30)
Rename GeminiModel to Gemini, @AdkTool/@AdkParam to @Tool/@Param,
adkTools() to generatedTools(), replace DebugRunner with InMemoryRunner,
fix AgentLoader import path, use SingleAgentLoader, bump Kotlin to
2.3.21 and KSP to 2.3.7, and update Android minSdk from 24 to 26.
* adding kotlin info to READMEs (#14)
* Reorganize Android sample agent and add READMEs (#31)
* Move Android sample agent
* Update repo README, add Android README, update sample agent README
* Minor edit to language support tags (#32)
* Remove blog post link (#33)
Will re-add after it's published
* Remove examples link (#34)
* Adding Kotlin snippets for Sessions docs (#26)
* initial kotlins snippets additions to sessions docs
* Updating memory docs with kotlin snippets
* Adding kotlin snippets to session state docs.
* update model to gemini-flash-latest
* sessions examples clean-up
* fixing sessions snippet markers
* adding kotlin session snippets to files to test
* adding callback to memory_example
* Fixing capital agent snippet (#35)
Fixing file name
Updating adkTool > Tool
Updating GeminiModel > Gemini
* Adding kotlin snippets for tools docs (#36)
* adding function tool kotlin snippets
* adding function_tools snippets to files to test
* Adding kotlin snippets to observability docs (#37)
* initial kotlin observability updates
* adding observability snippets to file check (#38)
* Adding Kotlin snippets to Callbacks docs (#39)
* kotlin callbacks snippets
* adding callbacks snippets to file check
* Align Kotlin and KSP versions with published 0.1.0 artifacts (#40)
* switch CLI entry points from InMemoryRunner to ReplRunner (#41)
* Switch CLI entry points from InMemoryRunner to ReplRunner
* Fix wording
* Update API reference docs for Kotlin, 2026-05-18 (#42)
* Remove ADK on Android note until published (#43)
* Update Kotlin code samples (#44)
* Rename GeminiModel to Gemini in Kotlin snippets and docs
* Remove broken SessionKey call and use sessionId directly in AgentTool snippet
* Rewrite Go hero snippet to use llmagent API
* Use isFinalResponse with safe access in CapitalAgent snippet
* Use Role.USER constant instead of raw string in SetupExample
* Use full semver v0.1.0 in Kotlin language support tags
* Remove Android setup steps, moving to new property (#45)
* Tutorial Kotlin agent (#46)
* Adding multi-tool-agent snippet and updating tutorial
* Fixing Go language order on tutorial page
* adding multi tool agent example to files to test
* Inline Kotlin get-started code sample
* Kotlin Multi agents snippets (#47)
* Multi-agent kotlin snippets
* Fixing docs tags in multiagent example
* Fix Kotlin language support tags, code samples, and google-gemini.md cleanup (#48)
* Add Kotlin v0.1.0 to language support tags across docs
* Fix MultiToolAgent.kt model string and argument style
* Update MultiAgentExample.kt to use gemini-flash-latest model string
* Fix google-gemini.md: add Kotlin sample, remove unsupported Java tabs
* Remove explicit apiKey from CallbackBasic.kt for consistency
* Standardize Gemini() constructor to use named args in all snippets
* Remove adk-samples directory (moved to google/adk-samples#1969)
* Remove adk-samples directory (moved to google/adk-samples#1969) (#49)
* Update API reference docs for ADK Kotlin 0.1.0 (#50)
* Remove adk-samples directory (moved to google/adk-samples#1969)
* Update API reference docs for ADK Kotlin 0.1.0
* Remove kotlin lycheeignore config (#51)
* Remove adk-samples directory (moved to google/adk-samples#1969)
* Remove Kotlin .lycheeignore config links
---------
Co-authored-by: Toni Klopfenstein <2359976+ToniCorinne@users.noreply.github.com>
Co-authored-by: Jolanda Verhoef <JolandaVerhoef@users.noreply.github.com>
* fix: correct agents-cli skill names and deployment targets in Coding with AI tutorial
- Fix skill names to match actual agents-cli implementation:
- google-agents-cli-adk-deploy → google-agents-cli-deploy
- google-agents-cli-adk-dev → google-agents-cli-workflow
- google-agents-cli-adk-eval → google-agents-cli-eval
- google-agents-cli-adk-observe → google-agents-cli-observability
- google-agents-cli-adk-scaffold → google-agents-cli-scaffold
- Add missing google-agents-cli-publish skill
- Add GKE as deployment target (was missing from deploy command description)
- Fix publish destination: 'Agent Store' → 'Gemini Enterprise'
- Reorder skills to match canonical order from agents-cli
* docs: use full branding 'Agents CLI in Agent Platform' in intro paragraphs
Use the full product name 'Agents CLI in Agent Platform' in introductory
paragraphs and first mentions, then shorten to 'Agents CLI' in subsequent
prose references. Command names and code blocks remain as 'agents-cli'.
Changes:
- coding-with-ai.md: First mention uses full branding
- agents-cli.md: Title and intro paragraph use full branding
- index.md: Deployment path description uses full branding
- All subsequent prose references use 'Agents CLI' instead of 'agents-cli'
- Command references and code blocks unchanged (still 'agents-cli')
* Rename asp.md to agents-cli.md and update redirects
- Renamed docs/deploy/agent-runtime/asp.md to agents-cli.md
- Updated navigation reference in mkdocs.yml
- Added redirect rule: agent-runtime/asp.md → agents-cli.md
- Updated existing redirect: agent-engine/asp.md → agents-cli.md
The 'asp' name no longer makes sense as a page name now that we're
referencing Agent Starter Pack / agents-cli directly.
Note: This applies on top of PR #1673 which renamed:
- 'agent-engine' directory → 'agent-runtime'
- 'Agent Engine' product → 'Agent Runtime'
* Complete migration from Agent Starter Pack to agents-cli
This commit completes the migration from "Agent Starter Pack (ASP)"
terminology to "agents-cli" across documentation and updates references
to align with the new Agent Platform tooling.
Changes:
- Updated docs/deploy/agent-runtime/agents-cli.md: Replaced all "Agent
Starter Pack" and "ASP" references with "agents-cli", updated commands
from 'uvx agent-starter-pack enhance --adk -d agent_engine' to
'agents-cli scaffold enhance --deployment-target agent_engine', and
updated all documentation links to point to google.github.io/agents-cli/
- Updated docs/tutorials/coding-with-ai.md: Replaced "ADK Dev Skills"
section with "agents-cli" section, changed installation from
'npx skills add google/adk-docs/skills -y -g' to
'uvx google-agents-cli setup', updated skill names table to new
agents-cli skill names, and added CLI commands table
- Updated docs/deploy/agent-runtime/index.md: Changed "Agent Starter Pack
deployment" to "agents-cli deployment" and updated reference from
"The Agent Starter Pack (ASP)" to "agents-cli in Agent Platform"
- Deleted docs/skills/ directory: Skills have been migrated to the
agents-cli repository
* Fix agents-cli deployment instructions to use correct CLI commands
Replace incorrect make command references with agents-cli deploy and agents-cli infra single-project. Update deployment workflow to reflect actual agents-cli usage.
* Update navigation to use agents-cli instead of Agent Starter Pack
Replace "Agent Starter Pack" with "agents-cli" in the navigation menu. Redirects from old ASP URLs are already in place.
* Restore docs/skills/index.md - Agent Skills documentation
This file documents the Agent Skills feature (agentskills.io specification),
not ADK Dev Skills. It was mistakenly deleted in the ASP → agents-cli migration.
Agent Skills are a general ADK feature where agents can use modular,
self-contained units of functionality based on the Agent Skill specification.
* Fix terminology: Agent Engine runtime → Agent Runtime runtime
Update deployment path description to use consistent "Agent Runtime runtime"
terminology instead of "Agent Engine runtime".
* Fix broken agents-cli documentation links
Replace broken links to /guide/ (which 404s) with correct links to main
documentation page. The /guide/ URL is a directory listing that doesn't
exist in the agents-cli docs structure.
Changes:
- Line 31: "Development guide" link → "Guide" pointing to main docs
- Line 221: "Development guide" link → "agents-cli documentation" pointing to main docs
Both now correctly point to https://google.github.io/agents-cli/
* Delete ADK Dev Skills directory - migrated to agents-cli
Remove the entire skills/ directory containing ADK Dev Skills. These
skills have been migrated to the agents-cli repository and are now
distributed as part of the agents-cli package.
Users should now install skills via:
uvx google-agents-cli setup
Instead of the old method:
npx skills add google/adk-docs/skills -y -g
Deleted skills (now available in agents-cli):
- adk-dev-guide → google-agents-cli-workflow
- adk-cheatsheet → google-agents-cli-adk-code
- adk-eval-guide → google-agents-cli-eval
- adk-deploy-guide → google-agents-cli-deploy
- adk-observability-guide → google-agents-cli-observability
- adk-scaffold → google-agents-cli-scaffold
Total: 19 files removed across 6 skill directories
* Remove skills CI checks
---------
Co-authored-by: Kristopher Overholt <koverholt@google.com>
* docs: home page
* updates based on feedback
* respond to review feedback
* docs: update gemini selector strings to "flash-latest"
* Update homepage.css
* Replace google.github.io/adk-docs URLs and /adk-docs/ paths with adk.dev
Migrate all hardcoded documentation references to use the new custom
domain. Update root-relative links to remove the /adk-docs/ subpath
prefix since the site will be served from the root of adk.dev.
* Additional fixes
* Add ADK Development Skills section to Coding with AI tutorial
- Added new section describing ADK development skills package
- Includes installation instructions using npx skills add
- Lists all available skills (cheatsheet, dev-guide, deploy-guide, etc.)
- Positioned before llms.txt section for better flow
* Update coding-with-ai.md
* Rewrite Coding with AI page for clarity and consistency
* global skills install
* Update coding-with-ai.md
---------
Co-authored-by: Kristopher Overholt <koverholt@google.com>
Co-authored-by: Joe Fernandez <joefernandez@users.noreply.github.com>
* Add ADK Development Skills section to Coding with AI tutorial
- Added new section describing ADK development skills package
- Includes installation instructions using npx skills add
- Lists all available skills (cheatsheet, dev-guide, deploy-guide, etc.)
- Positioned before llms.txt section for better flow
* Update coding-with-ai.md
* Rewrite Coding with AI page for clarity and consistency
---------
Co-authored-by: Kristopher Overholt <koverholt@google.com>
Co-authored-by: Joe Fernandez <joefernandez@users.noreply.github.com>
* Upgraded the Claude model to claude-sonnet-4-6 evrywhere in the docs.
* Added the missing java samples for vertex.md
* Undid changes in the wrong branch
---------
Co-authored-by: Joe Fernandez <joefernandez@users.noreply.github.com>
* Add mkdocs-llmstxt and related config
* Remove existing llms.txt and llms-full.txt from repo
* Add docs page for llms.txt
* Minor edit
* Minor edit
* Add *.md to glob syntax in mkdocs-llmstxt config
* Add explicit URLs in API reference section to avoid build warnings
* Fix all build warnings related to bad cross-links and incorrect anchor links
* Suppress INFO logs about absolute links - the CI link checker will catch any issues
* Fix remaining build warnings
* Add Gemini CLI instructions
* Fix link to bidi tutorial
* Add async session initialization example when running in .py script
Added example code for initializing a session asynchronously when running in .py script
* Update docs/tutorials/agent-team.md
---------
Co-authored-by: Kristopher Overholt <koverholt@google.com>
* Add AG-UI adk-middleware tutorial
* Significantly trim down docs
* Change some headers
* Add AG-UI page to nav
* Shorten description on tutorials page
* Edits throughout tutorial
---------
Co-authored-by: Kristopher Overholt <koverholt@google.com>
* Phase 1: ADK Onboarding journey revision
- Quickstart: split by language and reduce time
- Build your agent: new section for agent building
- Home page: Simplify onboarding choices
- Surface "About ADK" in navigation
* Updates from first review round and Java research
- completely revised Java quickstart
* further updates from review
* more review updates
---------
Co-authored-by: Kristopher Overholt <koverholt@gmail.com>
Wrong method is used for getting weather. Instead of `get_weather` it should be `get_weather_stateful`
Co-authored-by: Joe Fernandez <joefernandez@users.noreply.github.com>
* fix: remove as_dict() usage from final session state logging
The code incorrectly called `.as_dict()` on a plain `dict` object, causing an AttributeError.
This commit removes the invalid `.as_dict()` call.
* fix: remove .as_dict() usage from final session state logging
The code incorrectly called `.as_dict()` on a plain `dict` object, causing an AttributeError.
This commit like the previous one removes another occurence of the `.as_dict()` call.
---------
Co-authored-by: Lavi Nigam <98014943+lavinigam-gcp@users.noreply.github.com>
The code incorrectly called `.as_dict()` on a plain `dict` object, causing an AttributeError.
This commit replaces it with direct usage of the dictionary and adds a comment.
Co-authored-by: Lavi Nigam <98014943+lavinigam-gcp@users.noreply.github.com>
* fix(tutorial): Correct say_hello tool logic, update LLM models, and ensure async session creation
This commit addresses several issues and updates within the ADK agent team tutorial (adk_tutorial.ipynb) and its corresponding documentation (agent-team.md).
Notebook Updates (adk-tutorial.ipynb):
- Ensured all `SessionService.create_session` calls are `await`ed for proper asynchronous operation throughout the notebook.
- Updated Anthropic model to `claude-sonnet-4-20250514` and OpenAI model to `gpt-4.1`, with commented alternatives for flexibility.
- Added LiteLLM documentation links for model references.
- Resolved the 'Hello None' issue in Step 3 by modifying the `say_hello` tool to correctly handle optional name arguments and prevent the `Default value is not supported` warning with Gemini models.
- Tested and confirmed notebook compatibility with `google-adk==1.0.0`.
Page Update (agent-team.md):
- Synchronized `agent-team.md` with all notebook changes to ensure documentation accuracy and reflect the latest updates.
* fix(tutorial): Refine CLI/Web UI agent team tutorial and update content
This commit introduces several fixes and improvements to the Python file-based version of the ADK agent team tutorial, aligning it for use with `adk web`, `adk run`, and `adk api_server`.
Key changes to the `adk-tutorial` Python files:
- Validated and ensured all tutorial steps are compatible with `google-adk==1.0.0`.
- Synchronized Python file content with the latest changes from the main Colab notebook version.
- Corrected `step2_anthropic.py`: agent name, description, and instruction strings now accurately reflect Anthropic context (previously used GPT-related strings).
- Updated model identifiers: `anthropic/claude-sonnet-4-20250514` in `step2_anthropic.py` and `openai/gpt-4.1` in `step2_gpt4.py`.
- Performed general cleanup and refactoring in `step3_agent_team.py`.
- Added example queries directly within the agent Python files for Steps 1, 2, 3, 5, and 6 to facilitate easier testing by users.
- Removed `step4_state_personalization.py` as its demonstration of session state manipulation (especially direct InMemorySessionService updates) is better suited for an interactive notebook environment.
README.md Updates:
- Added a note explaining the removal of Step 4 and directing users to the interactive notebook version for that specific content.
- Included references to the newly added sample queries in the agent Python files, guiding users on how to test the agent's functionalities.
* fix: tutorial section overhaul and bug fixes
- Tutorial section is moved out of getting started and is a seperate section
- Fixed a sentence in getting-started page that still showed “google search”
- Given we will have more tutorials as part of docs, now we have sub-sections with the tutorial name
- For weather agent team - fixed issues pointed out in #118#135
- It now includes code for asynio in the notebook
- It also now has .py file to run it through adk web
- Step 2 is now optional and not connected to other steps. So user can follow other steps if they choose to
- There is disclaimer at the top - for different method to run the code
- The text on the page is now synced with notebook
- Collab and social link are updated with new changes in folder.
* added a redirect in the redirect_maps
* adding license headers in the code for tutorial for .py files
George Weale