* #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>
* Fix Go multi-tool tutorial snippet to include two tools
* Update model string in multi-tool snippets to gemini-flash-latest in Python, TS, Java
---------
Co-authored-by: Kristopher Overholt <koverholt@google.com>
* 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>
* 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>
The memory docs and the express-mode weather agent notebook referenced
`adk.tools.preload_memory_tool.PreloadMemoryTool()`, which raises
`AttributeError: module 'google.adk.tools' has no attribute
'preload_memory_tool'` because the submodule is not exposed via the
package's lazy `__getattr__`.
Use the documented public API `from google.adk.tools import preload_memory`
and pass the `preload_memory` instance directly, consistent with how the
sibling `load_memory` tool is shown in the same page.
Fixes#1771
Co-authored-by: Kristopher Overholt <koverholt@google.com>
* Add Security and deployment section to Visual Builder page (#1492)
Documents two behaviors introduced in ADK Python v1.27.4: builder endpoints
are only registered when the web UI is enabled (adk web), and Visual Builder
uploads are restricted to .yaml/.yml files. Verified against
src/google/adk/cli/fast_api.py at current main.
* Issue #1492 -1 Visual Builder Security and deployment
Expanded Project Structure Documentation: Added a detailed, itemized breakdown explaining the specific role and functionality of each generated file and directory within the DiceAgent/ project structure.
Added Security & Deployment Guidelines: Introduced a new section outlining local API endpoint behaviors, headless/production constraints, and strict file upload validation rules (such as extension whitelisting and path traversal blocks) to align the documentation with the latest security updates in the codebase.
* Document builder endpoint security and deployment behavior
* Formatting edits
---------
Co-authored-by: Kristopher Overholt <koverholt@google.com>
* 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>
The "Runner start callbacks" section described `before_run_callback` as
returning a `types.Content` to "replace the user's original message". That is
actually the behavior of `on_user_message_callback`; the text (including the
"Purpose" line) was duplicated from that section.
In the implementation, returning a `Content` from `before_run_callback` halts
the run: the Runner yields it as an early-exit event and skips all subsequent
processing instead of invoking the agent.
See `Runner._exec_with_plugin` in `src/google/adk/runners.py`:
early_exit_result = await plugin_manager.run_before_run_callback(...)
if isinstance(early_exit_result, types.Content):
early_exit_event = Event(..., content=early_exit_result)
...
yield early_exit_event # early exit, agent never runs
else:
# normal execution
This also matches the BasePlugin docstring: "Returning a value to halt
execution of the runner and ends the runner with that event."
Fix the "When It Runs", "Purpose", and "Flow Control" bullets accordingly.
Co-authored-by: Kristopher Overholt <koverholt@google.com>
* I updated the section to include token id
* Update authentication.md
* Update authentication.md
* Update authentication.md
* Update authentication.md
* Update authentication.md
* Fix heading casing and anchor link text in ID token section
* Drop letter prefixes from toolset config headings
* Expand intro to "Configure tools with authentication"
---------
Co-authored-by: Kristopher Overholt <koverholt@google.com>
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>
* Format localhost URLs as inline code in quickstarts
* Correct module paths and stale notes in snippet comments
* Reword "and later" to "and higher" in snippet notes
* 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>
* adding go getting started to 2.0 docs
* updating graphs docs for go; adding in workflow example go snippets
* Updating HiTL docs for Go 2.0
* updating Go getting started guide for v2
* Updating Routes docs for Go v2
* Updating data handling docs for Go 2.0
* Updating dynamic workflows docs for Go 2.0
* fix(docs): set ADK Go 2.0 GA date on the 2.0 landing page
* fix(docs): standardize ADK Go 2.0 install/import on /v2 @ v2.0.0
* updating announcement banner
* routes snippets updates
* 2.0 install instructions clean-up
* updating collaboration docs for go v2 + new example snippet
---------
Co-authored-by: Karol Piotrowicz <kpiotrowicz@google.com>
* updating command-line and web-interface docs to reflect what flags are compatible with adk-go
* clarifying go documentation on runtime api-server docs
* formatting clean-up of language tabs
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.
* 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>
* 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)
* 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
* ci: pin actions to SHAs and harden workflows with zizmor auto-fixes
* ci: set least-privilege GITHUB_TOKEN permissions on workflows
* ci: move PR/issue context into env vars to prevent template injection
* 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>
Zyan