Commit Graph

123 Commits

Author SHA1 Message Date
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
shiva-guntoju-09 511376abdc docs(integrations): add Cisco AI Defense integration page (#1672)
* docs(integrations): add Cisco AI Defense integration page

Add documentation for the Cisco AI Defense plugin for Google ADK,
providing runtime LLM and MCP tool inspection with monitor and enforce
modes. Includes logo asset and code examples for both plugin and
callback approaches.

Resolves #1665

Made-with: Cursor

* Formatting and copy edits

---------

Co-authored-by: Kristopher Overholt <koverholt@google.com>
2026-04-27 17:36:53 -05:00
Kristopher Overholt 0942b60c15 Update Java ADK dependency versions to 1.2.0 (#1691) 2026-04-27 13:31:29 -05:00
Hai-Yuan Cao e156364b54 Close code-doc parity gaps for BigQuery Agent Analytics plugin (#1689)
- Add A2A_INTERACTION event type, view (v_a2a_interaction), and docs section
- Add TRANSFER_A2A tool origin to provenance table
- Add cache_metadata, usage_cached_tokens, context_cache_hit_rate to
  v_llm_response view columns
- Document all BigQueryAgentAnalyticsPlugin constructor parameters
  including the credentials parameter for non-ADC auth
- Add multiprocessing/fork safety guidance (spawn recommendation,
  Gunicorn patterns)
- Update auto-created view count from 15 to 16

Reviewed against adk-python@7de5bc5 (2026-04-25).
2026-04-27 13:08:55 -05:00
Kathy Wu 32b773f3f6 Add agent registry integration docs (#1477)
* Add agent registry integration docs

* LInk fixs for agent-registry.md

remove "/adk-docs/" prefixes

* Add auth samples

* Add optional dependencies to agent registry docs

* Updates and formatting

---------

Co-authored-by: Joe Fernandez <joefernandez@users.noreply.github.com>
Co-authored-by: Kristopher Overholt <koverholt@google.com>
2026-04-22 05:40:16 -07:00
Kristopher Overholt 1214ad915a Update product names in docs (#1673)
* Update names in docs

* Update names in docs

* Code formatting

* Format notebooks

* Update names in docs

* Update names in docs

* Update names in code samples

* Update names in docs

* Update names in docs

* Update names in docs

* Update names in docs

* Update names in docs

* Update names in docs

* Update names in docs

* Update names in docs

* Update icon

* Update names in docs

* Update names in docs
2026-04-22 05:10:38 -07:00
Kristopher Overholt 9c8e4daecc docs(integrations): add database memory service page (#1664)
* docs(integrations): add database memory service page

* Fix broken links on n8n integration page
2026-04-21 01:19:00 -07:00
Anmol Jaiswal ae4ecf456b docs(integrations): add Database Memory Service (#1662)
* docs(integrations): add Database Memory Service

Add a new integration entry for adk-database-memory, a drop-in durable
BaseMemoryService for the Python ADK backed by any async SQLAlchemy
dialect (SQLite, PostgreSQL, MySQL/MariaDB).

Repo: https://github.com/anmolg1997/adk-database-memory
Package: adk-database-memory on PyPI (Apache 2.0)

This fills the gap between InMemoryMemoryService (ephemeral, for dev)
and VertexAiMemoryBankService (managed GCP) for self-hosted durable
memory on the database the user already runs.

* Update formatting and wording

---------

Co-authored-by: Kristopher Overholt <koverholt@google.com>
2026-04-21 01:00:33 -07:00
Pat Sukprasert 1b35d1482a docs: add MLflow AI Gateway model provider page (#1661)
* docs: add MLflow AI Gateway model provider page

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

* docs: add Create Endpoint screenshot

* docs: move MLflow AI Gateway to integrations section

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

* Remove nav entry for integrations

* Additional cleanup / redirects / renames

* Additional edits

---------

Co-authored-by: Kristopher Overholt <koverholt@google.com>
2026-04-20 18:37:35 -07:00
Drew Hoskins 63a9a5264f Doc Temporal support for adk web (#1659)
* Doc Temporal support for

* Formatting

---------

Co-authored-by: Kristopher Overholt <koverholt@google.com>
2026-04-17 17:25:38 -05:00
Kristopher Overholt fb0c030110 Switch link checkers (#1646)
* Switch link checker CI job

* Update

* Updates

* Update config

* Switch images to MD image syntax

* Update timeout settings

* Fix tools links

* Update links

* Update index files in config

* Fix more links

* Fix link; add ignores

* Fix more links

* Fix more links
2026-04-17 13:05:08 -07:00
Meet Modi 575fadc788 docs: add model tiers, call transfer, voicemail to AgentPhone tools (#1656) 2026-04-17 14:45:51 -05:00
Anubhav Dhawan 3ae3563f05 docs: Update toolbox links to the new docsite URL (#1572)
* docs: Update toolbox links to the new docsite URL

* docs: Update repo URL

* docs: Fix broken links
2026-04-15 16:22:11 -05:00
Haiyuan Cao 7d943aa6ab Clarify usage of BigQuery Agent Analytics SDK (#1644)
Updated the section on consuming logged data to clarify the use of the BigQuery Agent Analytics SDK and its example notebook for visualizing performance data.
2026-04-15 13:12:00 -05:00
Haiyuan Cao 9df5ed7719 Revise BigQuery Agent Analytics documentation (#1637)
Updated documentation for the BigQuery Agent Analytics plugin, removing outdated preview release information and adding links to the SDK and dashboard notebook.

Co-authored-by: Kristopher Overholt <koverholt@google.com>
2026-04-15 09:37:56 -05:00
Muhammad Asif b9db17f410 Update Python virtual environment command to python3 (#1585)
* Update Python virtual environment command to python3

* Use python3 command consistently across all documentation

---------

Co-authored-by: Kristopher Overholt <koverholt@google.com>
2026-04-13 10:12:12 -05:00
Abhilash Mekala a3fcc9062f Add Adspirer to integrations (#1559)
* Add Adspirer advertising MCP server to integrations

Adds Adspirer, an AI-powered advertising MCP server with 100+ tools
across Google Ads, Meta Ads, LinkedIn Ads, and TikTok Ads.

Closes #1558

* Address review feedback: repo link, generic free tier copy, gemini-2.5-pro model

---------

Co-authored-by: Kristopher Overholt <koverholt@google.com>
2026-04-13 09:40:01 -05:00
Haiyuan Cao ecedbc8523 Enhance BigQueryAgentAnalyticsPlugin documentation (#1631)
* Enhance BigQueryAgentAnalyticsPlugin documentation

Updated documentation for BigQueryAgentAnalyticsPlugin configuration options, including new parameters for retry configuration and session metadata logging.

* Add view_prefix option to BigQuery Agent documentation

Updated documentation for BigQuery Agent Analytics plugin to include details about the new `view_prefix` configuration option and its impact on view naming conventions.

* Fix formatting and redaction notes in documentation

---------

Co-authored-by: Kristopher Overholt <koverholt@google.com>
2026-04-13 09:35:26 -05:00
Meet Modi 2b57e3c864 docs: update AgentPhone MCP tools to match current server (#1628) 2026-04-13 08:53:43 -05:00
Joe Fernandez 60f388b81d docs: add note about Gemini latest selector (#1622)
* docs: add note about Gemini latest selector

* Update google-gemini.md

* Update bigquery-agent-analytics.md
2026-04-10 00:57:04 +00:00
Ganesh, Mohan f7d382c5a6 Integration: Add page for session persistence using Firestore for ADK Java (#1563)
* Google Firestore: implement agent demonstrating session persistence using Firestore database for java adk

* Update docs/integrations/firestore-session-service.md

* Update docs/integrations/firestore-session-service.md

* Update docs/integrations/firestore-session-service.md

---------

Co-authored-by: Kristopher Overholt <koverholt@google.com>
2026-04-09 18:54:39 -05:00
Joe Fernandez 062028d536 docs: add EnvironmentToolset and LocalEnvironment integration page (#1620)
* docs: add EnvironmentToolset and LocalEnvironment integration page

* review updates

* respond to review comments
2026-04-09 15:33:43 -07:00
Joe Fernandez f7ed80bbc6 docs: Update Gemini flash names (#1594)
* docs: home page

* updates based on feedback

* respond to review feedback

* docs: update gemini selector strings to "flash-latest"

* Update homepage.css
2026-04-09 16:14:27 -05:00
Meet Modi 9b5eedf643 docs: add AgentPhone telephony integration (#1574)
Add AgentPhone as the first telephony integration for ADK. AgentPhone
gives agents the ability to make/receive phone calls, send/receive SMS,
manage phone numbers, and create autonomous AI voice agents.

Includes Python and TypeScript examples for both local stdio and remote
HTTP MCP server modes, with all 26 available tools documented.

Co-authored-by: Kristopher Overholt <koverholt@google.com>
2026-04-08 13:32:56 -05:00
Haiyuan Cao b55aa2c28a Update BigQuery Agent Analytics documentation (#1555)
* Update BigQuery Agent Analytics documentation

Updated file paths and added environment variable descriptions for BigQuery Agent Analytics plugin. Included deployment instructions and security best practices.

* Update bigquery-agent-analytics.md

---------

Co-authored-by: Joe Fernandez <joefernandez@users.noreply.github.com>
2026-04-06 15:34:24 -07:00
Nan Yu e53179e1a9 fix(docs): correct A2UI pip package name to a2ui-agent-sdk (#1541)
The A2UI Python SDK is published on PyPI as `a2ui-agent-sdk`, not `a2ui`.
Fixes the install command and the PyPI link in the resources section.

Co-authored-by: alan blount <alan@zeroasterisk.com>
2026-04-01 14:12:05 -07:00
Kristopher Overholt 5c97132648 Remove evaluation tag, use observability tag (#1539) 2026-04-01 12:52:36 -05:00
Kristopher Overholt 58f3aaebca Replace documentation URLs and paths for adk.dev migration (#1536)
* Replace google.github.io/adk-docs URLs and /adk-docs/ paths with adk.dev

Migrate all hardcoded documentation references to use the new custom
domain. Update root-relative links to remove the /adk-docs/ subpath
prefix since the site will be served from the root of adk.dev.

* Additional fixes
2026-04-01 12:48:27 -05:00
Toni Klopfenstein ab077f884b Updating Cloud Trace with Go snippets (#1511)
* updating cloud-trace docs for Go

* Adding Go code snippets/info to Cloud Trace docs

* Update cloud-trace.md

---------

Co-authored-by: Joe Fernandez <joefernandez@users.noreply.github.com>
2026-03-30 20:13:47 +00:00
Shobhit Singh cc745a79af docs: update BigQuery tools and their supported auth mechanisms (#1484)
* docs: update BigQuery integration documentation with missing tools and authentication details

* docs: add External Auth and Interactive Auth sections to BigQuery documentation

* docs: add Sample Code header and mention ADC usage

* docs: rephrase headers in BigQuery documentation

* docs: rename External Auth headers for clarity

* docs: rephrase External Auth Token description for clarity

* docs: rename External Auth Token to External Access Token

* docs: note that interactive auth works locally and on Cloud Run

* Update bigquery.md

---------

Co-authored-by: Joe Fernandez <joefernandez@users.noreply.github.com>
2026-03-26 15:19:19 +00:00
joefspiro 7a06002911 Adds the Google Developer Knowledge MCP server. (#1497)
* Adds the Google Developer Knowledge MCP server.

* Edits for formatting and consistency

* Update StreamableHTTPConnectionParams across integration docs

---------

Co-authored-by: Kristopher Overholt <koverholt@google.com>
2026-03-25 22:23:01 +00:00
Kristopher Overholt bd6d992361 Integrations: Add Resilience tag and clean up catalog tags (#1485)
* Add durability tag and clean up integration catalog tags

* Fix for tags with multiple words

* Update tag name to Durable Execution

* Change tag name to Resilience
2026-03-25 12:24:02 -05:00
shyam-cb 50732c99da feat: add Couchbase MCP tool integration documentation and its corresponding asset. (#1475) 2026-03-25 04:23:51 +00:00
Aryan Sharma 4cd8b1f9ea Add LangWatch observability integration (#1459)
* Add LangWatch observability integration

* Formatting and minor edits

---------

Co-authored-by: Kristopher Overholt <koverholt@google.com>
2026-03-24 14:28:26 -05:00
alan blount 1d00d3739b docs: add A2UI (Agent-to-UI) integration page (#1471)
* docs: add A2UI integration page

Add documentation for the A2UI (Agent-to-UI) protocol integration with ADK.
Covers schema manager setup, system prompt generation, validation, streaming,
dynamic catalogs, custom catalogs, multi-agent orchestration, and sample agents.

References the A2UI Python SDK agent development guide.

* refine: simplify A2UI intro, transport-agnostic, add admonition

- Remove A2A-specific framing — A2UI works with A2A, MCP, REST, WebSockets
- Simpler intro: agent outputs JSON, renderer turns it into UI
- Add info admonition linking to a2ui.org
- Remove comparison table (redundant with the intro)

* update: v0.9, gemini-flash-latest, catalog cross-reference

- Update all code examples from v0.8 to v0.9
- Update model from gemini-2.0-flash to gemini-flash-latest
- Add cross-reference in catalog tip to custom catalogs and advanced patterns

* address review: remove hardcoded version, add auto-detect note

Per nan-yu's feedback: schema manager will auto-detect A2UI version
from client requests. Removed hardcoded VERSION_0_9 from examples,
added note explaining auto-detection with explicit override option.

* fix: use official A2UI logo SVG from google/A2UI repo

Replace hallucinated favicon PNG with the real A2UI_dark.svg
from https://github.com/google/A2UI/blob/main/docs/assets/A2UI_dark.svg
2026-03-24 17:11:36 +00:00
Toni Klopfenstein b45a2e7701 docs: adding Go plugins code snippets (#1437)
* Adding Go plugins code snippets

* updating language tags on plugins/index.md

* Update reflect-and-retry.md

* Update index.md

---------

Co-authored-by: Joe Fernandez <joefernandez@users.noreply.github.com>
2026-03-24 09:15:29 -07:00
Drew Hoskins ba7e0010a6 Add Temporal plugin to integrations (#1331)
* Add Temporal plugin to integrations

* Feedback

* Fix up package inclusions and address other feedback

* Rename plugin

* Add summaries to Agents for better display in Temporal UI

* more realistic sample, consolidate into one sample, minor fixups

* Tim feedback

* Code sample and formatting fixes

---------

Co-authored-by: Kristopher Overholt <koverholt@google.com>
2026-03-23 12:06:36 -05:00
Joe Fernandez 4849e6a907 docs: adk2 update (#1457)
* docs: adk2 update

* Update index.md

* Update index.md

* Update data-handling.md
2026-03-18 09:31:44 -07:00
Haiyuan Cao 8d8a78b23c Revise title and description for root cause analysis (#1408)
* Revise title and description for root cause analysis

Updated section title for AI-Powered Root Cause Analysis and added description.

* Update section headers for advanced analysis queries

* Update bigquery-agent-analytics.md

removed numbers from heading to avoid confusion that these examples are meant to be executed in order

---------

Co-authored-by: Joe Fernandez <joefernandez@users.noreply.github.com>
2026-03-16 23:47:35 +00:00
Haiyuan Cao 0e4b91a90d Update documentation for BigQuery Agent Analytics Plugin (#1399)
Added details about the new feature for automatic view creation and updated the documentation to reflect changes in version 1.27.0.

Co-authored-by: Joe Fernandez <joefernandez@users.noreply.github.com>
2026-03-06 22:31:19 +00:00
An Nguyen 6ae3c9d062 docs: Add cluster-related tools to Bigtable integration docs (#1396) 2026-03-06 22:30:01 +00:00
Anaisdg 77f33ed6ca docs: add galileo observability example (#1137)
Co-authored-by: Anaisdg <anais@galileo.ai>
2026-03-05 21:41:39 -06:00
Shruti Nair 2d10b0d9bf Enhance GKE Code Executor documentation to support new executor type. (#1385)
Added detailed explanation of execution modes and parameters for GKE Code Executor.
2026-03-04 10:10:43 -08:00
Kristopher Overholt 07f7381c8d Update ADK TS MCP integrations to use transportOptions instead of deprecated header (#1343)
Co-authored-by: Joe Fernandez <joefernandez@users.noreply.github.com>
2026-02-26 10:29:54 -06:00