Web 应用

按要操作的资源选择接口,并在动作页准备所需的身份、标识和参数。

选择任务

任务

接口

说明

归档访客会话

归档访客会话

200表示归档,数据仍保留。

创建访客Web应用会话

创建访客Web应用会话

201返回data.id,不是conversation_id。

创建访客session

创建访客session

每次创建新的匿名访客身份;不会恢复原访客历史。

下载访客任务产物

下载访客任务产物

返回原始文件字节;Content-Disposition为attachment,缺少媒体类型时application/octet-stream。

公开链接与访客身份

公开链接与访客身份

公开 Web 应用在发布记录允许的范围内为匿名访客提供会话。

列出本访客会话

列出本访客会话

仅列本访客绑定的active Web应用会话,不接受管理侧status=all语义。

增量读取访客任务事件

增量读取访客任务事件

after_seq回显请求游标,不是服务端下一游标;total为本次投影条数。

读取访客会话消息

读取访客会话消息

返回items/total/limit/offset;消息顶层和answer_versions见公共对象。

调用访客任务的MCP应用工具

调用访客任务的MCP应用工具

HTTP200/code0仍需检查data.is_error;content与可选structured_content是工具结果。

读取访客任务的MCP应用资源

读取访客任务的MCP应用资源

按任务清单绑定资源,不能代理任意URL;以发布方恢复身份执行。

公开Web应用对象

公开Web应用对象

这些对象用于访客调用,发布管理对象与部署站点配置另有协议。

预览访客任务产物

预览访客任务产物

返回预览字节/流,非JSON包;格式不支持415,过大413/code19,转换失败422/code20。

刷新同一访客session

刷新同一访客session

返回新凭据和完整604800秒,保留同一end_user_id;旧凭据不吊销,自然过期。

修改访客会话标题

修改访客会话标题

响应包含conversation_id/title/updated_at。

解析公开Web应用链接

解析公开Web应用链接

短码响应含agent_id;webapp/t形式仅返回agent_name。

发送访客消息并读取事件流

发送访客消息并读取事件流

必须先创建会话;不支持message/send、任务控制、provider交互答复或反馈data分支。

访客事件流与文件边界

访客事件流与文件边界

流式消息、附件暂存和任务产物读取有不同的完成条件,不能只检查HTTP成功。

提交访客反馈

提交访客反馈

201仅确认记录反馈ID;不触发重新生成。

上传访客附件

上传访客附件

先校验访客和会话,再预占整个multipart请求长度;请求上限201 MiB。

最后更新于