Data Manager API 代理技能是可移植、独立的 Data Manager API 特有知识、说明和工作流模块。Data Manager API 代理技能可与支持开放代理技能标准的 AI 助理搭配使用，包括 Google Antigravity 和 Claude Code。
这些代理技能旨在帮助 AI 助理了解 Data Manager API 最佳实践、配置工具，并以更高的准确性和更低的 token 成本执行工作流。
可用的技能
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
光标
您可以通过在编辑器的设置中添加技能的 GitHub 代码库端点（例如 https://github.com/google/skills），直接安装 Data Manager API 代理技能。如需了解详情，请参阅 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 助理提供以下组成部分：
- 专业说明：有关如何让 AI 助理执行特定任务（例如设置 API 访问权限、格式化和哈希处理用户数据，以及实现数据提取工作流）的详细指导信息。
- 最佳实践：Data Manager API 团队定义的标准集成建议。
- 参考文档：技能中包含的客户端库设置指南、迁移字段映射和代码示例，可为助理提供准确的最新参考信息。
使用技能的好处
代理技能可按需扩展助理的专业知识，而无需在每次对话中加载大量指令，从而减少开销。
降低了 token 费用
传统 AI 集成通常会预先加载大量文档，这会消耗大量 token 并增加会话费用。代理技能使用渐进式披露来最大限度地减少此开销：
- AI 助理最初只会检查技能的名称和说明，以了解该技能是否与您的请求相关。
- 只有当助理确定您的特定任务需要技能的完整说明和参考信息时，才会将这些内容添加到活动上下文窗口中，从而节省上下文空间。
AI 引导的实现
您可以用自然语言描述您的意图，而无需手动搜索文档。技能可引导 AI 助理帮助您完成 Data Manager API 任务，例如：
- 编写 Python 脚本，使用 Data Manager API 提取 Google Ads 线下转化数据。
- 将此 Google Ads
OfflineUserDataJobService代码（用于目标客户匹配）迁移到 Data Manager API。 - 如何检索 Data Manager API 事件提取请求的处理状态？