# Web 应用

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

## 选择任务

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

```{toctree}
:hidden:
:maxdepth: 1

归档访客会话 <archive-conversation>
创建访客Web应用会话 <create-conversation>
创建访客session <create-session>
下载访客任务产物 <download-file>
公开链接与访客身份 <identity-lifecycle>
列出本访客会话 <list-conversations>
增量读取访客任务事件 <list-events>
读取访客会话消息 <list-messages>
调用访客任务的MCP应用工具 <mcp-call>
读取访客任务的MCP应用资源 <mcp-resource>
公开Web应用对象 <objects>
预览访客任务产物 <preview-file>
刷新同一访客session <refresh-session>
修改访客会话标题 <rename-conversation>
解析公开Web应用链接 <resolve>
发送访客消息并读取事件流 <stream-message>
访客事件流与文件边界 <streams-files>
提交访客反馈 <submit-feedback>
上传访客附件 <upload-file>
```
