* #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>
* 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
* 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>
* 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>
* Add MLflow scorers integration page
Adds a new integration page at docs/integrations/mlflow-scorers.md
covering MLflow's five Google ADK scorers (ToolTrajectory, ResponseMatch,
ResponseEvaluation, Safety, Hallucination) for agent evaluation. The
integration wraps ADK's TrajectoryEvaluator, RougeEvaluator,
FinalResponseMatchV2Evaluator, SafetyEvaluatorV1, and HallucinationsV1Evaluator
behind MLflow's scorer interface, so ADK users can evaluate agents inside
mlflow.genai.evaluate() runs without leaving the ADK ecosystem.
Complements the existing MLflow Tracing and MLflow AI Gateway integration
pages by covering evaluation, the third leg of the MLflow stack for ADK.
Signed-off-by: debu-sinha <debusinha2009@gmail.com>
* Trigger CLA re-check
Signed-off-by: debu-sinha <debusinha2009@gmail.com>
* Use version-agnostic Gemini aliases and refine copy
* Update category tags for other pages
---------
Signed-off-by: debu-sinha <debusinha2009@gmail.com>
Co-authored-by: Kristopher Overholt <koverholt@google.com>
Zyan