向用户提问,等待用户回答后继续。
执行流程
- 生成唯一
ref - 广播
{:ask_user, session_id, question, options, ref}事件 - 阻塞等待
{:cmdc_event, session_id, {:user_responded, session_id, ref, response}}消息 - 超时(默认 5 分钟)则返回错误
- 将用户回答作为工具结果返回 LLM
选项参数(可选)
options 字段支持预设选项列表,UI 可展示为单选/多选。
为空列表时视为自由文本输入。
注意
此工具会阻塞当前工具执行 Task,直到用户响应或超时。
外部需通过 CMDC.approve/2 或发送对应事件来解除阻塞。