| name | ask-user-demo |
| description | Use when demonstrating the AskUserQuestion tool capabilities or testing question-based user interactions |
AskUserQuestion 工具演示
概述
演示如何使用内置工具 AskUserQuestion 与用户进行结构化问答交互。这个工具非常适合收集用户偏好、澄清需求或引导决策。
何时使用
- 需要从用户那里收集结构化信息
- 用户请求包含多个可能的选项
- 需要引导用户做出明确选择
- 想要提供预定义选项同时保留自定义输入
核心模式
基本结构
AskUserQuestion({
questions: [
{
question: "你的问题？",
header: "短标签",
options: [
{ label: "选项1", description: "选项1说明" },
{ label: "选项2", description: "选项2说明" }
],
multiSelect: false // true 表示可多选
}
]
})
最佳实践
- 问题要具体明确 - 避免模糊的问法
- 提供 2-4 个选项 - 太多选项会增加认知负担
- 描述要有价值 - 解释每个选项的含义和影响
- 合理使用多选 - 当多个选项可以共存时启用
快速参考
| 参数 | 说明 |
|---|
question | 完整问题文本 |
header | 短标签（最多12字符） |
options | 2-4个选项数组 |
multiSelect | 是否允许多选 |
label | 选项显示文本 |
description | 选项详细说明 |
示例场景：选择编程学习路径
{
"questions": [
{
"question": "你想学习哪个编程领域？",
"header": "学习领域",
"options": [
{ "label": "前端开发", "description": "HTML/CSS/JavaScript，构建用户界面" },
{ "label": "后端开发", "description": "服务器、数据库、API 开发" },
{ "label": "移动开发", "description": "iOS/Android 应用开发" },
{ "label": "数据科学", "description": "数据分析、机器学习、AI" }
],
"multiSelect": false
},
{
"question": "你的经验水平如何？",
"header": "经验水平",
"options": [
{ "label": "完全新手", "description": "从未写过代码" },
{ "label": "初级 (Recommended)", "description": "了解基础概念，需要系统学习" },
{ "label": "中级", "description": "能独立完成项目，想提升技能" }
],
"multiSelect": false
},
{
"question": "你希望的学习方式？（可多选）",
"header": "学习方式",
"options": [
{ "label": "视频教程", "description": "跟随视频一步步学习" },
{ "label": "实战项目", "description": "通过做项目来学习" },
{ "label": "阅读文档", "description": "系统阅读官方文档和书籍" }
],
"multiSelect": true
}
]
}
用户输入处理
用户回答后会返回类似这样的结构：
{
"学习领域": "前端开发",
"经验水平": "初级",
"学习方式": ["视频教程", "实战项目"]
}
常见错误
| 错误 | 修复方法 |
|---|
| 选项太多（5+个） | 精简到2-4个核心选项 |
| 问题太长 | 简化问题，细节放在 description |
| 没有推荐标记 | 在合适选项后加 "(Recommended)" |
| header 超过12字符 | 缩短为更简洁的标签 |
