Data Manager API 代理程式技能

Data Manager API 代理程式技能是可攜式獨立模組,包含 Data Manager API 專屬知識、指令和工作流程。Data Manager API 代理程式技能可與支援開放式代理程式技能標準的 AI 助理搭配使用,包括 Google Antigravity 和 Claude Code。

這些代理程式技能的設計宗旨,是協助 AI 助理瞭解 Data Manager API 最佳做法、設定工具,以及執行工作流程,進而提高準確度並降低權杖費用。

可用的技能

Data Manager API 團隊提供一系列技能,協助您使用 Data Manager API 建構內容:

技能 說明
data-manager-api-setup 引導開發人員完成用戶端程式庫安裝和驗證步驟,設定 Data Manager API。
data-manager-api-event-ingestion 協助使用 Data Manager API,為 Google 產品導入事件和轉換擷取功能。
data-manager-api-audience-ingestion 使用 Data Manager API 建立使用者名單及管理目標對象資料,適用於目標顧客比對等用途。

開始使用

安裝適合開發環境的代理程式技能。

安裝 Data Manager API 代理程式技能

在大多數情況下,您只要使用單一指令,就能在偏好的編輯器中安裝 Data Manager API 代理程式技能:

Antigravity

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

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

Claude Code

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

Codex

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

游標

如要直接安裝 Data Manager API 代理程式技能,請在編輯器的自訂規則下,新增技能的 GitHub 存放區端點 (例如 https://github.com/google/skills)。詳情請參閱 Cursor 文件,瞭解如何從 GitHub 安裝技能

你也可以使用 NPX 安裝技能:

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

其他代理程式

如要使用其他支援開放式 Agent Skills 標準的 AI 助理,可以透過 NPX 安裝技能:

npx skills add google/skills/skills/ads

更新 Data Manager API 代理程式技能

執行 update 指令,即可取得所有可用更新,並清理過時的技能:

npx skills update --all

使用 Data Manager API 代理技能

AI 助理的設計宗旨是,只要偵測到技能說明與目前要求相符,就會自動使用技能。除非提示內容符合 Data Manager API 工作,否則全域安裝的技能在不相關的專案中會保持閒置狀態。

您也可以在代理程式對話中手動叫用技能。對於許多智慧音箱,你可以使用 / 鍵開啟已安裝技能的清單。

技能的核心元件

每個代理程式技能都是專門的套件,可為 AI 助理提供下列元件:

  • 專屬指令:詳細說明如何執行特定工作,例如設定 API 存取權、格式化及雜湊處理使用者資料,以及導入擷取工作流程。
  • 最佳做法:由 Data Manager API 團隊定義的標準整合建議。
  • 參考文件:技能中包含用戶端程式庫設定指南、遷移欄位對應和程式碼範例,可為助理提供準確的最新參考資料。

使用技能的好處

代理技能可根據需求,運用專業知識擴充助理的功能,不必在每次對話中載入大量指令,減少額外負擔。

降低權杖成本

傳統的 AI 整合功能通常會預先載入大量文件,這會消耗大量權杖並增加工作階段費用。代理程式技能會使用漸進式揭露,盡量減少這項負擔:

  • AI 助理一開始只會檢查技能的名稱和說明,判斷技能是否與要求相關。
  • 只有在助理判斷需要完整指示和參照才能完成特定工作時,才會將這些資訊加入使用中的脈絡窗口,進而節省脈絡空間。

AI 引導導入

不必手動搜尋文件,只要以自然語言描述意圖,技能可引導 AI 助理協助您處理 Data Manager API 工作,例如:

  • 編寫 Python 指令碼,使用 Data Manager API 匯入 Google Ads 離線轉換。
  • 將目標顧客比對的 Google Ads OfflineUserDataJobService 程式碼遷移至 Data Manager API。
  • 如何擷取 Data Manager API 事件擷取要求的處理狀態?

後續步驟