Appearance
get_internal_docs 工具是 Gemini CLI 的内部自查机制——当 AI 对某功能细节不确定时,它会通过此工具读取 docs/ 目录中的官方文档,确保给出的回答有文档依据。用户无法手动调用它,但它的存在让 AI 在回答 CLI 功能问题时更加准确可信。
get_internal_docs 工具参考
get_internal_docs 工具让 Gemini CLI 的 AI 代理能够主动查阅自身的技术文档,以此保证对 Gemini CLI 功能的描述准确、有依据。
工具说明
工具名称:get_internal_docs
当 Gemini CLI 需要核实内置功能、CLI 命令或配置项的具体细节时,会使用此工具直接访问 docs/ 目录中的 Markdown 文档。
参数
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
path | string | 否 | 要读取的文档文件相对路径(如 reference/commands.md);省略时返回所有可用文档路径列表 |
使用限制
get_internal_docs 是代理专用内部工具,无法通过 Prompt 或命令手动调用。CLI 会在内部自动使用它,结果不会直接显示在你的对话中,而是作为 AI 生成回答的依据。
工作场景
能力发现
当 AI 对某功能是否存在、如何工作不确定时,会先查阅对应文档再回答:
用户:Gemini CLI 支持 Web 抓取吗?
AI:[调用 get_internal_docs 查看 tools/web-fetch.md]
→ 确认工具存在和参数后回答参数核实
当需要确认 CLI 命令的具体子命令或配置项名称时:
用户:/rewind 命令怎么用?
AI:[调用 get_internal_docs 查看 reference/commands.md 中的 /rewind 部分]
→ 给出准确的参数说明自我纠错
当 AI 发现自己对某个功能的理解可能有误时,主动查阅文档纠正:
用户:Hooks 的 PostToolUse 事件有哪些字段?
AI:[调用 get_internal_docs 确认字段格式]
→ 给出与文档一致的答案,而非依赖训练数据对用户的实际意义
你不需要了解这个工具的技术细节,但它的存在意味着:
- 回答更可靠:AI 描述 Gemini CLI 功能时有文档依据,不会凭训练记忆猜测
- 版本感知:AI 可以根据当前版本的文档回答,而不是旧版本的行为
- 减少幻觉:对于复杂配置(如 settings.json 字段名、Hook 事件类型),AI 可以核实后再告知
常见问题
Q: 我看到 AI 调用了 get_internal_docs,这正常吗?
A: 完全正常。这说明 AI 在认真对待你的问题,主动确认而非猜测。
Q: get_internal_docs 能访问哪些文档?
A: 只能访问 Gemini CLI 自身的 docs/ 目录文档(即本文档站点的上游原始内容)。不能访问外部 URL 或用户自定义文档。如需模型了解外部内容,可用 @文件路径 语法或 web_fetch 工具。
Q: 可以通过某种方式让 AI 使用这个工具吗?
A: 当你问关于 Gemini CLI 功能的具体问题时(如"X 命令的参数有哪些?"、"Y 配置项默认值是什么?"),AI 会自动判断是否需要调用该工具。你不需要显式指定,只需自然提问即可。