Google Ads API 代理技能

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 堆栈对应的复选框。
  • 在“设置”中：
    1. 依次前往设置 > 自定义 。
    2. 在 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。

后续步骤