Commit Graph

116 Commits

Author SHA1 Message Date
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
Alex Liu c730d29b23 docs: adding respan integration doc (python) (#1837)
* docs: adding respan integration doc (python)

* Use gemini-flash-latest in code samples

* Add link in intro

---------

Co-authored-by: Kristopher Overholt <koverholt@google.com>
2026-06-24 13:52:07 -05:00
Debu Sinha 8be243255b Add MLflow scorers integration page (#1829)
* 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>
2026-06-24 13:29:11 -05:00
snesridh-ctrl 98513f5366 Add Google Cloud Parameter Manager integration (#1841)
* Create secret-manager.md

initial draft

* Update secret-manager.md

Updated draft

* Update secret-manager.md

* Update secret-manager.md

* Update secret-manager.md

* Add files via upload

* Update secret-manager.md

* Update secret-manager.md

* Update secret-manager.md

* Update secret-manager.md

* Create parameter-manager.md

* Add files via upload

* Update parameter-manager.md

* Update parameter-manager.md

Update parameter-manager.md based on review feedback

* Update parameter-manager.md

Update parameter-manager.md based on review feedback

* Update parameter-manager.md

* Update parameter-manager.md

* Update parameter-manager.md

---------

Co-authored-by: Joe Fernandez <931947+joefernandez@users.noreply.github.com>
2026-06-23 20:24:46 +00:00
Lyndon Bauto e81c53625e Add Aerospike integration (#1802)
* Add Aerospike integration to ADK catalog

Document adk-aerospike session, memory, and artifact services with tabbed
Python examples, URI configuration, storage layout, and catalog assets.

* Fix adk web CLI flags and minor formatting edits

---------

Co-authored-by: Kristopher Overholt <koverholt@google.com>
2026-06-23 14:43:20 -05:00
Haiyuan Cao 8b9b8badce Enhance BigQuery Agent Analytics with reliability fixes (#1817)
* Enhance BigQuery Agent Analytics with reliability fixes

Added reliability and observability fixes for BigQuery Agent Analytics, including cross-region storage write routing, dropped-event tracking, and improved span management in Cloud Trace.

* Fix markdown formatting in BQAA doc

Resolve the code-fence/content-tab indentation issues flagged in review:

- Full example: restore the === "Python" content tab and indent the whole
  Python code block uniformly to 8 spaces so it is a proper sibling of the
  === "Java" tab (previously the block was half-de-indented with an orphaned
  opening fence next to a lone Java tab).
- Public methods: move the Python list inside the === "Python" tab (it had
  been pasted at column 0, outside the tab) and remove the duplicated list
  that ended up wrongly nested under the "Async context manager" bullet.

* Revise BigQuery Agent Analytics documentation

Updated version requirements and added details about ADK 2.0 multi-agent workflow features and event types. Enhanced descriptions for internal span tracking and storage behavior.
2026-06-22 12:19:20 -05:00
danyang-google a371ee81e8 docs: Document GCS first party toolset (#1846)
* docs: Document GCS first party toolset

* Update gcs.md for clarity and style considerations

* Update gcs.md

---------

Co-authored-by: Joe Fernandez <931947+joefernandez@users.noreply.github.com>
2026-06-18 15:33:50 -07:00
Haiyuan Cao 9cdc191673 Add context graph section to BigQuery Agent Analytics docs (#1827)
* Add context graph section to BigQuery Agent Analytics docs

Added a section on the context graph, detailing its purpose, structure, and operational references for materialization and deployment.

* Add files via upload

---------

Co-authored-by: Joe Fernandez <931947+joefernandez@users.noreply.github.com>
2026-06-12 14:50:17 -07:00
snesridh-ctrl 65e6e5543f Add Secret Manager integration details. (#1823)
* Create secret-manager.md

initial draft

* Update secret-manager.md

Updated draft

* Update secret-manager.md

* Update secret-manager.md

* Update secret-manager.md

* Add files via upload

* Update secret-manager.md

* Update secret-manager.md

* Update secret-manager.md

* Update secret-manager.md

---------

Co-authored-by: Joe Fernandez <931947+joefernandez@users.noreply.github.com>
2026-06-12 14:14:28 -07:00
Volodymyr Maliuta c22bb059e3 docs: Adding BigQueryAgentAnalyticsPlugin for Java (#1831)
* Update bigquery-agent-analytics.md

* Update bigquery-agent-analytics.md

Java version fix

* Update bigquery-agent-analytics.md

* Update bigquery-agent-analytics.md

* Changing documentation for BigQueryAgentAnalyticsPlugin , adding  java examples.

---------

Co-authored-by: Joe Fernandez <931947+joefernandez@users.noreply.github.com>
2026-06-12 20:58:39 +00:00
adk-bot f3ecca6d0f Update ADK doc according to issue #1743 - 1 (#1745)
* Update ADK doc according to issue #1743 - 1

* Update environment-toolset.md

---------

Co-authored-by: Zyan <zyanya@google.com>
2026-06-09 14:26:22 -06:00
Juan Carlos Gonzalez Resendiz 1d3029aed5 Update agent-registry.md (#1798) 2026-06-05 16:41:03 +00:00
Kristopher Overholt 8235a1cf00 Update Java ADK dependency versions to 1.4.0 (#1812) 2026-06-02 13:32:31 -05:00
Meet Modi 97ddc9ed7f docs: update AgentPhone logo (#1794)
Replace the AgentPhone integration logo with the updated logomark.

Co-authored-by: Kristopher Overholt <koverholt@google.com>
2026-05-26 10:43:53 -05:00
Josh Zhang 7d0a76a8b8 Update e2a integration page with remote MCP server and 7 tools (#1793)
* docs(integrations): refresh e2a — hosted endpoint + 7 missing tools

The e2a integration page has drifted from what the e2a MCP server
actually ships. Two gaps this PR closes:

1. **Hosted endpoint not documented.** e2a runs a hosted Streamable
   HTTP MCP at https://mcp.e2a.dev/mcp that accepts an API key in
   the Authorization header. The page currently only shows the
   stdio path (npx -y @e2a/mcp-server), which doesn't work for ADK
   agents deployed to Cloud Run since Cloud Run can't host stdio
   MCP child processes. Adds a "Hosted MCP Server" tab to both the
   Python and TypeScript code examples using
   StreamableHTTPConnectionParams.

2. **7 tools missing from the table.** The MCP server now registers
   18 tools but the page lists 11. Adds:
     Identity:  update_agent, delete_agent
     Messages:  get_attachment_data
     Domains:   list_domains, register_domain, verify_domain,
                delete_domain (new section)

Also clarifies a few descriptions:

- `whoami` notes E2A_AGENT_EMAIL is only required for multi-agent
  accounts (the hosted endpoint auto-resolves the sole agent at
  session init).
- `delete_agent` and `delete_domain` flag the `confirm: true`
  required arg.
- `get_attachment_data` uses 0-based `attachment_index`, not an
  attachment ID.
- `E2A_BASE_URL` clarifies the var has no effect when connecting
  to the public hosted endpoint.

Cross-linked the cloud-mode webhook example (already shipped in
the e2a repo, not previously referenced from this page) and the
hosted endpoint URL under Additional resources.

No frontmatter / catalog metadata changes — title, description,
icon, and tags (`["mcp"]`) all unchanged.

* fix: import McpToolset from deep path (google-adk 2.0 compat)

google-adk 2.0 stopped re-exporting McpToolset from
`google.adk.tools.mcp_tool`'s package __init__ — only the deep path
`google.adk.tools.mcp_tool.mcp_toolset.McpToolset` still works.

Caught when I actually ran the example against a fresh
google-adk 2.0 install:

  ImportError: cannot import name 'McpToolset' from
  'google.adk.tools.mcp_tool'
  ($VENV/site-packages/google/adk/tools/mcp_tool/__init__.py)

Applies to both the stdio code block and the new hosted code block.
StdioConnectionParams and StreamableHTTPConnectionParams already use
deep paths and continue to work — only McpToolset was broken.

* Revert McpToolset import to standard path

The claim that google-adk 2.0 stopped re-exporting McpToolset from
google.adk.tools.mcp_tool is incorrect. The __init__.py at
src/google/adk/tools/mcp_tool/__init__.py explicitly re-exports
McpToolset (and MCPToolset) via `from .mcp_toolset import McpToolset`.
It has done so in every release, including v2.0.0.

* Rename tab to Remote MCP server for consistency with all other integration pages

* Remove link to raw MCP endpoint

* Match API key variable / format with all other integration pages

* Formatting and consistency edits

---------

Co-authored-by: Kristopher Overholt <koverholt@google.com>
2026-05-22 16:07:19 -05:00
Kristopher Overholt 74c2a2cf39 Update Java ADK dependency versions to 1.3.0 (#1787) 2026-05-21 18:00:22 +00:00
nitin 04cc3512f1 Add Redis integration entry (#1777)
* Add Redis integration entry

Adds an integration catalog entry for `adk-redis`
(https://github.com/redis-developer/adk-redis), the Python package
that provides Redis-backed ADK integrations:

- RedisVL-backed search tools (vector, hybrid, range, text, SQL),
  including native FT.HYBRID on Redis 8.4+
- Session and long-term memory services that implement
  BaseSessionService and BaseMemoryService against
  Redis Agent Memory Server
- An McpToolset helper for RedisVL's own MCP server (`rvl mcp`),
  alongside the existing Agent Memory Server MCP helper
- Self-hosted and managed (Redis LangCache) semantic cache providers

Built and previewed with `mkdocs build --strict`; the page renders at
/integrations/redis/ and appears on the catalog grid.

* Minor fixes to Redis integration page

* Use ADK's native McpToolset for the RedisVL MCP integration

Per maintainer guidance on the PR review thread:

- Replace `create_redisvl_mcp_toolset(...)` (a third-party Python
  wrapper that adk-redis shipped briefly but does not ship in the
  released 0.0.5) with ADK's native `McpToolset` plus
  `StdioConnectionParams` + `StdioServerParameters(command="rvl", ...)`.
  Matches the pattern used by every other MCP catalog page
  (cartesia, chroma, mongodb, pinecone, qdrant).
- Add a `!!! note` admonition pointing readers to
  `/tools-custom/mcp-tools/` if they want to connect to the `rvl mcp`
  server from other ADK language SDKs.
- Rename the tab from "MCP toolset" to "RedisVL MCP server" and
  prepend a one-paragraph explanation.
- Update the surface table at the top: split the single "MCP toolsets"
  row into "RedisVL MCP" (native McpToolset against `rvl mcp`) and
  "AMS MCP toolset" (`create_memory_mcp_toolset`).
- Update the "Available tools" table: replace the
  `create_redisvl_mcp_toolset(...)` helper row with a description of
  the `rvl mcp` server's exposed tools and how to wire `McpToolset`
  to them.

Other clean-ups:
  - Drop the `pip install 'adk-redis[mcp-search]'` line; the extra was
    retired from adk-redis 0.0.5 along with the wrapper. Add a
    `pip install 'redisvl[mcp]>=0.18.2'` line for the MCP CLI.
  - Switch sample vectorizer to `redis/langcache-embed-v2`, matching
    the repo's runnable examples and the rest of the adk-redis docs.

Verified with `mkdocs build --strict` locally. The admonition renders;
the link to `/tools-custom/mcp-tools/` resolves.

* Switch Redis catalog icon to the official Red wordmark SVG

The page previously used the Redis org GitHub avatar PNG (460x460,
cube mark). Swap to `Redis_Logo_Red_RGB.svg` from the official Redis
brand kit (sourced via redis/redis-vl-python), matching the logo used
in the adk-redis README hero. SVG is acceptable for catalog assets
(see goodmem.svg precedent).

Note: this asset is a wordmark (viewBox ~500x156), wider than peer
catalog cards which are mostly square. If it renders awkwardly on the
catalog grid, swap back to a square cube-mark variant.

- Add `docs/integrations/assets/redis.svg`.
- Update `catalog_icon` in `redis.md` frontmatter.
- Drop `docs/integrations/assets/redis.png`.

Verified with `mkdocs build --strict`.

* Formatting and minor edits

* fix: remove AMS MCP toolset mentions per reviewer feedback

Remove create_memory_mcp_toolset() references from the overview table
and MCP tools table. This wrapper was removed from adk-redis in v0.0.6
(redis-developer/adk-redis#13). Users should use ADK's native McpToolset
with SseConnectionParams for Agent Memory Server MCP access.

Resolves comments from @koverholt on lines 29 and 239.

* fix: reorder tabs and table to lead with MCP, fix count to four ways

* feat: add AMS MCP server tab and MCP table entry

Add a separate code tab showing how to connect ADK's native McpToolset
to Agent Memory Server's MCP endpoint over SSE, based on the
fitness_coach_mcp example. Also add a corresponding row to the MCP
reference table. Update overview count to five ways.

* fix: rename AMS MCP to Sessions + Memory MCP server

* feat: split Semantic cache tab into self-hosted and LangCache

Add a separate LangCache tab with accurate code snippet using
LangCacheProvider and LangCacheProviderConfig (cache_id, api_key,
server_url). No local vectorizer needed for the managed service.

* refactor: move semantic caching into its own section

Semantic caching is a cross-cutting optimization rather than a core
integration approach. Move the self-hosted (RedisVL) and managed
(LangCache) cache tabs out of 'Use with agent' into a dedicated
'## Semantic caching' section. Drop the cache row from the overview
table, leaving four core approaches.

* fix: add descriptions to Sessions + Memory and Search tools tabs

* fix: semantic search -> hybrid search in Sessions + Memory description

* docs: link to adk-redis mkdocs site in additional resources

Primary docs link now points to redis-developer.github.io/adk-redis/.
The redis.io integration page is kept as a secondary reference.

* Remove redundant MCP table - does not show tools; make approaches wording future proof

* Readd MCP table with tools and options as before

---------

Co-authored-by: Kristopher Overholt <koverholt@google.com>
2026-05-20 16:30:54 -05:00
Suhani Nagpal c5fb33209f docs(integrations): Add integration page for Future AGI (#1767)
* docs(integrations): add Future AGI as a partner integration

* Formatting and minor edits

---------

Co-authored-by: Suhani Nagpal <suhani.nagpal725@gmail.com>
Co-authored-by: Kristopher Overholt <koverholt@google.com>
2026-05-20 10:27:39 -05:00
harmonisha-wq 764f3cb87b docs: Rename Dataplex to Knowledge Catalog in MCP Toolbox integration (#1783)
* Rename Dataplex to Knowledge Catalog

* Fix link formatting for Knowledge Catalog entry
2026-05-20 08:07:54 -07:00
Kathy Wu dd73f55294 Skills registry docs (#1762)
* docs: add Google Cloud Skill Registry integration guide

* Remove catalog metadata from registry.md

Removed catalog metadata from the Google Cloud Skill Registry documentation.

* resolve comments

* Update skills-registry.md

---------

Co-authored-by: Joe Fernandez <joefernandez@users.noreply.github.com>
2026-05-19 21:41:33 +00:00
Kristopher Overholt 1c93532ca6 Fix broken external links to adk-python contributing/samples and other internal links (#1773)
* Add link to ignore

* Update links to code samples

* Fix links related to graphs and workflows

* Fix more sample links
2026-05-19 13:53:51 -07: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
Josh Zhang 52eb1405cf Add e2a integration (#1766)
* Add e2a integration

e2a is an authenticated email gateway for AI agents — SPF/DKIM-verified
inbound, optional human-in-the-loop approval before outbound mail
ships. Distributed as an MCP stdio server via npx -y @e2a/mcp-server,
exposing 11 tools for inbox management, threaded replies, and HITL
approval flows.

Source: https://github.com/Mnexa-AI/e2a/tree/main/mcp
npm:    https://www.npmjs.com/package/@e2a/mcp-server

* docs(e2a): shorten catalog_description per review feedback
2026-05-18 18:28:39 -05:00
prashantpatare-eng 83742996b5 add agent-identity integration page link (#1765)
* add agent-identity integration page link

* Refactor authentication documentation for clarity

Removed redundant information about OAuth tokens and streamlined the text regarding the Agent Identity Authentication Manager.

* test commit

* Enhance documentation with OAuth resource links

Added additional OAuth authentication resources for Google Cloud Agent Identity.

* remove extra new line

* Update authentication.md

---------

Co-authored-by: Joe Fernandez <joefernandez@users.noreply.github.com>
2026-05-15 23:13:21 +00:00
Prashant Patare 55a9bf8d5d docs: add integration guide for Agent Identity Auth Manager (#1755)
* docs: add integration guide for Agent Identity Auth Manager

* docs: reformat agent-identity.md to match integration guidelines

* docs: update agent-identity.md based on review

* docs: add icon for agent identity integration

* docs: fix icon format for agent identity integration

* Edits to Agent Identity integration page for docs conventions

* Revise agent-identity.md for clarity and updates

Updated the documentation for the Agent Identity Auth Manager to clarify features and improve readability.

* Revise Agent Identity documentation for OAuth flow

Updated the Agent Identity documentation for clarity and added details on OAuth consent flow handling.

* Refactor agent-identity.md for clarity and formatting

Updated formatting and improved clarity in the documentation for the Agent Identity Auth Manager.

* Clarify OAuth consent flow and credential handling

Updated the OAuth consent flow section for clarity and added details on handling the continue URI and credential finalization.

* Refine text for clarity in agent-identity.md

Clarify language and improve readability in the Agent Identity documentation.

* Update Agent Identity auth provider configuration details

Revised instructions for configuring the Agent Identity auth provider and handling user consent flow, including code examples and clarifications.

* add proper spacing

* Updated card title and formatting

* Update agent-identity.md

---------

Co-authored-by: Prashant Patare <prashantpatare@google.com>
Co-authored-by: Kristopher Overholt <koverholt@google.com>
Co-authored-by: Joe Fernandez <joefernandez@users.noreply.github.com>
2026-05-13 14:59:56 -07:00
Haiyuan Cao 1282d016ab Add AGENT_RESPONSE event type and view (#1761)
* Add AGENT_RESPONSE event type and view

* Update docs/integrations/bigquery-agent-analytics.md

---------

Co-authored-by: Kristopher Overholt <koverholt@google.com>
2026-05-12 15:58:18 -05:00
Ben Sully a3dd940241 Add Grafana Cloud MCP server integration (#1756)
* Add Grafana Cloud MCP server integration

Add an integration page for the Grafana Cloud MCP server, which connects
ADK agents to Grafana Cloud observability data (Prometheus, Loki, Tempo,
dashboards, alerts, incidents, and more) via 60+ MCP tools.

Includes Python and TypeScript examples using StreamableHTTP transport
with OAuth 2.1 authorization.

* fix: clarify that users need access to a Grafana Cloud instance, not an account

* Fix docs URLs

* Update docs/integrations/grafana-cloud.md

---------

Co-authored-by: Kristopher Overholt <koverholt@google.com>
2026-05-12 12:15:49 -05:00
Abhinav Mathur 3fd7553c6d docs(integration): add Atlan with updated copy and full tool list (#1757)
* docs(atlan): add Atlan integration page with updated copy and full tool list

Adds the Atlan MCP integration page for ADK. Positions Atlan as
the context layer for enterprise AI (not a data catalog), matching
the copy used in the VS Code and Cursor IDE extensions. Includes
the complete set of 28 tools exposed by the hosted MCP server,
organized by capability.

* Formatting edits

* Formatting in use case bullets

---------

Co-authored-by: Kristopher Overholt <koverholt@google.com>
2026-05-12 11:34:45 -05:00
Qian Li 49340b7a92 Add DBOS integration for durable execution (#1754)
* Add DBOS integration guide

* formatting

* formatting and tweaks
2026-05-11 13:38:26 -05:00
Yaron Schneider 0d18b73330 Add a dapr integration for durable execution (#1742)
* add a dapr integration for durable execution

Signed-off-by: yaron2 <schneider.yaron@live.com>

* Formatting and minor edits

---------

Signed-off-by: yaron2 <schneider.yaron@live.com>
Co-authored-by: Kristopher Overholt <koverholt@google.com>
2026-05-08 16:58:52 -05:00
Abhinav Mathur 625f11fc12 docs(integration): add atlan (#1739)
* docs: add Atlan MCP integration page

Adds an integrations catalog entry for the Atlan data catalog MCP
server, covering semantic search, lineage traversal, governance, and
data quality tools. Mirrors the format used by the Atlassian MCP page.

* docs(atlan): expand tool list to match hosted MCP server

Adds tools that the hosted Atlan MCP server (mcp.atlan.com) exposes
but were missing from the table: get_asset_tool, resolve_metadata_tool,
get_groups_tool, search_atlan_docs_tool, manage_announcements_tool,
manage_asset_lifecycle_tool, the custom-metadata set/value tools
(create/delete/add/remove attributes, update/remove values), and the
Atlan tag tools (add/remove). Drops get_assets_by_dsl_tool, which is
not registered on the hosted server. Groups tools by capability for
readability.
2026-05-08 11:20:53 -05:00
Vinod Vemuru 31ffb15b95 docs: add ZoomInfo MCP integration page (#1737)
* docs: add ZoomInfo MCP integration page

* Add tag; fix link; line wrapping

* docs(integrations/zoominfo): remove redundant Local MCP Server inner tabs

* Revert "docs(integrations/zoominfo): remove redundant Local MCP Server inner tabs"

This reverts commit f7b9521d21.

---------

Co-authored-by: Vinod Vemuru <vinod.vemuru@zoominfo.com>
Co-authored-by: Kristopher Overholt <koverholt@google.com>
2026-05-06 18:36:38 -05:00
Haiyuan Cao 4df2ba71b8 Restructure BigQuery Agent Analytics doc for scannability (#1726)
* Restructure BigQuery Agent Analytics doc for scannability

## Summary

Full restructure of the BigQuery Agent Analytics plugin doc, addressing #1710. Two phases in one PR:

### Phase 1 — Additive tables (no section moves)
- **Captured-events summary table**: 19-row table near the top listing all event types, when they fire, key fields, and corresponding view
- **Configuration reference tables**: Converted bullet list to two 4-column tables (constructor params + BigQueryLoggerConfig)
- **Collapsible DDL**: Production DDL wrapped in `??? example` admonition
- **Conversational Analytics**: Demoted from standalone `##` to `###` under query section

### Phase 2 — Structural reorder
- **Shortened quickstart**: Minimal 3-import example; full example with GCS/OTel/BigQuery tools moved to collapsible block
- **Agent Runtime moved later**: From position 4 (interrupting core narrative) to position 9 (after query recipes)
- **GCS offloading extracted**: From nested `####` under "Event types" to its own `## Storage behavior: GCS offloading`
- **Query recipes regrouped by task**: Debug a run, Monitor cost/performance, Inspect tools/interactions, Analyze multimodal, AI root cause, Conversational Analytics
- **Operations consolidated**: Tracing, Public methods, and Multiprocessing grouped under one `## Operations` section
- **New anchors**: `{#prerequisites}`, `{#configuration-options}`

### New section order
1. Overview + Use cases + Captured events
2. Quickstart (shortened)
3. Prerequisites + IAM
4. Configuration (tables)
5. Schema + Views
6. Event types + payloads
7. Storage behavior: GCS offloading
8. Query recipes (task-grouped)
9. Deploy to Agent Runtime
10. Security + redaction
11. Operations (tracing, methods, multiprocessing)
12. SDK / dashboards
13. Feedback + resources

### Anchors
All 5 existing anchors preserved: `#deploy-agent-runtime`, `#event-types`, `#hitl-events`, `#security-credentials`, `#built-in-redaction`. Added: `#prerequisites`, `#configuration-options`.

## Test plan
- [ ] Quickstart renders with minimal example + collapsible full example
- [ ] Captured-events table renders all 19 rows
- [ ] Config tables render correctly (constructor + BigQueryLoggerConfig)
- [ ] DDL is collapsible
- [ ] GCS offloading section renders correctly as standalone `##`
- [ ] Query recipes show task-based `###` grouping with `####` subsections
- [ ] Agent Runtime section appears after query recipes
- [ ] Operations section groups tracing + public methods + multiprocessing
- [ ] All 7 anchors resolve correctly
- [ ] No broken internal cross-references

* Fix wrapping and formatting

* Fix 404 link to data apps

* Fix placeholder in code sample

* Convert HTML tables to MD tables

* Make table formatting consistent w/ docs

* Use consistent naming for ADK and A2A

* Additional formatting fixes

* Remove unused import; convert quote to admonition

---------

Co-authored-by: Kristopher Overholt <koverholt@google.com>
2026-05-06 12:36:27 -05:00
Shashi-StackOne a503a363a1 docs(integrations/stackone): add search and execute mode (#1735)
Documents mode="search_and_execute" shipped in stackone-adk 0.2.0 on the
StackOne integration page. Adds a new section between "Use with agent" and
"Available tools" with rationale (token overhead, payload limits, selection
accuracy), a runnable Python code sample, and an explanation of the
tool_search/tool_execute flow. Adds four rows to the Plugin parameters
table for mode, search, execute, and timeout.

Code sample verified end-to-end against a real StackOne account on
gemini-flash-latest.
2026-05-06 11:49:50 -05:00
ahmed-3li 012d5c4de9 docs: add Markifact MCP integration (#1720)
* docs: add Markifact MCP integration

Adds the Markifact MCP server (https://api.markifact.com/mcp) as an ADK integration with both Local (mcp-remote OAuth) and Remote (Streamable HTTP + bearer) connection patterns for Python and TypeScript.

* Formatting and edits

* Markifact site is returning an error with our link checker CI

Rejected status code: 429 Too Many Requests (configurable with "accept" option)

* Remove unneeded URL that is also failing link checker

---------

Co-authored-by: Kristopher Overholt <koverholt@google.com>
2026-05-04 12:51:14 -05:00
Kathy Wu adbdcf57f5 Update sign up account type to Google account in express mode docs (#1706) 2026-04-29 08:54:31 -07:00
Kristopher Overholt 5b7e2ddb2a Update integration docs to use gemini-flash-latest model consistently (#1702) 2026-04-28 16:27:12 -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
Sam Brenner 13c442e03c add in datadog integration docs (#1699) 2026-04-28 11:54:54 -05:00