使用 AI 编程¶
智能体开发工具包 (ADK) 文档支持
/llms.txt 标准,提供针对大语言模型 (LLM) 优化的机器可读文档索引。
这使你能够在 AI 驱动的开发环境中轻松使用 ADK 文档作为上下文。
什么是 llms.txt?¶
llms.txt 是一个标准化文本文件,作为 LLM 的地图,列出最重要的文档页面及其描述。
这有助于 AI 工具理解 ADK 文档的结构并检索相关信息以回答你的问题。
ADK 文档提供两个文件:
| 文件 | 最适合... | URL |
|---|---|---|
llms.txt |
可以动态获取链接的工具 | https://google.github.io/adk-docs/llms.txt |
llms-full.txt |
需要整个站点单一静态文本转储的工具 | https://google.github.io/adk-docs/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 服务器,你可以粘贴整个代码块:
{
"mcpServers": {
"adk-docs-mcp": {
"command": "uvx",
"args": [
"--from",
"mcpdoc",
"mcpdoc",
"--urls",
"AgentDevelopmentKit:https://google.github.io/adk-docs/llms.txt",
"--transport",
"stdio"
]
}
}
}
有关管理 MCP 服务器的更多信息,请参阅 Antigravity MCP 文档。
使用:
配置后,你可以使用如下指令提示编程智能体:
其他工具¶
任何支持 llms.txt 标准或可以从 URL 摄取文档的工具都可以从这些文件中受益。
你可以将 URL https://google.github.io/adk-docs/llms.txt(或 llms-full.txt)
提供给你的工具的知识库配置或 MCP 服务器配置。