Commit Graph

154 Commits

Author SHA1 Message Date
danyang-google 9db1fe2440 docs: move get_bucket to admin toolset and simplify GCS IAM permissions (#2056)
Co-authored-by: Joe Fernandez <931947+joefernandez@users.noreply.github.com>
2026-08-21 14:47:18 -07:00
Joe Fernandez 8c4074329d docs: correct nonexistent google-adk[vertexai] extra to [gcp] (#2132)
The `vertexai` extra does not exist in google-adk's pyproject.toml, so
`pip install google-adk[vertexai]` silently installs the base package
without the Agent Platform dependencies. Readers following these snippets
hit an ImportError when constructing VertexAiSessionService or
VertexAiMemoryBankService.

The correct extra is `gcp`, which pulls in
google-cloud-aiplatform[agent-engines].

Follow-up to review feedback on #2031, which flagged the two occurrences
in express-mode.md. The same stale extra appears once in
sessions/session/index.md, fixed here too.

Co-authored-by: Shahin Saadati <happyhuman@users.noreply.github.com>
2026-08-19 08:21:02 -07:00
Zyan a7584a1dc9 Create integration page for Bashtool per Issue 1438 - 5 (#2048)
* Create bashtool.md

This PR adds the integration documentation for the new ExecuteBashTool in the Python ADK.

Rendered view:
Agent's PR: #1442 
Original Issue: #1438  

Key additions:

- Documented the tool's core capabilities and experimental status.
- Added security and execution safeguards (User Confirmation, Command Validation, Resource Limits, Disabled Core Dumps, and Process Group Termination).
- Reviewed against ADK integration-create and review guidelines 
- Checked against the repository> https://github.com/google/adk-python/blob/ecb759cc16bc870aa190d01c4c3f0e1e3e97afab/src/google/adk/tools/bash_tool.py

Icon PR: #2047

* Update bashtool.md

* Update bashtool.md

* Add files via upload

* Add files via upload
2026-08-12 15:54:16 -06:00
George Weale d9e930e823 docs(integrations): fix unresolvable imports and stale API claims (#2031)
* docs(integrations): fix unresolvable imports and stale API claims

* docs: apply style pass and drop out-of-scope import cleanup

* docs(integrations): address review feedback on gcs, cloud-trace, reflect-and-retry

Restore the gcs_ tool name prefixes in the GCS tool tables, since both
toolsets set tool_name_prefix="gcs" and the tables list names as the
model sees them. Use the current Agent Platform SDK name in cloud-trace
prose, make the reflect-and-retry failure description language-neutral
for Python and Go, and drop the redundant re-export clause.

* docs(gcs): note that tool_filter matches unprefixed tool names

Tool filtering runs inside get_tools() against the unprefixed name, and
get_tools_with_prefix() applies the gcs_ prefix afterwards, so the names
in the tables are not the names tool_filter expects.

* docs(computer-use): drop unused Gemini and override imports

---------

Co-authored-by: Kristopher Overholt <koverholt@google.com>
2026-08-11 18:11:00 -05:00
Shahin Saadati 34d4ec2921 Add Kotlin snippet for the Knowledge Engine retrieval tool (#2090)
* Upgrade Kotlin examples to adk-kotlin 0.7.0

The Kotlin examples were pinned to adk-kotlin 0.5.0, which predates the
context caching, Vertex AI memory, and RAG retrieval APIs. Bump the pin to
0.7.0 so snippets for those features can be added.

Three consequences of the bump are handled here:

- `ExperimentalResumabilityFeature` was removed in 0.7.0, so RunConfigExample
  no longer opts into it. The annotation class is gone, not merely deprecated,
  so this is a hard compile break rather than a warning that could be deferred.
- The Vertex AI session and memory services expose Ktor's `HttpClient` as a
  defaulted constructor parameter, so any snippet naming them needs Ktor on the
  compile classpath, not just at runtime.
- The `resolutionStrategy` block forcing kotlin-stdlib 2.1.20 is now dead. It
  worked around 0.5.0 publishing a stdlib newer than this project's compiler;
  0.6.0 fixed that upstream. Verified that the highest stdlib on the compile
  classpath is still 2.1.20 without it.

Also fixes two unrelated snags found while validating the above:

- `check_kotlin_snippets.sh` walked `examples/kotlin` without pruning build
  output, so after any local build it reported every generated KSP file as an
  unregistered snippet. CI only ever ran it against a clean checkout, so the
  bug was invisible there.
- A transclusion path in logging.md was split across two lines, so the include
  never resolved and the code block rendered empty.

* Fix broken links to adk-python plugin samples

The three plugin sample links 404. adk-python renamed
`contributing/samples/plugin/` to `contributing/samples/plugins/`; the
directory contents are otherwise unchanged, so only the path segment moves.

This is what the repo-wide `link-check` job has been failing on. It is
unrelated to the 0.7.0 upgrade in this PR, but the check gates the merge and
the fix is confined to the three URLs.

Verified all three targets return 200.

* Add Kotlin snippet for the Knowledge Engine retrieval tool

The Knowledge Engine integration page only showed Python. `VertexAiRagRetrieval`
landed in adk-kotlin 0.7.0, so add a Kotlin tab and advertise Kotlin support in
the page badge.

Retrieval runs inside the model through the Gemini-native `vertexRagStore` kind
rather than as a locally executed tool, so the snippet configures the corpus via
`VertexRagStoreRagResource` and leaves invocation to the model.

Registers the new file in files_to_test.txt so it stays in the compile
regression suite.

* Use the conventional package for the RAG retrieval snippet

RagEngine.kt declared `package integrations`. Every other snippet in the tree
uses `com.google.adk.kt.examples.<area>`. It compiled either way because the
source root is `snippets/` and Kotlin does not require the directory to match
the package, so nothing would have caught it.

Also worth flagging for anyone reading this alongside the memory snippets: the
two APIs take opposite corpus formats. `VertexAiRagRetrieval` here wants the
full `projects/.../ragCorpora/...` resource name, while
`VertexAiRagMemoryService` wants a bare corpus id and rejects the full name.
That is the library's doing, not a docs inconsistency.
2026-08-10 08:22:15 -07:00
Milen Kovachev ab749867b0 docs(eventarc): Address technical verification report feedback (#2074)
- Add pip install "google-adk[gcp]" step to Eventarc Prerequisites.
- Clarify datacontenttype inference defaults and specify application/json in snippet prompt.
- Update Runtime Lambda table entry to use ctx.session_id and note support for payload and Context.
- Update OMIT table entry to list all mandatory attributes (type, source, bus, id, specversion).

Addresses feedback in https://github.com/google/adk-docs/pull/2045#issuecomment-5184438669

Co-authored-by: Joe Fernandez <931947+joefernandez@users.noreply.github.com>
2026-08-07 20:30:29 +00:00
Shahin Saadati b1b2eaa102 Upgrade Kotlin examples to adk-kotlin 0.7.0 (#2088)
* Upgrade Kotlin examples to adk-kotlin 0.7.0

The Kotlin examples were pinned to adk-kotlin 0.5.0, which predates the
context caching, Vertex AI memory, and RAG retrieval APIs. Bump the pin to
0.7.0 so snippets for those features can be added.

Three consequences of the bump are handled here:

- `ExperimentalResumabilityFeature` was removed in 0.7.0, so RunConfigExample
  no longer opts into it. The annotation class is gone, not merely deprecated,
  so this is a hard compile break rather than a warning that could be deferred.
- The Vertex AI session and memory services expose Ktor's `HttpClient` as a
  defaulted constructor parameter, so any snippet naming them needs Ktor on the
  compile classpath, not just at runtime.
- The `resolutionStrategy` block forcing kotlin-stdlib 2.1.20 is now dead. It
  worked around 0.5.0 publishing a stdlib newer than this project's compiler;
  0.6.0 fixed that upstream. Verified that the highest stdlib on the compile
  classpath is still 2.1.20 without it.

Also fixes two unrelated snags found while validating the above:

- `check_kotlin_snippets.sh` walked `examples/kotlin` without pruning build
  output, so after any local build it reported every generated KSP file as an
  unregistered snippet. CI only ever ran it against a clean checkout, so the
  bug was invisible there.
- A transclusion path in logging.md was split across two lines, so the include
  never resolved and the code block rendered empty.

* Fix broken links to adk-python plugin samples

The three plugin sample links 404. adk-python renamed
`contributing/samples/plugin/` to `contributing/samples/plugins/`; the
directory contents are otherwise unchanged, so only the path segment moves.

This is what the repo-wide `link-check` job has been failing on. It is
unrelated to the 0.7.0 upgrade in this PR, but the check gates the merge and
the fix is confined to the three URLs.

Verified all three targets return 200.
2026-08-07 13:24:29 -07:00
Zyan e25527b1dd Create enterprise web search integration page per issue #1113 - 3 (#2058)
* Create enterprise-web-search.md

Rendered page:
Logo's PR: #2057 
Agent's PR: #1121 and #1122 
Original Issue: #1113 

--

This PR adds the official documentation for the new EnterpriseWebSearchTool.

Key additions:

- Overview & Use Cases: Explains enterprise compliance, controlled web access, and regulated workflows.
- Code Examples checked against repositories: Provides initialization snippets for both Python (google-adk) and TypeScript (@google/adk).

* Update enterprise-web-search.md

* Update enterprise-web-search.md
2026-08-06 17:00:24 -06:00
Zyan 135350b340 Logo for Enterprise Web Search integration page (#2057) 2026-08-06 16:57:20 -06: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
Haiyuan Cao 0fba5aa6f0 Enhance BigQuery Agent Analytics documentation (#2028)
* Enhance BigQuery Agent Analytics documentation

Updated documentation to clarify Java and Python plugin differences, added details on dropped-event observability, and improved explanations of event types and attributes.

* Address review: use language support tags and a single drop-reasons table

- Replace the inline Java version callouts in prose with language-support-tag
  blocks on the relevant sections (Built-in redaction, Dropped-event
  observability; ADK 2.0 workflow events already carried one).
- Collapse the duplicated 'Drop reasons (Python)' / 'Drop reasons (Java)'
  tables into a single table with a per-language column.
- Trim the duplicated Java scope prose in the intro and the ADK 2.0 note.

---------

Co-authored-by: Kristopher Overholt <koverholt@google.com>
2026-08-05 08:50:09 -05:00
Milen Kovachev 9f1ae0d3f0 docs: add Eventarc tool integration page and code snippets (#2045)
* docs: add Eventarc tool integration page and code snippets

- Document general-purpose EventarcToolset and publish_message tool
- Document domain-specific create_publish_tool with static, dynamic, and runtime lambda attribute bindings
- Add complete, runnable Python code snippets for both built-in tool and domain-specific publishing
- Add Eventarc icon asset

* Improve the documentation after running integration-review script.

* Update eventarc.md

---------

Co-authored-by: Joe Fernandez <931947+joefernandez@users.noreply.github.com>
2026-08-04 20:48:26 +00:00
Zyan 308c783180 Update slack integration page tag to connectors (#2049) 2026-07-31 18:18:26 -05:00
Zyan e62aa9b2d3 Create slack runner integration page #1521 - 4 (#2035)
* Create slack runner integration page #1521 - 4

Adds the official integration documentation for `SlackRunner`. 

- Created `docs/integrations/slack.md` following the Plugin template.
- Added Socket Mode installation and initialization instructions (`google-adk[slack]`).
- Checked against the integration-review and integration-create instructions.

* Update slack.md

* Update slack.md

Worked on feedback
2026-07-31 14:23:17 -06:00
Shobhit Singh de510f8059 docs: remove experimental banner from data agent tools (#2037)
* docs: remove experimental banner from data agent tools

* Update data-agent.md

also remove "Experimental" tag subheader

---------

Co-authored-by: Joe Fernandez <931947+joefernandez@users.noreply.github.com>
2026-07-31 08:15:21 -07:00
Zyan b0c2f1665a Slack logo (#2036)
Uploading png image for Slack logo
2026-07-30 20:56:41 -06:00
Joe Fernandez c2c5359807 Update code-exec-agent-runtime.md (#2034) 2026-07-30 15:29:08 -07:00
Zyan 890af7cf79 Add Spanner Admin Toolset per issue #1521 - 6 (#1998)
* Update Spanner Toolset per issue #1521 - 6

Rendered page:
PR: #1525 
Original Issue #1521 

---

- Updated the page to add the Spanner admin toolset info with examples.
- Added configuration details for environment variables.
- Added alias for gemini-flash-latest to the bot's original snippet.
- Added contextual system instruction for the agent.

* Update spanner.md
2026-07-29 12:42:44 -06:00
Josh Zhang 131a92e1d0 docs(integrations): refresh e2a page for the hosted-only MCP server (#2026)
* docs(integrations): refresh e2a page for the hosted-only MCP server

The e2a integration page has drifted from the service since it landed in
May. Corrections:

- Drop both Local MCP Server tabs. The `@e2a/mcp-server` npm package is
  retired and the current server has no stdio transport, so `npx -y
  @e2a/mcp-server` installs an abandoned build.
- Point the remote examples at `https://api.e2a.dev/mcp`, the endpoint
  published in the MCP Registry, instead of the older `mcp.e2a.dev`.
- Remove `E2A_AGENT_EMAIL`, which no longer exists; `whoami` takes no
  inputs and resolves identity from the credential.
- Remove the `E2A_BASE_URL` config table (renamed, and unused now that
  the page is hosted-only).
- Fix the held-send status: `pending_review`, not `pending_approval`.
- Drop the `agent_mode: local|cloud` guidance. There is no delivery mode
  to choose; inbound is available by polling or webhook subscription.
- Refresh the tool surface (~60 tools, was 18) and group it by credential
  scope, since an agent-scoped key sees only the runtime tools.
- Update repository links for the tokencanopy org rename.

* docs(integrations): recommend the e2a SDK for production ADK agents

The MCP toolset gives the model the inbox, which is the wrong layer for
the deterministic parts of a deployment: webhook signature verification,
at-least-once delivery handling, and idempotent sends. Add a section
recommending the SDK own that boundary, with the MCP toolset kept for
model-driven actions inside a turn, and point at the working example.

* docs(integrations): add WebSocket delivery and future-proof the tool count

Two corrections after checking the page against the running service:

- Receiving mail listed only polling and webhooks. WebSocket delivery via
  the SDK's listen() needs no public URL, which makes it the practical
  choice while developing an ADK agent or for a long-running agent that
  isn't a web service.
- The tool surface grows; state 60+ rather than a number that dates.

* docs(integrations): restructure e2a page to the integration template

Address review feedback. Drop the four added top-level sections ('For
production', 'Key scope', 'Receiving mail', 'Sending and review holds')
and fold only the load-bearing facts back into the template's existing
shape:

- Key scope becomes two sentences introducing Available tools, since an
  agent-scoped key genuinely cannot see the admin tools listed there.
- The SDK recommendation becomes a short tip after the code sample,
  keeping the inline links.
- Delivery options and OAuth become one sentence each in Configuration.
- accepted/pending_review moves into the send_message table row.

Additional resources trimmed to four: dropped the MCP Registry link (a
raw JSON API) and the two SDK links, which remain linked inline.

Page is now intro / use cases / prerequisites / one sample / tools /
configuration / resources, 186 lines.

---------

Co-authored-by: Kristopher Overholt <koverholt@google.com>
2026-07-28 17:48:35 -05:00
Kristopher Overholt 9114ba877c Fix broken adk-samples links from deleted samples (#2004) 2026-07-28 12:32:40 -05:00
Simon 69b25925e1 docs: update Unstructured Transform MCP tool names and cover the extraction tools (#2010)
* docs: update Unstructured Transform MCP tool names

* docs: cover the Unstructured Transform extraction tools
2026-07-28 11:12:08 -05:00
Kristopher Overholt ceceda2616 Fix broken docs link on ZoomInfo integration page (#1992)
Co-authored-by: Joe Fernandez <931947+joefernandez@users.noreply.github.com>
2026-07-24 18:21:56 +00:00
Haiyuan Cao 29c409dab3 docs: highlight BigQuery Agent Analytics Looker Block in the dashboard section (#1997)
Add a featured "Looker Block" subsection to "Build a dashboard" pointing to the
ready-to-use BigQuery Agent Analytics Looker Block on the Looker Marketplace,
and move the existing example-notebook guidance under a "Custom dashboard from a
notebook" subsection.
2026-07-23 14:15:45 -05:00
Zyan 3e6ee758f2 VertexAiSearchTool dynamic config according to issue #1227 - 7 (#1968)
* VertexAiSearchTool dynamic config according to issue #1227 - 7

Added dynamic configuration per the bot's suggestion, but I improved snippet and description.

* Update agent-search.md

* Align snippet param name with SDK signature (readonly_context)

---------

Co-authored-by: Kristopher Overholt <koverholt@google.com>
2026-07-16 07:08:41 -05:00
Cheney Zhang 84beddc61f docs: add Milvus integration page (#1924)
Signed-off-by: Cheney Zhang <chen.zhang@zilliz.com>
Co-authored-by: Kristopher Overholt <koverholt@google.com>
2026-07-16 05:21:31 -05:00
Kristopher Overholt f5f7d4ce0a Update link to broken CarsXE site on integration page (#1963) 2026-07-15 12:06:33 -05:00
Simon 8d57944eee Add Unstructured Transform MCP integration (#1956)
* Add Unstructured Transform MCP integration

* Add pacing helper, env setup, and Gemini key prerequisite from review

* Re-trigger CLA check after signing

* Use the blue Unstructured logo for the integration icon

* Note that the agent can retry a weak parse with the hi_res strategy

* formatting changes

* Adopt nested tab convention, make wait helper async, replace hyphen asides

---------

Co-authored-by: Kristopher Overholt <koverholt@google.com>
2026-07-14 12:55:27 -05:00
Zyan e251603b3d Update cloud trace page according to issue #1256 - 5 (#1940)
* Update cloud-trace.md to include captured attributes

* Cloud trace small updates

Small change to the Cloud Trace section

* Update cloud-trace.md

* Update cloud-trace.md

* Update cloud trace page according to issue #1256 - 5 

Managed the conflicts with the agent's PR. Updated the Google Cloud Console link. It would be more helpful to deep-link directly to the Trace Explorer rather than the root dashboard, so this has been adjusted. Added a brief introductory paragraph to the ## Resources section to provide better context for the provided links

* Update cloud-trace.md

Worked on feedback: fixed capitalization, ensured consistent formatting, removed extra spaces, and made the update more technically accurate.

* Update cloud-trace.md

Worked on missing feedback comments.

* Remove user.id from captured attributes and clarify heading in cloud-trace.md

* Format cloud-trace.md: line wrapping, tab spacing, and copy cleanup

---------

Co-authored-by: adk-bot <adk-bot@google.com>
Co-authored-by: Kristopher Overholt <koverholt@google.com>
2026-07-13 18:24:05 -05:00
Kristopher Overholt 233342579d Update ADK Java dependency versions to 1.6.0 (#1939) 2026-07-13 15:52:59 -05:00
Alex Ezell 46a56dcb8c Add Sprites integration (#1945)
* Add Sprites integration

Adds the Sprites integration page and catalog icon. Sprites (https://sprites.dev)
are persistent, stateful Linux sandboxes from Fly.io with checkpoint/restore,
via the sprites-adk plugin (pip install sprites-adk).

* Refine Sprites page: benefit-forward use cases, precise wording

* Address review: functional heading + runner registration in example

---------

Co-authored-by: Kristopher Overholt <koverholt@google.com>
2026-07-10 16:17:43 -05:00
Haiyuan Cao 122d4de847 Enhance BigQuery Agent Analytics with new options (#1942)
* Enhance BigQuery Agent Analytics with new options

Added options for OpenTelemetry correlation, custom metadata capture, and payload column projection in BigQuery Agent Analytics configuration.

* Fix formatting of Interactive Demo Notebook link

fix format

* docs(bigquery-agent-analytics): replace version callouts with language support tags

Address review feedback (koverholt) on PR #1942: the page used ad-hoc,
non-conventional version callouts (per-row table tags, footnotes, version
suffixes in headers, "post-vX.Y.Z" notes) that are unmaintainable and, in
places, stale.

- Drop the "(v2.4.0+)" / "(1.27.0+)" suffixes from config-table rows and
  section headers; convey minimum versions with the repo-standard
  language-support-tag blocks on the relevant sections instead
  (Trace correlation → Python v2.4.0, Automatically Created Views →
  Python v1.27.0, ADK 2.0 workflow events → Python v2.3.0).
- Remove the "‡ Added in v2.4.0" and "† ... not in v2.2.0" view-table
  footnotes; the ADK 2.0 views/columns now point to the ADK 2.0 section.
- Remove the stale top "Version Requirement" note (v2.2.0 is no longer the
  latest release; ADK 2.0 workflow support shipped in v2.3.0) and the stale
  ADK 2.0 section note; de-version the intro prose.
- Remove the "Structured tool declarations (post-v2.4.0)" note: that shape is
  not in any tagged release (v2.4.0 emits tools as a list of names); it will
  be re-added under a language-support-tag once it ships.
- Trim the Trace-correlation section so it no longer restates the option table,
  keeping only the cross-option constraints and the combined example.
2026-07-09 15:58:38 -05:00
Zyan 7458d68a64 #1029 - 8 vector_store_similarity_search and SpannerVectorStoreSettings (#1926)
* #1029 - 8 vector_store_similarity_search and SpannerVectorStoreSettings

Added vector_store_similarity_search to SpannerToolset. SpannerVectorStoreSettings is introduced to support this feature.

* Update spanner.md

* Update spanner.md

Applied feedback. Additionally, reviewed the phrasing in the intro for clarity and concision and did some minor formatting edits.

* Fix wrapping, missing import, trailing whitespace, formatting fixes

* Restructure Spanner page: add intro, section headings, reorder vector search

* Add experimental tags/notes to corresponding integration pages

---------

Co-authored-by: Kristopher Overholt <koverholt@google.com>
2026-07-08 18:28:52 -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
Hyang-Ah Hana Kim af790ae141 docs: update more Go documentation and examples to ADK Go v2 (#1936)
* 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>
2026-07-07 18:09:07 -05:00
Omar Walied 209e82e055 docs(integrations): add CarsXE MCP integration (#1934)
* docs(integrations): add CarsXE MCP integration

Add CarsXE to the integrations catalog as an MCP server integration.
The hosted CarsXE MCP server (https://mcp.carsxe.com/mcp, streamable
HTTP) exposes vehicle data — VIN specs, plate decoding, market value,
history, recalls, lien/theft, OBD codes, images — as MCP tools wired
into an ADK agent via McpToolset. Includes Python and TypeScript
examples, the full tool list, and an icon asset.

* Update docs/integrations/carsxe.md

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

* Update docs/integrations/carsxe.md

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

---------

Co-authored-by: Kristopher Overholt <koverholt@google.com>
2026-07-07 14:03:34 -05:00
Kristopher Overholt 72015b26d4 Update ADK Java dependency versions to 1.5.0 (#1922)
* Update ADK Java dependency versions to 1.5.0

* Clarify ADK version guidance in Firestore note
2026-07-01 15:13:53 -05:00
Perseus Computing 7a783f43b0 docs(integrations): link Perseus integration page from Mimir's Resources (#1913)
Now that the Perseus Context integration page is live, point to it
instead of the raw GitHub repo, mirroring how perseus.md already
links back to /integrations/mimir/.

Co-authored-by: Kristopher Overholt <koverholt@google.com>
2026-06-30 16:30:58 -05:00
Haran Rajkumar d802044831 docs: update GenAI auth env var and Client parameter (#1832)
* 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>
2026-06-30 08:51:51 -07:00
Nitin K. 4fa428a502 docs(redis): document selectable memory backends (#1866)
Update the Redis integration page for adk-redis 0.0.7 selectable memory
backends. Sessions and memory now run on either managed Redis Agent Memory
(the default) or the self-hosted Agent Memory Server, chosen with a
`backend` field.

- Intro, approaches table, and prerequisites now describe both backends.
- Sessions + Memory example uses the managed backend with api_key/store_id,
  plus a note on switching to opensource-agent-memory.
- New Memory tools tab covering the SDK BaseTool memory classes.
- Services table and resource links clarified per backend.
2026-06-29 16:26:27 -05:00
Perseus Computing d20e4a14bb Add Perseus Context integration page (#1891)
* Add Perseus Context integration page

Adds docs/integrations/perseus.md (catalog tags: code, mcp) plus the
assets/perseus.svg icon. The page documents adk-perseus-context — an ADK
plugin / before_model_callback that injects a deterministically compiled
Perseus context into the system instruction — and the optional Perseus MCP
server via McpToolset. The integrations catalog auto-renders from the
frontmatter, so no nav changes are needed.

* Update Perseus icon to the matched Mimir/Perseus icon system

Flat SVG: directives (nodes) converging into a single context node
(amber #F5A623 on #161420), matched to Mimir's layered-memory mark.

* Refine page for consistency and correctness

* Fix typo in lychee config

---------

Co-authored-by: Kristopher Overholt <koverholt@google.com>
2026-06-29 15:06:58 -05:00
Abhishek N 499fc2f95d Add Zespan integration documentation for ADK agents (#1890)
* Add Zespan integration documentation for ADK agents

* Clean up page formatting and code examples

---------

Co-authored-by: Kristopher Overholt <koverholt@google.com>
2026-06-29 14:29:18 -05:00
Perseus Computing d4c58151dd docs(mimir): matched icon + add "mcp" catalog tag (#1892)
* Update Mimir icon to the matched Mimir/Perseus icon system

Flat SVG: fading memory layers (violet #8B5CF6 on #161420), matched to
Perseus's converging-context mark so the pair reads as one ecosystem.

* Add "mcp" catalog tag to Mimir

Mimir is an MCP (stdio) server, so it belongs under the catalog's MCP
filter — which also surfaces it alongside its companion, Perseus
(tagged code/mcp), as a pair.

* docs(mimir): drop "mcp" catalog tag per review (integration uses BaseMemoryService, not McpToolset)
2026-06-29 11:29:31 -05:00
Volodymyr Maliuta 7d3fe44e62 Updating Java documentation for BigQueryAgentAnalyticsPlugin (#1876)
* Fixing  java version, adding java example for formatter, small format fix

* Enhancing example for formatter.
2026-06-26 18:04:35 -05: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
Perseus Computing 73a1beb4b6 feat(integrations): add Mimir Memory — persistent cross-session memory for ADK (#1877)
* feat(integrations): add Mimir Memory — persistent cross-session memory for ADK

Adds MimirMemoryService integration documentation:
- Persistent, local, encrypted memory backend for ADK agents
- AES-256-GCM encryption, FTS5+dense hybrid search
- Zero cloud dependencies — single Rust binary + SQLite
- Includes Perseus live context agent sample
- Backend comparison table vs InMemory, VertexAi, RAG

Package: https://github.com/Perseus-Computing-LLC/adk-mimir-memory
Refs: google/adk-python#6169

* Formatting edits

* Fix Mimir Memory code samples, install steps, and comparison table

* Fix unrelated link failure for Arize Phoenix

* Add link to PyPI package

---------

Co-authored-by: Kristopher Overholt <koverholt@google.com>
2026-06-26 13:16:38 -05:00
William 19388945c6 docs(integrations): add Latitude observability integration (#1849)
* docs(integrations): add Latitude observability integration

Add a Latitude integration page under docs/integrations with an
observability catalog tag, a square card logo, and a complete,
runnable ADK example using Latitude's Python telemetry SDK.

* Add evaluation tag, env-var credentials, and clean up copy/links

---------

Co-authored-by: Kristopher Overholt <koverholt@google.com>
2026-06-25 12:07:23 -05:00
Anish Yadav 15aca2a8d0 docs(integrations): add Synap long-term memory integration (#1854)
* docs(integrations): add Synap long-term memory integration

* docs(integrations): add Synap logo asset

* Use gemini-flash-latest, link product page, and remove em dashes

* Fix other card descriptions

---------

Co-authored-by: Kristopher Overholt <koverholt@google.com>
2026-06-24 14:48:58 -05:00
Harsh Kale 5960308464 docs: add ADK Connector integration guide (#1828)
* docs: add ADK Connector integration catalog page

* docs: add Discord connector setup and configuration

* Generalize channel list, use gemini-flash-latest, and shorten the session-sync heading

---------

Co-authored-by: Kristopher Overholt <koverholt@google.com>
2026-06-24 14:34:27 -05:00
Kristopher Overholt cf7ceae47b Fix broken A2UI links to renamed a2ui-project/a2ui repo and new sample/SDK paths (#1857)
Co-authored-by: Juan Carlos Gonzalez Resendiz <juancarlosgon@google.com>
2026-06-24 14:29:06 -05:00
Adam Lin 0dda1af206 docs(integrations): add Agent Threat Rules (ATR) guardrail plugin (#1850)
* docs(integrations): add Agent Threat Rules (ATR) guardrail plugin

Adds docs/integrations/atr-guardrail.md (+ icon) for the adk-atr-guardrail
package -- an in-process, deterministic security guardrail that enforces the
open-source Agent Threat Rules ruleset at three fail-closed Runner callbacks
(before_run / before_model / before_tool). Tagged 'resilience'. Created per
maintainer guidance on google/adk-python#6130 to ship as a standalone package
listed in the integrations catalog. Verified locally with mkdocs build.

* Use gemini-flash-latest, switch to the App plugin pattern with ADK >= 2.0, and remove the resilience catalog tag

---------

Co-authored-by: Kristopher Overholt <koverholt@google.com>
2026-06-24 14:12:38 -05:00