MujicaUI/docs/components/280-human-input-request.md

280 HumanInputRequest 人工输入请求

用途

Agent 向用户提问：显示问题、可选答案与自由回答，并提示剩余时间与超时。

最小示例

answer := ""
view := func(c *ui.Context) {
	core.Use(c, core.Settings{})
	r := agent.HumanInputRequest(c, &answer, agent.HumanInputRequestOptions{
		Question: "Which hall?", Options: []string{"East wing", "Great hall"}, AllowFree: true,
	})
	if r.Submitted {
		fmt.Println("reply", answer)
	}
}
ui.Render(view, 400, 300, 1)

签名：func HumanInputRequest(c *ui.Context, answer *string, opts HumanInputRequestOptions) HumanInputResult。answer 为 nil、Question 为空、既无选项又不允许自由回答时 panic。

参数

字段	类型	默认值	含义
Question	string	必填	问题。
Options	[]string	nil	可选答案。
AllowFree	bool	false	允许自由回答。
Deadline	time.Time	零值	截止时间；零值不限时。
Disabled	bool	false	禁止回答。

状态

• 选择选项会清空自由回答；输入自由回答会取代所选选项。
• 剩余时间每秒刷新；到时显示“智能体已停止等待”并禁用。
• 回答为空白时“发送回答”禁用。

事件

• Submitted：用户发送了 *answer。
• TimedOut：截止时间在本帧到达（只报告一次）。

键盘操作

• Tab 进入选项组，方向键选择；Tab 到输入框，Enter 发送；或 Tab 到“发送回答”。

限制

• 超时只在界面帧中检测，窗口隐藏期间推迟到重新显示。