提问与内置文档工具
理解 ask_user 的问题结构和 get_internal_docs 的文档核实方式。
This page has not been translated into English yet. The original Chinese version is shown below.
ask_user 用于收集偏好、澄清缺失需求或请求明确选择。它会暂停执行,直到用户答复或关闭对话框;关闭不是一个自动的肯定答案。
问题参数
| 字段 | 约束 |
|---|---|
questions | 1–4 个问题对象 |
question | 必需,完整问题 |
header | 必需,最多 16 字符的短标签 |
type | 默认 choice,也可 text 或 yesno |
options | choice 必需,2–4 个 label/description |
multiSelect | choice 可用,多个标准项时自动加入 All the above |
placeholder | 文本输入提示,可选 |
选项 label 为 1–5 个词,description 解释含义。结果为 JSON 字符串,按问题位置索引,例如 answers 中的 "0"、"1",并不是按 header 作为键。
内置文档核实
get_internal_docs 由 Gemini CLI 自己调用,读取项目 docs/ 下的 Markdown。可选 path 如 reference/commands.md;省略时列出可用文档路径。用户不能把它作为手工工具命令执行,可以请求 Gemini 核对某个命令或配置后再回答。
文档工具有助于纠正模型对产品功能的记忆,但遇到文档本身与运行版本不一致时,仍需比较已安装版本与官方 schema,不能以模型说“已查文档”替代实际检查。