Commit Graph

29 Commits

Author SHA1 Message Date
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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
Haiyuan Cao d9541f66ef Update BigQuery Agent Analytics plugin documentation (#1334)
* Update BigQuery Agent Analytics plugin documentation

Updated the documentation for the BigQuery Agent Analytics plugin to reflect changes in version requirements and features. Added details on new functionalities such as Auto Schema Upgrade, Tool Provenance tracking, and HITL Event Tracing.

* Update version requirement to Python 1.21.0

* Change default table name from agent_events_v2 to agent_events

---------

Co-authored-by: Joe Fernandez <joefernandez@users.noreply.github.com>
2026-02-26 08:15:33 -08:00
neal-google 498c2f6fb8 Update bigquery-agent-analytics.md (#1330)
Fixes a link to "Introduction to object tables"

Co-authored-by: Joe Fernandez <joefernandez@users.noreply.github.com>
2026-02-20 14:21:49 -08:00
Haiyuan Cao 6683a5173c Refactor OpenTelemetry setup and event type details (#1323)
Updated OpenTelemetry initialization section and improved event type descriptions.

Co-authored-by: Joe Fernandez <joefernandez@users.noreply.github.com>
2026-02-18 09:29:41 -08:00
Haiyuan Cao dcba3b0422 Add feedback section to BigQuery Agent Analytics (#1314)
Added a feedback section for BigQuery Agent Analytics.
2026-02-13 15:05:29 -08:00
Joe Fernandez e0e6a0d49a fix: formatting problem, clarify warning language (#1286) 2026-02-11 16:57:55 +00:00
Kristopher Overholt 94636546e5 Update integrations assets (#1255) 2026-02-06 13:04:22 -06:00
Haiyuan Cao 0ccc7f3666 Update BigQuery Agent Analytics documentation (#1253)
* Update BigQuery Agent Analytics documentation

Removed catalog metadata and added detailed schema reference for agent events.

* Add catalog metadata to BigQuery Agent Analytics

Added metadata for BigQuery Agent Analytics Plugin.
2026-02-06 10:18:52 -08:00
Joe Fernandez b117fc695b docs: centralize 3P and 1P Integrations content (#1249)
* docs: centralize 3P and 1P Integrations content

- move all content to integrations/
- frontmatter headings for all integration listings

* respond to review comments
2026-02-06 09:30:13 -08:00