Google Ads API 代理技能是可移植、独立的 Google Ads API 特有知识、说明和工作流模块。Google Ads API 代理技能可与支持 开放式代理技能标准 的 AI 助理搭配使用， 包括 Google Antigravity 和 Claude Code。
这些代理技能旨在帮助 AI 助理了解 Google Ads API 最佳实践、配置工具，并以更高的准确性和更低的 token 成本执行工作流程。如需查看可用技能的列表，请参阅 可用的技能。
开始使用
安装适合您的开发环境的代理技能。
安装 Google Ads API 代理技能
在大多数情况下，您只需使用一个命令即可在您惯用的编辑器中安装 Google Ads API 代理技能：
Antigravity
Google Ads API 代理技能作为 Antigravity 的 Build with Google 集成软件包之一提供。您可以在以下两个位置启用此软件包以进行全局级访问：
- 在新手入门期间：选中 Google Ads API 堆栈对应的复选框。
- 在“设置”中：
- 依次前往设置 > 自定义 。
- 在 Build with Google 插件 下，点击自定义 ，然后点击 下载 Google Ads API 集成。
如果您偏好项目级访问权限，请在项目的目录中运行以下命令：
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
Cursor
您可以通过在编辑器的“自定义规则”下的设置中添加技能的 GitHub 代码库端点（例如 https://github.com/google/skills）来直接安装 Google Ads API 代理技能。如需了解详情，请参阅
Cursor 文档中有关从 GitHub 安装技能的内容。
您还可以使用 npx（需要 Node.js）安装技能：
npx skills add google/skills/skills/ads --agent=cursor
其他智能体
对于支持开放式代理技能标准的其他 AI 助理，您可以
使用 npx 安装技能（需要 Node.js）：
npx skills add google/skills/skills/ads
更新 Google Ads API 代理技能
您可以通过运行 update 命令来获取所有可用的更新并清理过时的技能：
Antigravity
通过 Build with Google 启用的集成由编辑器自动管理和更新。
如果您使用 npx 命令安装了代理技能，则可以通过运行 update 命令来获取所有可用的更新：
npx skills update --all
Claude Code
npx skills update --all
Codex
npx skills update --all
Cursor
npx skills update --all
其他智能体
对于支持开放式代理技能标准的其他 AI 助理，您可以使用 npx 更新所有活跃技能：
npx skills update --all
使用 Google Ads API 代理技能
AI 助理旨在只要它们检测到技能的说明与您当前的请求相符，就会自动使用技能。除非您的提示上下文与 Google Ads API 任务匹配，否则全局安装的技能在不相关的项目中将保持休眠状态。
您还可以通过在代理聊天中输入 / 并搜索技能名称来手动调用技能。
技能的核心组件
每个代理技能都是一个专用软件包，可为 AI 助理提供以下组成部分：
- 专用说明：注入到 上下文窗口中的详细提示说明，用于指导助理生成 GAQL 查询、 配置 OAuth 凭据和处理常见错误代码。
- 最佳实践：由 Google Ads API DevRel 团队定义的标准性能、安全性和集成 建议。
- 自动化脚本：技能软件包中包含的可执行脚本（例如用于环境 验证或工作区设置的脚本），用于在本地执行 任务。
使用技能的好处
代理技能可按需为助理扩展专用知识，而无需将大量说明加载到每次对话中，从而减少开销。
降低了 token 费用
传统 AI 集成通常会预先加载大量文档，这会消耗大量 token 并增加会话费用。代理技能使用渐进式披露 来最大限度地减少此开销：
- AI 助理最初只会检查技能的名称和说明，以了解技能是否与您的请求相关。
- 只有当助理确定您的特定任务需要技能的完整说明和参考资料时，才会将这些内容添加到活跃的上下文窗口中，从而节省上下文空间。
AI 引导的实现
您可以用自然语言描述您的意图，而无需手动搜索文档。技能可引导 AI 助理执行以下任务：
- 生成 GAQL 查询，以从我的账号中检索广告系列效果指标。
- 使用客户端库编写 Python 脚本以创建新广告系列。
- 使用 Google Ads API 检索广告系列转化数据和诊断数据。
如需查看可用技能的完整列表，请参阅可用的 技能。
将技能与 Google Ads API MCP 服务器搭配使用
代理技能旨在补充 Google Ads API Model Context Protocol (MCP) 服务器：
- Google Ads API MCP 服务器：专为 AI 辅助开发工作流而设计， 使 AI 助理能够以编程方式与您的 Google Ads API 资源、 广告系列和指标进行交互。
- Google Ads API 代理技能：提供提示说明和推荐 实践，通过节省 token 的逐步披露方式指导助理执行任务。它们会指导代理如何有效地使用 MCP 服务器和客户端库等工具。
可用的技能
Google Ads API 团队提供了一套用于使用 Google Ads API 构建的技能：
| 技能 | 说明 |
|---|---|
google-ads-api-account-diagnostics |
使用 Google Ads API MCP 服务器诊断 Google Ads 账号性能问题，例如转化损失、潜在客户数量低以及因广告评级、出价或预算而错失的展示次数份额。 |
google-ads-api-mcp-setup |
协助设置和配置 Google Ads API Model Context Protocol (MCP) 服务器，简化本地环境中的身份验证和配置。 |
google-ads-api-quickstart |
引导您设置开发环境、配置凭据，并首次调用 Google Ads API。 |