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 的 Built 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

光标

您可以直接安装 Google Ads API 智能体技能，方法是在编辑器的设置中，在自定义规则下添加技能的 GitHub 代码库端点（例如 https://github.com/google/skills）。如需了解详情，请参阅有关从 GitHub 安装技能的 Cursor 文档。

您还可以使用 npx 安装技能（需要 Node.js）：

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

其他智能体

对于支持开放式 Agent Skills 标准的其他 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

光标

npx skills update --all

其他智能体

对于支持开放 Agent Skills 标准的其他 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。

后续步骤