169 Commits

Author SHA1 Message Date
Shahin Saadati 2570332640 Add A2A consuming quickstart for Kotlin (#2118)
* Add A2A consuming quickstart for Kotlin

adk-kotlin has been able to consume remote A2A agents since 0.6.0, and the docs
had no Kotlin page for it. This adds one alongside the Python, Go and Java
quickstarts, plus its nav entry.

A new page rather than a tab: docs/a2a has no tab groups at all, it is one page
per language, so this follows the section's own shape.

Two dependencies are needed, not one. The a2a artifact publishes the A2A SDK as
runtime-only, and A2AAgent's httpClient parameter defaults to JdkA2AHttpClient(),
so a2a-java-sdk-client has to be on the compile classpath as well. That number
was established by compiling, not by reading module metadata: the a2a artifact
alone fails with "Cannot access class 'A2AHttpClient'", and adding the client
artifact is sufficient -- spec and the jsonrpc transport arrive transitively.

Only the consuming side is documented, because that is all that exists: no
webserver source at v0.7.0 mentions a2a, so there is no Kotlin equivalent of the
exposing quickstarts. The page says so and links to the Python and Java ones.

A2AAgent is a suspending factory, and the implementation class behind it is
internal, so the factory is the only way to construct one. The snippet notes it.

Verified end to end rather than by compiling alone: served a real agent card
from a local server and ran the snippet, which fetched it, parsed it and wired
the remote agent in as a sub-agent --
"Root agent root_agent delegates to prime_agent".

* Correct the agent card claims and make the server step usable

A2AAgent does not read the remote's name from the card: the name is the
caller's, and independent of what the card advertises. It does not read the
transport either, which is hardcoded to JSON-RPC. What the card supplies is
the description and the streaming capability.

The server step told readers to start a server without saying how, and the
two obvious candidates do not work: adk-kotlin parses A2A 1.0 cards, which
require supportedInterfaces with a protocolBinding, and the adk-java and
adk-python samples both publish 0.3-style cards that A2AAgent rejects with
AgentCardResolutionError. State that, and give a minimal card verified by
running the snippet against it.

Also fix the root agent instruction, which referenced dice-rolling the agent
cannot do; match the Java snippet's prime-delegation wording.

* Point the A2A quickstart at the adk-python sample server

The page claimed neither the adk-java nor the adk-python sample works as the
server for this quickstart. The adk-python half is wrong. adk-python does not
serve its `agent.json` verbatim: `fast_api.py` parses it through
`_compat.parse_agent_card`, and under a2a-sdk 1.x that parse promotes the
legacy `url` and `preferredTransport` into `supportedInterfaces`. The dependency
is `a2a-sdk>=0.3.4,<2`, so a fresh install resolves to 1.x and the card on the
wire is A2A 1.0 - exactly what the Kotlin client requires.

So the page now names a server a reader can actually start, instead of asking
them to hand-write a card:

    adk api_server --a2a --port 8001 \
      contributing/samples/a2a/a2a_basic/remote_a2a

Its card is served under the agent's own prefix, and the snippet's agentCardUrl
follows it to http://localhost:8001/a2a/check_prime_agent. Confirmed the route
prefix in `attach_a2a_routes_to_app` and that the sample card's own `url`
already points there.

The adk-java half of the claim was correct and stays: `a2a_server` is pinned to
the 0.3.x A2A SDK and serves a 0.3 card. That, and the A2A 1.0 requirement it
illustrates, move into a note. The hand-written card survives as a collapsible
fallback for readers bringing their own server.

Reported by joefernandez in review of #2118.
2026-08-18 14:56:47 -07:00
Amaad Martin c75e61f5f3 docs: normalize Typescript to TypeScript across the site (#2079)
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>
2026-08-05 15:58:49 -07:00
Joe Fernandez 1d8a608348 docs(live): Refactor streaming docs, move streaming/ to live/ directory (#2063)
Co-authored-by: Shahin Saadati <happyhuman@users.noreply.github.com>
2026-08-04 16:09:24 -07:00
Mikalai Senkevich f58f09c0df docs: add documentation for OpenAI model support in ADK agents (#2000)
Co-authored-by: Joe Fernandez <931947+joefernandez@users.noreply.github.com>
2026-07-31 18:29:21 +00:00
Joe Fernandez 84c5364d3b docs(session): refactor the session docs for better usability (#2027)
* Update index.md

* navigation and page title renaming
2026-07-28 23:44:24 +00:00
Haran Rajkumar de3244cb92 Stop publishing homepage partials as standalone pages (#2009)
* Stop publishing homepage partials as standalone pages

The homepage is assembled from partials in docs/_includes/homepage/ via the
macros plugin. mkdocs.yml listed `/_includes/**` under `not_in_nav`, which only
suppresses the "not in nav" warning -- the partials were still built, published,
and indexed. All ten had live URLs, e.g. https://adk.dev/_includes/homepage/_eval/.

These pages are broken in isolation: the partials use paths relative to the site
root, so on their own URL links like `href="evaluate/"` resolve to
/_includes/homepage/_eval/evaluate/ (404) and images fail to load.

Move the pattern to `exclude_docs` so the partials are skipped by the build,
and delete _eval.md and _ai-dev-tools.md, which were dropped from index.md in
#1772 and are no longer included anywhere.

Verified with a local build: site/index.html is byte-identical before and after,
and the only difference across the entire output tree is the removal of the ten
_includes/ pages, which also disappear from sitemap.xml and the search index.

* Update mkdocs.yml

remove extended comments from config file; PR and blame records are sufficient explanation.

---------

Co-authored-by: Joe Fernandez <931947+joefernandez@users.noreply.github.com>
2026-07-28 10:40:56 -07:00
Haran Rajkumar 508e742f84 docs(agents): add Managed Agents page (Managed Agents API x ADK) (#1949)
* docs(agents): scaffold managed agents page and nav entry

* docs(agents): add managed agents get-started and decision guidance

* docs(agents): complete managed agents page (how it works, limitations, resources)

* docs(agents): simplify managed agents "how it works" and refine copy

Replace the internals-heavy "How it works" paragraph with a high-level
description that links to the Interactions API, drop the scenario table
in favor of the two-bullet comparison, add a note on how ManagedAgent
maps to the Managed Agents API (data plane vs. control plane), and
remove em-dashes throughout.

* docs(agents): point Interactions API link to the Gemini API overview

* Clean up managed agents page naming, structure, bullets, and links, and add it to the agents overview

---------

Co-authored-by: Kristopher Overholt <koverholt@google.com>
2026-07-10 18:35:35 -05:00
Perseus Computing eebc269376 docs(integrations): rename Mimir Memory → Perseus Vault Memory (supersedes #1877) (#1928)
* docs(integrations): rename Mimir Memory -> Perseus Vault Memory (supersedes #1877)

* docs(integrations): address review on perseus-vault memory page

- Restore "Use cases" section
- Add intro phrases before Installation and Use-with-agent code blocks
- Point the binary prereq at the Installation section
- Drop the non-existent `cargo install perseus-vault` step
- Remove the "(formerly Mimir/Mneme)" lineage note
- Add trailing newline

* docs(integrations): restore Perseus live context (optional) section

Carry over the optional [perseus] extra / perseus_context_agent section
from the original page, updated to the Perseus Vault names.

---------

Co-authored-by: Kristopher Overholt <koverholt@google.com>
2026-07-07 19:18:04 -05:00
Joe Fernandez 1b2660a0c0 docs: Update Go API docs references (#1911)
* docs: Update Go API docs references

* respond to review comments
2026-06-30 13:51:50 -07:00
Joe Fernandez fea383b916 Consolidate Google Cloud and Agent Platform connection info (#1819)
* 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
2026-06-26 15:07:00 -07:00
Kristopher Overholt ad63473882 Add optimize dir to llmstxt plugin config (#1782) 2026-05-20 12:02:34 -05:00
Joe Fernandez c5a064e99a chain (#1772) 2026-05-19 13:24:47 -07:00
Kristopher Overholt a583b64aec Move Visual Builder page under Runtime > Web Interface page (ADK Web) (#1759)
* Move adk web Visual Builder page content into Runtime > adk web page

* Clarify Visual Builder in intro

* Fix casing for consistency

* More casing fixes

* Move Visual Builder page under Web Interface

* Fix link from runtime index page

* Keep Visual Builder file at original path, nest under Web Interface in nav

---------

Co-authored-by: Joe Fernandez <joefernandez@users.noreply.github.com>
2026-05-19 12:20:15 -05:00
Kristopher Overholt 50f7df7f46 Add Kotlin language support to ADK docs (#1768)
* 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>
2026-05-19 11:43:42 -05:00
Kristopher Overholt f6b1259cdc Add agent routing and model routing pages for RoutedAgent/RoutedLlm in ADK JS (#1709)
* Add agent routing and model routing docs for RoutedAgent and RoutedLlm in ADK JS

* Update example code snippets

* Add renamed code sample files

* Update lychee link checker config

* Shorten docs and snippets paths and filenames

* Update titles

* Rework intros

* Rework intros

* Add notes about experimental status

* Move InMemoryRunner outside of code snippet regions since it's unused in rendered snippet
2026-05-04 17:37:44 -05:00
Kristopher Overholt 06bec8757d Add Cancel Agent Runs page for AbortSignal support in ADK JS (#1708)
* Add Cancel Agent Runs docs page for ADK JS AbortSignal support

* Add Cancel Agent Runs page

* Shorter section heading

* Re-run deploy build

* Fix language tag

* Move sample code to snippets files/dir

* Reword intro

* Reorder sections

* Shorter doc and snippet file names

* Add cancel page
2026-05-04 16:07:56 -05:00
Kristopher Overholt 6261e3a2bd Readd docs page for metrics (#1713)
* Readd docs page for metrics

* Update lychee link checker config

* Update lychee config
2026-05-04 16:02:09 -05:00
Kristopher Overholt 7e3b386339 Remove metrics page that documents unreleased functionality (#1712)
The metrics module and has not shiipped in any stable ADK
Python release. The page will be restored once a release
includes metrics support.
2026-04-30 16:48:29 -05:00
Kristopher Overholt e5d509d0ea Update more product names (Agent Runtime, Knowledge Engine, Agent Retrieval) (#1701)
* Rename RAG Engine to Knowledge Engine across docs

* Fix remaining Agent Engine / Reasoning Engine product names

* Rename Vector Search 2.0 to Agent Retrieval in grounding docs
2026-04-28 16:26:45 -05:00
mhenc f68cf78ddc Add documentation pages for metrics and traces (#1686)
* Add documementation pages for metrics and traces

* First round of review

* Updated versions tag

* Update docs/observability/metrics.md

Co-authored-by: Kristopher Overholt <koverholt@google.com>

* Update docs/observability/traces.md

Co-authored-by: Kristopher Overholt <koverholt@google.com>

* Update docs/observability/traces.md

Co-authored-by: Kristopher Overholt <koverholt@google.com>

* Update docs/observability/metrics.md

Co-authored-by: Kristopher Overholt <koverholt@google.com>

* Update docs/observability/traces.md

Co-authored-by: Kristopher Overholt <koverholt@google.com>

* Update docs/observability/traces.md

Co-authored-by: Kristopher Overholt <koverholt@google.com>

* Update docs/observability/metrics.md

Co-authored-by: Kristopher Overholt <koverholt@google.com>

* Update docs/observability/traces.md

Co-authored-by: Kristopher Overholt <koverholt@google.com>

* Update docs/observability/traces.md

Co-authored-by: Kristopher Overholt <koverholt@google.com>

* Update docs/observability/metrics.md

Co-authored-by: Kristopher Overholt <koverholt@google.com>

* Added information about traces and metrics to observability/index.md

* Minor link and formatting edits

---------

Co-authored-by: Kristopher Overholt <koverholt@google.com>
2026-04-28 12:18:36 -05:00
Pier Paolo Ippolito 8bbf83f0a7 Add agents-cli docs, replace Agent Starter Pack references (#1677)
* 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>
2026-04-22 08:03:04 -07:00
Kristopher Overholt 1214ad915a Update product names in docs (#1673)
* Update names in docs

* Update names in docs

* Code formatting

* Format notebooks

* Update names in docs

* Update names in docs

* Update names in code samples

* Update names in docs

* Update names in docs

* Update names in docs

* Update names in docs

* Update names in docs

* Update names in docs

* Update names in docs

* Update names in docs

* Update icon

* Update names in docs

* Update names in docs
2026-04-22 05:10:38 -07:00
Pat Sukprasert 1b35d1482a docs: add MLflow AI Gateway model provider page (#1661)
* docs: add MLflow AI Gateway model provider page

Adds a model provider page showing how to connect ADK agents to
MLflow AI Gateway via the LiteLlm wrapper with a custom api_base.

* docs: add Create Endpoint screenshot

* docs: move MLflow AI Gateway to integrations section

Per reviewer feedback: move the gateway page from agents/models/ to
integrations/ as a standalone integration page. Rename the existing
MLflow tracing page catalog_title to "MLflow Tracing" to distinguish
the two entries.

* Remove nav entry for integrations

* Additional cleanup / redirects / renames

* Additional edits

---------

Co-authored-by: Kristopher Overholt <koverholt@google.com>
2026-04-20 18:37:35 -07:00
eliasecchig f3f466fe29 Add ambient agents documentation (#1630)
* Add ambient agents documentation

Document how to build event-driven ambient agents using ADK trigger
endpoints and the /run endpoint. Covers Pub/Sub, Eventarc (Standard
and Advanced), Cloud Scheduler, concurrency control, retry logic,
session lifecycle, and deployment to Cloud Run.

* Address reviewer feedback: clarify event processing flow

- Move "How events are processed" higher, right after trigger endpoints
  intro, so the mental model comes before setup instructions
- Reword step 5: explicitly describe status code behavior (200 = ack,
  500 = retry) instead of vague "determines whether to retry"
- Clarify that trigger endpoints auto-create sessions without needing
  the --auto_create_session flag
- Restructure heading hierarchy under "Using trigger endpoints"

* Address reviewer feedback from koverholt

- Use named sections (--8<-- [start/end]) in code snippets to hide
  license headers in doc embeds
- Change model to gemini-flash-latest alias
- Restructure: show example agent first, then enable instructions,
  then "Try it locally" with step-by-step commands and curl test
- Fix port consistency (curl uses 8000 matching adk api_server default)
- Add curl example for /run endpoint

---------

Co-authored-by: Kristopher Overholt <koverholt@google.com>
2026-04-15 09:26:16 -05:00
Kristopher Overholt 4eae06c647 Add _includes to not_in_nav to suppress build warning (#1578) 2026-04-08 15:11:11 -05:00
ykchen-g 17505f214a Env simulation doc (#1573)
* add env simulation documation

* add env simulation documation

* Address PR feedback
2026-04-07 16:40:48 -07:00
Kristopher Overholt 54ff71b519 Fix mobile nav sidebar opening into Home section instead of top-level nav (#1570) 2026-04-07 16:10:55 -05:00
Joe Fernandez 7567175816 docs: move multi-tool agent and redirect links (#1557)
* docs: move multi-tool agent and redirect links

* update based on comments and testing
2026-04-03 17:55:27 -07:00
Vlad Kolesnikov f998b39ea5 Release Support Changes (#1548) 2026-04-02 15:46:09 +01:00
Joe Fernandez 983a4ce0df docs: move Community nav second row (#1542)
* docs: move Community nav second row

- move community docs to /community/ directory

* update llmstxt configuration
2026-04-01 14:49:56 -07:00
Kristopher Overholt 43bea9924d Update site_url and add CNAME for adk.dev custom domain (#1535)
* Update site_url to adk.dev in mkdocs.yml

* Add docs/CNAME for GitHub Pages custom domain

Required by MkDocs to preserve the custom domain configuration
across gh-deploy builds, which overwrite the gh-pages branch.
2026-04-01 12:45:56 -05:00
Guillaume Laforge 0dacea986e doc: A2A support in ADK Java (#1503)
* doc: A2A support in ADK Java

* doc: fix spelling for the Agent2Agent protocol name
2026-03-27 09:12:13 -07:00
Kristopher Overholt d984373662 Autogenerate Python REST API reference docs from FastAPI OpenAPI spec (#1500)
* Auto-generate Python REST API reference docs from FastAPI OpenAPI spec

* Fix link and llmstxt config

* Generate REST API docs with web=False

* Use simpler BaseLayout for generated REST API docs
2026-03-27 10:56:19 -05:00
Keyur 8339e723a6 Add documentation for ADK optimization features (#1478)
* Add documentation for ADK optimization features

* Update mkdocs.yml

* Update index.md

---------

Co-authored-by: Joe Fernandez <joefernandez@users.noreply.github.com>
2026-03-26 16:40:11 -07:00
jcpagadora737 34382cf3d8 docs: Add evaluation custom metrics documentation (#1490) 2026-03-26 22:54:37 +00:00
Joe Fernandez 4849e6a907 docs: adk2 update (#1457)
* docs: adk2 update

* Update index.md

* Update index.md

* Update data-handling.md
2026-03-18 09:31:44 -07:00
Guglielmo Colombo 88b09c0bb5 Update documentation of new A2A-ADK integration (#1405)
* feat: introduce A2A Extension for V2 agent executor and document advanced configuration options in quickstart guides.

* docs: Update A2A Extension title, clarify ADK reference, and add link to activation mechanism.

* add spacing

* docs: Update A2A integration terminology and configuration parameters in quickstart guide

* docs: Enhance A2A Extension and V2 Agent Executor documentation by detailing benefits, usage, and configuration options, and update navigation.

* docs: Update output misclassification description from root agent to event thoughts.

* chore: remove extraneous blank line

* add extension details

* fix typo

* rewrote the intro for A2A extension

* Removed "V2 Implementation" from TOC

We don't want to specify version numbers in the TOC because this immediately makes the docs look out of date when the version changes.

* Update a2a-extension.md

* Moved A2A Extension up the TOC hierarchy so it's more visible

* docs: Simplify A2A Quickstart (Consuming) Python navigation entry in mkdocs.yml.

* fix typo

---------

Co-authored-by: Joe Fernandez <joefernandez@users.noreply.github.com>
2026-03-17 15:25:07 +00:00
Joe Fernandez 441fe9a943 Footer correction: mkdocs.yml (#1434) 2026-03-13 14:55:24 -07:00
Matthew Chan 201e325337 docs: Add documentation for LiteRT-LM model hosting (#1382)
* docs: Add documentation for LiteRT-LM model hosting

* Update litert-lm.md

* docs: Add LiteRT-LM entry to mkdocs.yml.

---------

Co-authored-by: Joe Fernandez <joefernandez@users.noreply.github.com>
2026-03-06 14:23:32 -08:00
Kaz Sato c75cf7320e fix: change the tool name to ADK Gemini Live API Toolkit (#1338)
* fix: change the tool name from ADK Bidi-streaming to ADK Gemini Live API Toolkit

fix: change the tool name from ADK Bidi-streaming to ADK Gemini Live API Toolkit

* fix: Rename "Bidi-streaming" to "Gemini Live API Toolkit" in nav, landing page, quickstart, and feature matrix

Updates mkdocs.yml navigation, streaming landing page card titles/links, quickstart cross-reference, and feature matrix entries.

* docs: update source references for ADK v1.26.0

Update all ADK source code references to point to the v1.26.0 commit
with corrected line numbers for drifted references.

---------

Co-authored-by: Joe Fernandez <joefernandez@users.noreply.github.com>
2026-02-27 10:46:58 -08:00
Joe Fernandez 031c8e871e docs: Add "ADK" to site title for findability (#1320)
* docs: Add "ADK" to site title for findability

* respond to feedback
2026-02-17 11:14:46 -08:00
Joe Fernandez 01c2eec8db docs: Add documentation for Skills support (#1313)
* docs: Add documentation for Skills support

* respond to feedback, add pointers from agents page

* small update
2026-02-13 14:37:54 -08:00
Joe Fernandez 06a78591bd docs: MCP pages, add tip pointer to Tools and integrations (#1290)
* docs: MCP pages, add tip pointer to Tools and integrations

* adding Integration tips

- also removing incorrect Plugin / ADK Web incompatibility issue
2026-02-11 14:51:21 -08:00
Joe Fernandez 4853a64e44 Update copyright (#1273) 2026-02-09 15:46:49 -06:00
Kristopher Overholt 94636546e5 Update integrations assets (#1255) 2026-02-06 13:04:22 -06:00
Joe Fernandez b117fc695b docs: centralize 3P and 1P Integrations content (#1249)
* docs: centralize 3P and 1P Integrations content

- move all content to integrations/
- frontmatter headings for all integration listings

* respond to review comments
2026-02-06 09:30:13 -08:00
Kaz Sato f06ea2dd47 docs: Add grounding index page with RAG resources (#1158)
* docs: Add grounding index page with RAG resources

Add an index page for the grounding section that provides an overview
of grounding approaches in ADK including Google Search, Vertex AI Search,
and Agentic RAG. Features links to documentation, blog posts, notebooks,
and sample agents.

* updates to improve grounding docs

---------

Co-authored-by: Joe Fernandez <joefernandez@google.com>
Co-authored-by: Joe Fernandez <joefernandez@users.noreply.github.com>
2026-02-04 10:58:21 -08:00
Kristopher Overholt 8f77b0b8f6 Fix tool card icon sizing and missing metadata (#1217) 2026-02-02 16:48:56 -06:00
Joe Fernandez 7c8ffc080e docs: add infrastructure for integrations catalog (#1210)
* docs: single source extensions listings

* docs: add infrastructure and updates for catalog

* updates: feedback responses, third party and gemini

* fix: update Python code
2026-02-02 08:59:26 -08:00
Kristopher Overholt 13f14d5a70 Add button to copy page Markdown to clipboard (#1202)
* Add button to copy page as Markdown to clipboard

* Move copy button JS to separate file

* Use Markdown from llms-txt instead of raw GitHub content

* Fix and change evaluation -> evaluate in llms-txt config

* Add missing pages / folders to llms-txt config in mkdocs.yml

* Fix order of llms-txt config Reference
2026-01-30 11:56:54 -06:00