Google Ads API 代理技能

Google Ads API 智能体 skill 是可移植、独立的 Google Ads API 特有知识、说明和工作流模块。Google Ads API 智能体 skill 可与支持开放式代理技能标准的 AI 助理搭配使用，包括 Google Antigravity 和 Claude Code。

这些代理技能旨在帮助 AI 助理了解 Google Ads API 最佳实践、配置工具，并以更高的准确性和更低的 token 成本执行工作流。如需查看可用技能的列表，请参阅可用的技能。

开始使用

安装适合您开发环境的智能体 skill。

安装 Google Ads API 智能体 skill

在大多数情况下，您只需使用一个命令即可在您惯用的编辑器中安装 Google Ads API 智能体 skill：

Antigravity

Google Ads API 智能体 skill 包含在 Antigravity 的使用 Google 工具构建集成软件包中。您可以在以下两个位置启用此软件包以实现全局级访问权限：

  • 在新手入门期间：选中 Google Ads API 堆栈对应的复选框。
  • 在“设置”中：
    1. 依次前往设置 > 自定义。
    2. 在 Build with Google Plugins 下，点击 Customize，然后点击 Download 下载 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 智能体 skill。如需了解详情，请参阅光标规则文档。

其他代理

对于支持开放式 Agent Skills 标准的其他 AI 助理，您可以使用 npx（需要 Node.js）安装技能：

npx skills add google/skills

更新 Google Ads API 智能体 skill

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

Antigravity

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

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

npx skills update --all

Claude Code 

claude plugin update google-ads@skills

Codex 

npx skills update --all

光标

npx skills update --all

其他代理

对于支持开放式 Agent Skills 标准的其他 AI 助理，您可以使用 npx 更新所有有效技能：

npx skills update --all

使用 Google Ads API 智能体 skill

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 服务器搭配使用

智能体 skill 旨在为 Google Ads API Model Context Protocol (MCP) 服务器提供补充功能：

  • Google Ads API MCP 服务器：专为 AI 辅助开发工作流而设计，使 AI 助理能够以编程方式与您的 Google Ads API 资源、广告系列和指标进行交互。
  • Google Ads API 智能体 skill：提供提示说明和推荐实践，引导助理通过节省 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。

后续步骤