Google Analytics AI 代理技能

如要建構 Google Analytics 報表和資源管理整合功能，並提高準確度及降低權杖負擔，請為 AI 程式設計代理配備 Google Analytics AI 代理技能。Google Analytics AI 代理技能專為使用 Google Analytics Data API 和 Google Analytics Admin API 建構的開發人員設計，是可攜式、獨立的指令、工作流程和用戶端程式庫參考模組。

這些 AI 代理技能可與支援開放式 Agent Skills 標準的程式設計 AI 代理搭配使用，包括 Google Antigravity、Claude Code、Codex 和 Cursor。如需已發布技能的清單，請參閱「可用技能」。

事前準備

安裝及執行 Google Analytics AI 代理技能前，請先完成下列必要條件：

  • 安裝支援開放式 Agent Skills 標準的 AI 程式碼編寫代理，例如 Google Antigravity、Claude Code、Codex 或 Cursor。
  • 安裝 Node.js，其中包含 npx 指令，可從指令列安裝及更新技能。
  • 建立或選取有權存取 Google Analytics 資源的 專案，以便執行 API 工作流程。

開始使用

在開發環境中安裝、更新及叫用 Google Analytics AI 代理技能。

安裝 Google Analytics AI 代理技能

使用 npx 指令在專案目錄中安裝 Google Analytics 技能套件，或直接設定編輯器：

Antigravity

在專案目錄中執行下列指令：

npx skills add google/skills/skills/analytics --agent=antigravity

Claude Code

在專案目錄中執行下列指令：

npx skills add google/skills/skills/analytics --agent=claude-code

Codex

在專案目錄中執行下列指令：

npx skills add google/skills/skills/analytics --agent=codex

Cursor

在編輯器設定的自訂規則下方，新增技能存放區網址 (https://github.com/google/skills)。如需操作說明，請參閱 Cursor 說明文件，瞭解如何從 GitHub 安裝技能。

或者，您也可以使用 npx 指令，在專案目錄中安裝技能：

npx skills add google/skills/skills/analytics --agent=cursor

其他代理

如要使用其他支援開放式 Agent Skills 標準的 AI 程式設計代理，請在專案目錄中執行下列指令：

npx skills add google/skills/skills/analytics

更新 Google Analytics AI 代理技能

執行下列指令，下載可用的更新並清除過時的技能：

npx skills update --all

使用 Google Analytics AI 代理技能

AI 程式設計代理偵測到技能說明與提示詞相符時，會自動載入技能。除非要求涉及 Google Analytics 工作，否則全域安裝的技能在不相關的專案中會保持休眠狀態。

如要在支援的 AI 程式設計代理中手動叫用技能，請在對話輸入欄位中輸入 / 字元，然後依名稱選取技能。

技能的核心要素

每項 Google Analytics AI 代理技能都會為 AI 程式設計代理提供下列元件：

  • 專門操作說明：逐步引導您使用 gcloud CLI 啟用 Google Analytics API、設定應用程式預設憑證 (ADC)、建構 runReport 查詢，以及檢查欄位相容性。
  • 最佳做法：建議的 API 版本選擇 (v1beta 端點用於一般穩定性，v1alpha 端點用於搶先體驗 Admin API 功能)、強型別要求建構，以及結構定義驗證工作流程。
  • 參考文件：各項技能 references/ 目錄中的 Python、Java、Node.js、PHP、Go、.NET 和 Ruby 語言專屬用戶端程式庫安裝指南和程式碼範例。

AI 代理技能的優點

AI 代理技能可視需要，為 AI 程式設計代理提供專門的 Google Analytics 知識，不必在每次對話中載入大量文件。

降低權杖成本

預先載入完整的 API 參考文件會耗用上下文詞元，並增加工作階段成本。AI 代理技能會使用漸進式揭露，盡可能減少脈絡用量：

  • 啟動時，AI 程式設計代理只會讀取各項技能的名稱和簡短說明，確認技能是否符合提示。
  • 只有在工作需要時，代理才會將完整的 SKILL.md 指令，以及特定語言的參考檔案載入至使用中的脈絡窗口。

AI 引導導入

用自然語言描述目標，安裝的技能會引導 AI 程式設計代理完成 Google Analytics 導入工作，例如：

  • 在我的 專案中啟用 Google Analytics Data API，並編寫 Python 指令碼，依city和date維度查詢activeUsers和sessions指標。
  • 使用 checkCompatibility 方法，檢查 itemName 維度是否與 Google Analytics 資源的 activeUsers 和 totalRevenue 指標相容。
  • 使用 Google Analytics Admin API，在 Node.js 中列出所有可存取的 Google Analytics 帳戶摘要和子資源。
  • 為 Google Analytics 資源設定自訂維度、資料串流和 Measurement Protocol 密鑰。

搭配 Google Analytics MCP 伺服器使用技能

Google Analytics AI 代理技能可與 Google Analytics Model Context Protocol (MCP) 伺服器相輔相成：

  • Google Analytics MCP 伺服器：將 AI 程式設計代理直接連結至即時 Google Analytics 資源，讓代理檢查帳戶摘要、資源詳細資料、自訂維度、自訂指標和即時報表。
  • Google Analytics AI 代理技能：提供節省權杖的操作說明和用戶端程式庫參考資料，引導 AI 程式設計代理啟用 API、設定 ADC 驗證、檢查欄位相容性，以及編寫應用程式程式碼。

可用技能

Google 在 google/skills 存放區中維護下列 Google Analytics AI 代理技能：

技能 說明
google-analytics-data-api-basics 使用 gcloud CLI 啟用 Google Analytics Data API (analyticsdata.googleapis.com)，以 analytics.readonly OAuth 2.0 範圍設定 ADC，並安裝官方 v1beta 用戶端程式庫 (Python、Java、PHP、Node.js、Go、.NET 和 Ruby)。引導代理建構 runReport 查詢，並使用 getMetadata 和 checkCompatibility 方法檢查欄位相容性。
google-analytics-admin-api-basics 使用 gcloud CLI 啟用 Google Analytics Admin API (analyticsadmin.googleapis.com)，並以 analytics.readonly 和 analytics.edit OAuth 2.0 範圍設定 ADC，以及安裝官方 v1beta 和 v1alpha 用戶端程式庫 (Python、Java、PHP、Node.js、Go、.NET 和 Ruby)。引導代理列出帳戶摘要，以及管理資源、資料串流、自訂維度、自訂指標、重要事件、Measurement Protocol 密鑰和產品連結。

後續步驟