Skip to content
Development
Agent

bigquery-agent-analytics

**ADK Python projects only. Opt-in.** Enable with `--bq-analytics` at scaffold time, or add manually to `app/agent.py`.

From plugin
google-agents-cli
5.9k28 skills28 agents
Install
$ npx -y skills add google/agents-cli --agent claude-code

How it fires

How this agent gets triggered: by you, by Claude, or both.

  • Fires itselfAuto-invocation. Claude auto-loads it when your prompt matches the work.Auto-invocation is when the right skill fires by itself at the right moment, driven by a FLOW.md router and a hook, instead of you invoking it by name. It is the difference between a skill being installed and a skill actually getting used.Read the full definition →
  • You can call itInvoke it directly when you want it.

Context preview

The summary Claude sees to decide when to auto-load this agent.

**ADK Python projects only. Opt-in.** Enable with `--bq-analytics` at scaffold time, or add manually to `app/agent.py`.

Agent definition

bigquery-agent-analytics.md

BigQuery Agent Analytics Plugin

> **ADK Python projects only. Opt-in.** Enable with `--bq-analytics` at scaffold time, or add manually to `app/agent.py`.

An optional ADK plugin that logs structured agent events directly to BigQuery via the Storage Write API. Enables:

  • **Conversational analytics** — session flows, user interaction patterns
  • **LLM-as-judge evals** — structured data for evaluation pipelines
  • **Custom dashboards** — Looker Studio integration
  • **Tool provenance tracking** — LOCAL, MCP, SUB_AGENT, A2A, TRANSFER_AGENT

Enabling

| Method | How | |--------|-----| | **At scaffold time** | `agents-cli scaffold create <project-name> --bq-analytics` | | **Post-scaffold** | Add the plugin manually to `app/agent.py` (see [ADK docs](https://adk.dev/integrations/bigquery-agent-analytics/index.md)) |

Infrastructure (BigQuery dataset, GCS offloading) is provisioned automatically by Terraform when enabled at scaffold time.

Key Features

  • Auto-schema upgrade (new fields added without migration)
  • GCS offloading for multimodal content (images, audio)
  • Distributed tracing via OpenTelemetry span context
  • SQL-queryable event log for all agent interactions

For full schema, SQL query examples, and Looker Studio setup, fetch `https://adk.dev/integrations/bigquery-agent-analytics/index.md`.

Ships withgoogle-agents-cli

The CLI and skills that turn any coding assistant into an expert at creating, evaluating, and deploying AI agents on Google Cloud.

Get the whole plugin

Other agents on google-agents-cli.