使用 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 CLI 中直接询问关于 ADK 的问题,它将使用 llms.txt 文件和 ADK 文档提供准确答案并生成代码。
例如,你可以在 Gemini CLI 中询问以下问题:
我如何使用智能体开发工具包创建函数工具?
Antigravity¶
Antigravity IDE 可以通过运行指向 ADK 的 llms.txt 文件的自定义 MCP 服务器来配置访问 ADK 文档。
先决条件:
确保你已安装 uv 工具,因为此配置使用 uvx在无需手动安装的情况下运行文档服务器。
配置:
- 通过编辑器智能体面板顶部的 ...(更多)菜单打开 MCP 商店。
- 点击 管理 MCP 服务器
- 点击 查看原始配置
-
将以下条目添加到
mcp_config.json中,使用你的自定义 MCP 服务器配置。 如果这是你的第一个 MCP 服务器,你可以粘贴整个代码块:
有关管理 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在无需手动安装的情况下运行文档服务器。
配置:
- 打开 Cursor 设置 并导航到 工具 & MCP 选项卡。
- 点击 新建 MCP 服务器,这将打开
mcp.json进行编辑。 -
将以下条目添加到
mcp.json中,使用你的自定义 MCP 服务器配置。 如果这是你的第一个 MCP 服务器,你可以粘贴整个代码块:
有关管理 MCP 服务器的更多信息,请参阅 Cursor MCP 文档。
使用:
配置后,你可以使用如下指令提示编程智能体:
使用 ADK 文档构建使用 Gemini 2.5 Pro 的多工具智能体,并包含模拟天气查询工具和自定义计算器工具。使用
adk run验证智能体。
其他工具¶
任何支持 llms.txt 标准或可以从 URL 摄取文档的工具都可以从这些文件中受益。你可以将 URL https://adk.wiki/llms.txt(或 llms-full.txt)提供给你的工具的知识库配置或 MCP 服务器配置。