Skip to content

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 文档。


参数

参数类型必填说明
pathstring要读取的文档文件相对路径(如 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 会自动判断是否需要调用该工具。你不需要显式指定,只需自然提问即可。