Skip to content

使用 AI 编程

智能体开发工具包 (ADK) 文档支持 /llms.txt 标准,提供针对大语言模型 (LLM) 优化的机器可读文档索引。这使你能够在 AI 驱动的开发环境中轻松使用 ADK 文档作为上下文。

什么是 llms.txt?

llms.txt 是一个标准化文本文件,作为 LLM 的地图,列出最重要的文档页面及其描述。这有助于 AI 工具理解 ADK 文档的结构并检索相关信息以回答你的问题。

ADK 文档提供以下在每次更新时自动生成的文件:

文件 最适合... URL
llms.txt 可以动态获取链接的工具 https://adk.wiki/llms.txt
llms-full.txt 需要整个站点单一静态文本转储的工具 https://adk.wiki/llms-full.txt

在开发工具中的使用

你可以使用这些文件为你的 AI 编程助手提供 ADK 知识。此功能允许你的智能体在规划任务和生成代码时自主搜索和阅读 ADK 文档。

Gemini CLI

Gemini CLI 可以配置为使用 ADK 文档扩展 查询 ADK 文档。

安装:

要安装扩展,请运行以下命令:

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

使用:

安装后,扩展会自动启用。你可以在 Gemini CLI 中直接询问关于 ADK 的问题,它将使用 llms.txt 文件和 ADK 文档提供准确答案并生成代码。

例如,你可以在 Gemini CLI 中询问以下问题:

我如何使用智能体开发工具包创建函数工具?


Antigravity

Antigravity IDE 可以通过运行指向 ADK 的 llms.txt 文件的自定义 MCP 服务器来配置访问 ADK 文档。

先决条件:

确保你已安装 uv 工具,因为此配置使用 uvx在无需手动安装的情况下运行文档服务器。

配置:

  1. 通过编辑器智能体面板顶部的 ...(更多)菜单打开 MCP 商店。
  2. 点击 管理 MCP 服务器
  3. 点击 查看原始配置
  4. 将以下条目添加到 mcp_config.json 中,使用你的自定义 MCP 服务器配置。 如果这是你的第一个 MCP 服务器,你可以粘贴整个代码块:

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

有关管理 MCP 服务器的更多信息,请参阅 Antigravity MCP 文档。

使用:

配置后,你可以使用如下指令提示编程智能体:

使用 ADK 文档构建使用 Gemini 2.5 Pro 的多工具智能体,并包含模拟天气查询工具和自定义计算器工具。使用 adk run 验证智能体。


Claude Code

Claude Code 可以通过添加 MCP 服务器 来配置查询 ADK 文档。

安装:

要为 Claude Code 添加 ADK 文档的 MCP 服务器,请运行以下命令:

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

使用:

安装后,MCP 服务器会自动启用。你可以在 Claude Code 中直接询问 ADK 相关问题,它将使用 llms.txt 文件和 ADK 文档提供准确答案并生成代码。

例如,你可以在 Claude Code 中询问以下问题:

我如何使用智能体开发工具包创建函数工具?


Cursor

Cursor IDE 可以通过运行指向 ADK 的 llms.txt 文件的自定义 MCP 服务器来配置访问 ADK 文档。

先决条件:

确保你已安装 uv 工具,因为此配置使用 uvx在无需手动安装的情况下运行文档服务器。

配置:

  1. 打开 Cursor 设置 并导航到 工具 & MCP 选项卡。
  2. 点击 新建 MCP 服务器,这将打开 mcp.json 进行编辑。
  3. 将以下条目添加到 mcp.json 中,使用你的自定义 MCP 服务器配置。 如果这是你的第一个 MCP 服务器,你可以粘贴整个代码块:

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

有关管理 MCP 服务器的更多信息,请参阅 Cursor MCP 文档

使用:

配置后,你可以使用如下指令提示编程智能体:

使用 ADK 文档构建使用 Gemini 2.5 Pro 的多工具智能体,并包含模拟天气查询工具和自定义计算器工具。使用 adk run 验证智能体。


其他工具

任何支持 llms.txt 标准或可以从 URL 摄取文档的工具都可以从这些文件中受益。你可以将 URL https://adk.wiki/llms.txt(或 llms-full.txt)提供给你的工具的知识库配置或 MCP 服务器配置。