53 lines
1.6 KiB
Markdown
53 lines
1.6 KiB
Markdown
# 280 HumanInputRequest 人工输入请求
|
|
|
|
## 用途
|
|
|
|
Agent 向用户提问：显示问题、可选答案与自由回答，并提示剩余时间与超时。
|
|
|
|
## 最小示例
|
|
|
|
```go
|
|
answer := ""
|
|
view := func(c *ui.Context) {
|
|
mujica.Use(c, mujica.Settings{})
|
|
r := mujica.HumanInputRequest(c, &answer, mujica.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 到“发送回答”。
|
|
|
|
## 限制
|
|
|
|
- 超时只在界面帧中检测，窗口隐藏期间推迟到重新显示。
|