使用 AI 辅助编程¶

Agent Platform 中的 Agents CLI：用于 ADK 开发的命令行工具和编码技能。
ADK 文档 MCP 服务器：通过 MCP 服务器将你的编码工具连接到 ADK 文档。
ADK 文档索引：遵循 llms.txt 标准的机器可读文档文件。

agents-cli¶

Agent Platform 中的 Agents CLI 是用于 ADK 开发的命令行工具。它提供脚手架命令、部署工具和开发技能，可与任何兼容的编码助手一起使用，包括 Gemini CLI、Antigravity、Claude Code 和 Cursor。

要安装 Agents CLI 并设置 ADK 开发技能：

uvx google-agents-cli setup

这将同时安装 CLI 和编码技能。浏览 Agents CLI 文档了解更多详情。

CLI 命令¶

命令	描述
`agents-cli scaffold create`	创建一个新的 ADK 智能体项目
`agents-cli scaffold enhance`	向现有项目添加部署
`agents-cli eval`	运行智能体评估
`agents-cli deploy`	部署到 Agent Runtime、Cloud Run 或 GKE
`agents-cli publish`	发布到 Gemini Enterprise

开发技能¶

设置完成后，你的编码工具中可以使用以下技能：

技能	描述
`google-agents-cli-workflow`	开发生命周期和编码指南
`google-agents-cli-adk-code`	Python API 快速参考和文档索引
`google-agents-cli-scaffold`	项目脚手架
`google-agents-cli-eval`	评估方法和评分
`google-agents-cli-deploy`	Agent Runtime、Cloud Run 和 GKE 部署
`google-agents-cli-publish`	Gemini Enterprise 注册
`google-agents-cli-observability`	追踪、日志记录和集成

ADK 文档 MCP 服务器¶

你可以配置你的编程工具，使用 MCP 服务器来搜索和深度阅读 ADK 文档。以下是常用工具的配置指南。

Gemini CLI¶

要将 ADK 文档扩展添加到 Gemini CLI，请运行：

gemini extensions install https://github.com/derailed-dash/adk-docs-ext

Antigravity¶

要在 Antigravity 中启用 ADK 文档（需要安装 uv）：

通过编辑器智能体面板顶部的 ...（更多）菜单打开 MCP 商店。
点击 Manage MCP Servers，然后选择 View raw config。

将以下配置添加到 mcp_config.json：

{
  "mcpServers": {
    "adk-docs-mcp": {
      "command": "uvx",
      "args": [
        "--from",
        "mcpdoc",
        "mcpdoc",
        "--urls",
        "AgentDevelopmentKit:https://adk.dev/llms.txt",
        "--transport",
        "stdio"
      ]
    }
  }
}

Claude Code¶

要为 Claude Code 添加 ADK 知识库：

claude mcp add adk-docs --transport stdio -- uvx --from mcpdoc mcpdoc --urls AgentDevelopmentKit:https://adk.dev/llms.txt --transport stdio

Cursor¶

要在 Cursor 中集成 ADK 文档（需要安装 uv）：

进入 Cursor Settings，导航到 Tools & MCP 选项卡。
点击 New MCP Server，系统将打开 mcp.json 配置文件。

添加以下配置：

{
  "mcpServers": {
    "adk-docs-mcp": {
      "command": "uvx",
      "args": [
        "--from",
        "mcpdoc",
        "mcpdoc",
        "--urls",
        "AgentDevelopmentKit:https://adk.dev/llms.txt",
        "--transport",
        "stdio"
      ]
    }
  }
}

其他工具¶

任何支持 MCP 协议的编程工具均可应用上述配置。请根据你工具的 MCP 设置方式，参考 Antigravity 或 Cursor 的 JSON 示例进行调整。

ADK 文档索引¶

ADK 文档提供了符合 llms.txt 规范的机器可读文件。这些文件会随文档更新实时同步生成的。

文件名称	描述	访问地址 (URL)
`llms.txt`	包含所有核心链接的文档索引。	`adk.dev/llms.txt`
`llms-full.txt`	单个文件中的全量技术文档内容。	`adk.dev/llms-full.txt`