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 的使用 Google 构建 集成软件包之一提供。您可以在以下两个位置启用此软件包以获得全局级访问权限：

  • 在新手入门期间：选中 Google Ads API 堆栈对应的复选框。
  • 在“设置”中：
    1. 依次前往设置 > 自定义 。
    2. 在使用 Google 插件构建下，点击自定义，然后点击 Google Ads API 集成对应的下载。

如果您希望获得项目级访问权限，请在项目的目录中运行以下命令：

npx skills add google/skills --agent=antigravity

Claude Code 

claude plugin marketplace add google/skills
claude plugin install google-ads@skills

Codex 

npx skills add google/skills

光标

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

其他智能体

对于支持开放式代理技能标准的其他 AI 助理，您可以使用 NPX 安装技能：

npx skills add google/skills

更新 Google Ads API 智能体技能

您可以通过运行 update 命令来获取所有可用的更新并清理过时的技能：

Antigravity

通过使用 Google 构建 启用的集成由编辑器自动管理和更新。

如果您使用 npx 命令安装了智能体技能，则可以通过运行 update 命令来获取所有可用的更新：

npx skills update --all

Claude Code 

claude plugin update google-ads@skills

Codex 

npx skills update --all

光标 

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-mcp-setup 帮助设置和配置 Google Ads API Model Context Protocol (MCP) 服务器，简化本地环境中的身份验证和配置。
google-ads-api-quickstart 引导您完成以下操作：设置开发环境、配置凭据，以及首次调用 Google Ads API。

后续步骤