Web 应用¶
按要操作的资源选择接口,并在动作页准备所需的身份、标识和参数。
选择任务¶
任务 |
接口 |
说明 |
|---|---|---|
归档访客会话 |
200表示归档,数据仍保留。 |
|
创建访客Web应用会话 |
201返回data.id,不是conversation_id。 |
|
创建访客session |
每次创建新的匿名访客身份;不会恢复原访客历史。 |
|
下载访客任务产物 |
返回原始文件字节;Content-Disposition为attachment,缺少媒体类型时application/octet-stream。 |
|
公开链接与访客身份 |
公开 Web 应用在发布记录允许的范围内为匿名访客提供会话。 |
|
列出本访客会话 |
仅列本访客绑定的active Web应用会话,不接受管理侧status=all语义。 |
|
增量读取访客任务事件 |
after_seq回显请求游标,不是服务端下一游标;total为本次投影条数。 |
|
读取访客会话消息 |
返回items/total/limit/offset;消息顶层和answer_versions见公共对象。 |
|
调用访客任务的MCP应用工具 |
HTTP200/code0仍需检查data.is_error;content与可选structured_content是工具结果。 |
|
读取访客任务的MCP应用资源 |
按任务清单绑定资源,不能代理任意URL;以发布方恢复身份执行。 |
|
公开Web应用对象 |
这些对象用于访客调用,发布管理对象与部署站点配置另有协议。 |
|
预览访客任务产物 |
返回预览字节/流,非JSON包;格式不支持415,过大413/code19,转换失败422/code20。 |
|
刷新同一访客session |
返回新凭据和完整604800秒,保留同一end_user_id;旧凭据不吊销,自然过期。 |
|
修改访客会话标题 |
响应包含conversation_id/title/updated_at。 |
|
解析公开Web应用链接 |
短码响应含agent_id;webapp/t形式仅返回agent_name。 |
|
发送访客消息并读取事件流 |
必须先创建会话;不支持message/send、任务控制、provider交互答复或反馈data分支。 |
|
访客事件流与文件边界 |
流式消息、附件暂存和任务产物读取有不同的完成条件,不能只检查HTTP成功。 |
|
提交访客反馈 |
201仅确认记录反馈ID;不触发重新生成。 |
|
上传访客附件 |
先校验访客和会话,再预占整个multipart请求长度;请求上限201 MiB。 |