{"full_name":"google/adk-go","owner":"google","name":"adk-go","shard":"1","url":"https://github.com/google/adk-go","description":"An open-source, code-first Go toolkit for building, evaluating, and deploying sophisticated AI agents with flexibility and control.","homepage":"https://google.github.io/adk-docs/","topics":["a2a","agents","agents-sdk","ai","aiagentframework","gemini","genai","go","llm","mcp","multi-agent-collaboration","multi-agent-systems","sdk","vertex-ai"],"tag_pages":["a2a","agents","ai","gemini","genai","go","llm","mcp","multi-agent-systems","sdk","vertex-ai"],"language":"Go","license":"Apache-2.0","avatar":"https://avatars.githubusercontent.com/u/1342004?v=4","created_at":"2025-05-05T17:16:26Z","pushed_at":"2026-11-15T17:51:55Z","metrics":{"stars":8964,"forks":1001,"watchers":88,"issues":565,"prs":1723,"releases":27,"issues_open":161,"issues_closed":404,"prs_open":134,"prs_closed":415,"prs_merged":1174,"discussions":32},"growth":{"day":{"stars":1,"forks":2,"base_day":"2026-11-15"}},"history":{"dates":["2026-11-10","2026-11-11","2026-11-12","2026-11-13","2026-11-14","2026-11-15","2026-11-16"],"stars":[8960,8961,8963,8963,8963,8963,8964],"forks":[998,1000,1001,1001,998,999,1001],"watchers":[null,88,88,88,88,88,88],"issues_open":[null,146,146,150,153,156,161],"prs_open":[null,118,122,123,127,131,134]},"boards":{},"same_owner":[{"full_name":"google/EarlGrey","name":"EarlGrey","shard":"1","boards":{}},{"full_name":"google/ExoPlayer","name":"ExoPlayer","shard":"1","boards":{}},{"full_name":"google/WebFundamentals","name":"WebFundamentals","shard":"1","boards":{}},{"full_name":"google/agents-cli","name":"agents-cli","shard":"1","boards":{}},{"full_name":"google/artemis","name":"artemis","shard":"1","boards":{"daily_watchers":169}},{"full_name":"google/ax","name":"ax","shard":"1","boards":{}},{"full_name":"google/bbr","name":"bbr","shard":"1","boards":{}},{"full_name":"google/bigframes","name":"bigframes","shard":"1","boards":{}},{"full_name":"google/bloaty","name":"bloaty","shard":"1","boards":{}},{"full_name":"google/cadvisor","name":"cadvisor","shard":"1","boards":{}},{"full_name":"google/clasp","name":"clasp","shard":"1","boards":{}},{"full_name":"google/clusterfuzz","name":"clusterfuzz","shard":"1","boards":{}},{"full_name":"google/elephant-goldfish-model","name":"elephant-goldfish-model","shard":"1","boards":{"daily":31,"weekly":24,"monthly":133,"daily_rate":42,"weekly_rate":50,"monthly_rate":120,"daily_forks":69,"daily_watchers":44,"new":18}},{"full_name":"google/flatbuffers","name":"flatbuffers","shard":"1","boards":{}},{"full_name":"google/flexbox-layout","name":"flexbox-layout","shard":"1","boards":{}},{"full_name":"google/flutter-mediapipe","name":"flutter-mediapipe","shard":"1","boards":{}},{"full_name":"google/fonts","name":"fonts","shard":"1","boards":{}},{"full_name":"google/gemma_pytorch","name":"gemma_pytorch","shard":"1","boards":{}},{"full_name":"google/go-cloud","name":"go-cloud","shard":"1","boards":{}},{"full_name":"google/googletest","name":"googletest","shard":"1","boards":{"daily_watchers":76,"debut":44}}],"issues":[{"number":540,"title":"When will skills be supported?","comments":15,"created_at":"2026-02-07T19:30:02Z"},{"number":225,"title":"When is the plan to support the Claude model?","comments":15,"created_at":"2025-11-07T03:17:43Z"},{"number":1819,"title":"llminternal: a live connection that drops while a tool runs ends the session or loses the tool response","comments":11,"created_at":"2026-10-13T02:44:11Z"},{"number":1928,"title":"session/database: first AppendEvent after Create fails with \"stale session error\" on MySQL","comments":8,"created_at":"2026-10-21T13:10:29Z"},{"number":343,"title":"Session Time Travel and Forking","comments":8,"created_at":"2025-11-22T22:00:50Z"},{"number":326,"title":"Deleting State Keys does not seem possible today","comments":7,"created_at":"2025-11-20T07:04:43Z"},{"number":2116,"title":"adkrest: /debug/trace/session/{session_id} merges traces from every user and app with that session ID","comments":6,"created_at":"2026-11-03T03:26:24Z"},{"number":1873,"title":"load_artifacts: a failed artifact load aborts the whole run instead of going back to the model","comments":6,"created_at":"2026-10-16T11:00:38Z"}],"discussions":[{"number":2327,"title":"Declarative YAML agent systems with CEL routing for ADK Go","comments":0,"category":"Ideas","created_at":"2026-11-14T11:01:51Z"},{"number":2166,"title":"CI Failing","comments":0,"category":"General","created_at":"2026-11-06T15:46:05Z"},{"number":1718,"title":"Per-run dollar budget for ADK Go agents on openaimodel (context + RoundTripper)","comments":0,"category":"Show and tell","created_at":"2026-10-03T20:20:36Z"},{"number":1255,"title":"Support for metadata propagation in MCP tool calls","comments":1,"category":"Q&A","created_at":"2026-08-05T16:12:28Z"},{"number":1243,"title":"Agent Only MCP with ADK Go: reusable verified debugging memory","comments":0,"category":"Show and tell","created_at":"2026-08-03T10:25:05Z"},{"number":1190,"title":"Proposal: Production-ready Security & Compliance Layer for ADK (AEGIS)","comments":0,"category":"Ideas","created_at":"2026-07-22T14:40:02Z"},{"number":1112,"title":"v2.0.0","comments":2,"category":"Announcements","created_at":"2026-06-30T14:24:36Z"},{"number":1078,"title":"ADK Go Community repo","comments":0,"category":"General","created_at":"2026-06-23T04:37:43Z"}],"latest_release":{"name":"plugin/agentanalytics v0.1.0","tag":"plugin/agentanalytics/v0.1.0","published_at":"2026-11-05T11:47:38Z","body":"The first release of the BigQuery Agent Analytics plugin for ADK Go. It logs every agent run to a BigQuery table, so you can query and dashboard agent behavior with SQL: invocations, model requests and responses, tool calls, state changes, agent transfers and human-in-the-loop requests.\r\n\r\nThe table schema, event type names and analytics views match adk-python's BigQuery Agent Analytics plugin, so Go and Python agents can write to the same table and be queried together.\r\n\r\n## Install\r\n\r\n```bash\r\ngo get google.golang.org/adk/plugin/agentanalytics@v0.1.0\r\n```\r\n\r\nRequires `google.golang.org/adk/v2` v2.0.0 or later.\r\n\r\n## Quick start\r\n\r\n```go\r\nanalytics, err := agentanalytics.NewBigQueryAgentAnalyticsPlugin(ctx, \"my-project\", \"agent_analytics\", \"agent_events\")\r\nif err != nil {\r\n\tlog.Fatal(err)\r\n}\r\ndefer analytics.Close() // flushes queued rows to BigQuery\r\n\r\nr, err := runner.New(runner.Config{\r\n\tAppName:        \"my-app\",\r\n\tAgent:          myAgent,\r\n\tSessionService: session.InMemoryService(),\r\n\tPluginConfig:   runner.PluginConfig{Plugins: []*plugin.Plugin{analytics}},\r\n})\r\n```\r\n\r\nCall `Close` before the process exits, so that rows still in the queue are written.\r\n\r\n## What's included\r\n\r\n- **Ready to query out of the box.** The plugin creates the events table if it is missing, adds new columns to an existing table, and creates 25 per-event views such as `v_llm_request` and `v_tool_completed`.\r\n- **Batched, non-blocking writes** through the BigQuery Storage Write API, 100 rows or 1 second per batch by default. Batches over 8 MiB are split so that a single large batch is not rejected as a whole.\r\n- **Redaction on by default.** Values under keys like `api_key`, `password` and `token`, credentials in URLs, and `Authorization`, `Bearer` and `Basic` credentials are replaced with `[REDACTED]`. Text values longer than 512,000 characters are truncated unless `CaptureFullMessageContent` is set.\r\n- **Control over what is logged:** event allow and deny lists, a payload column deny list, a `ContentFormatter` hook to transform or redact payloads before they are written, custom tags, and an allow list for `CustomMetadata` keys.\r\n- **Cloud Storage offload** (optional). Set `GCSBucketName` to store large text and binary parts in a bucket and keep a reference in the row.\r\n- **Exactly-once delivery** (optional). `ExactlyOnceDelivery` writes through a committed stream with explicit offsets, so retries do not write rows twice.\r\n- **Drop counters.** `DropStats` reports rows lost to a full queue, failed writes or shutdown.\r\n- **OpenTelemetry correlation** (optional). `EnableOTelCorrelation` adds the current trace and span IDs to each row.\r\n\r\nSee the [package documentation](https://pkg.go.dev/google.golang.org/adk/plugin/agentanalytics) for every option.\r\n\r\n## Before you use it\r\n\r\n- **This is a pre-1.0 release.** The exported API may still change before v1.0.0, including helpers such as `BatchProcessor`, `FormatContentParts`, `SmartTruncate` and `ArrowSchema`. The path to v1.0.0 is tracked in #2014.\r\n- **Register it before plugins that replace results.** ADK stops at the first plugin callback that returns a replacement event, model response or tool result, so the analytics plugin does not see what an earlier plugin replaced.\r\n- **Known differences from adk-python** are listed in #2046 and #2047. For example, when a callback recovers a failed tool call, Go logs `TOOL_ERROR` followed by `TOOL_COMPLETED`, while Python logs only `TOOL_ERROR`.\r\n","is_prerelease":false},"readme":true,"readme_zh":false,"news":[],"stale":false,"snapshot_at":"2026-11-16T09:23:14Z","history_start":"2026-09-06"}