ambleloft补充信息：确认、草稿与恢复
应用自带补充信息 skill，Agent 按需读取并调用宿主工具。你可以直接在聊天中使用；本页进一步说明答案如何确认，以及开发者需要遵守的工具边界。
完成后：在聊天中补充并确认信息，理解草稿和答案的区别。
前置条件：直接在应用聊天中使用内置补充信息 skill。
本页内容
01在聊天中使用
直接描述任务，回答 Agent 提出的必要问题。相关信息可以通过输入框上方的表单提交，也可以在聊天中补充。内置动态表单不需要安装 SDK、CLI 或业务 Demo。确认后的信息用于继续原任务；收集信息本身不授权提交业务申请。
开始一次聊天02确认与修改
预填和未提交草稿都不是确认答案。直接用文字回复后，Agent 可以整理你的回答；如果宿主要求确认修改提案，请先审阅再决定。取消某份补充请求和停止整个任务是不同操作。投递状态不确定时，先核对记录，避免重复发送。
03开发者参考：可选的静态校验
以下命令仅用于开发者检查工具参数；普通聊天使用不需要运行。若要执行校验，请先在开发项目中安装配套 CLI。校验不会创建宿主表单，也不验证权限或运行结果。JSON 中上海是演示预填值；真实调用应使用用户已提供的信息，或明确标注可修改的建议。
cat > input-request.json <<'JSON'
{
"name": "input_request",
"arguments": {
"requestKey": "travel-destination-1",
"reason": "需要目的地来准备行程",
"source": {
"kind": "dynamic",
"definition": {
"title": "补充目的地",
"fields": [
{
"name": "destination",
"type": "text",
"label": "目的地",
"required": true
}
]
}
},
"prefill": {
"destination": "上海"
}
}
}
JSON
npx --no-install amble-extension validate-input input-request.json --json04开发者参考：模型工具流程
模型先发现可用工具并调用 input_capabilities，再使用 input_list 复用现有请求。input_request 创建后立即返回；source.kind="dynamic" 不依赖注册模板。收到用户提交事件后，用 requestId 调用 input_read_answer。pending 时 answer=null；answered 与 delivery.state=delivered 分别描述答案和投递状态。SDK 仅分发相关类型/schema，不提供 Node 或页面 inputs API。
05错误、草稿与重试
失败返回 {ok:false,error:{code,message,details?}}，没有 operation 的 requestId/effectStatus。列表用 id，回执用 requestId。input_request 原样重试返回当前状态；cancel/replace/resolve 原样重试返回原回执。输入已编辑时，replace/resolve 可能返回 confirmationRequired 和 proposalId，必须等待用户确认。input_cancel 不停止任务。unknown 投递先核实，不能盲目重发。
06生命周期与下一步
来源失效可使 pending 请求过期；归档拒绝模型操作；删除聊天会清理请求与投递记录。草稿不会提供给模型，已有答案不保证永久保存或继续投递。需要展示或选择业务数据时，使用声明式 UI 指南。
查看声明式 UI检查结果与排错
在聊天中补充并确认信息，理解草稿和答案的区别。
按本页的验证步骤核对实际结果。涉及业务服务时，分别检查界面提交、工具回执与服务端记录。
打开错误代码与排错 →