<span id="web-应用"></span>

# Web applications

Choose an API for the resource you need to operate on, then prepare the identity, IDs, and parameters listed on its action page.

<span id="选择任务"></span>

## Choose a task

| Task | Page | Description |
| --- | --- | --- |
| Archive a visitor conversation | [Archive a visitor conversation](archive-conversation.md) | 200 means archived, with data retained. |
| Create a visitor Web app conversation | [Create a visitor Web app conversation](create-conversation.md) | 201 returns data.id, not conversation_id. |
| Create a visitor session | [Create a visitor session](create-session.md) | Each call creates a new anonymous visitor identity without restoring the original visitor's history. |
| Download a visitor task artifact | [Download a visitor task artifact](download-file.md) | Returns original file bytes with attachment Content-Disposition and application/octet-stream when media type is absent. |
| Public links and visitor identity | [Public links and visitor identity](identity-lifecycle.md) | Public Web Apps provide anonymous visitor conversations within the publication record's permitted scope. |
| List this visitor's conversations | [List this visitor's conversations](list-conversations.md) | Lists only this visitor's active Web App conversations, without administration-side status=all semantics. |
| Read visitor task events incrementally | [Read visitor task events incrementally](list-events.md) | after_seq echoes the request cursor, not the server's next cursor. total counts projections returned in this response. |
| Read visitor conversation messages | [Read visitor conversation messages](list-messages.md) | Returns items/total/limit/offset. See common objects for message top-level and answer_versions fields. |
| Call an MCP App tool for a visitor task | [Call an MCP App tool for a visitor task](mcp-call.md) | HTTP 200/code 0 still requires checking data.is_error. content and optional structured_content contain tool results. |
| Read an MCP application resource for a visitor task | [Read an MCP application resource for a visitor task](mcp-resource.md) | Resources are bound to the task list and cannot proxy arbitrary URLs. Execution uses identity restored from the publisher. |
| Public Web application objects | [Public Web application objects](objects.md) | These objects serve visitor calls. Publication management and deployment site configuration use separate protocols. |
| Preview visitor task artifacts | [Preview visitor task artifacts](preview-file.md) | Returns preview bytes/streams, not a JSON envelope. Unsupported formats return 415, size overflow 413/code19, and conversion failure 422/code20. |
| Refresh the same visitor session | [Refresh the same visitor session](refresh-session.md) | Returns new credentials and a full 604800 seconds while retaining end_user_id. Old credentials remain valid until natural expiration. |
| Change a visitor conversation title | [Change a visitor conversation title](rename-conversation.md) | Response contains conversation_id/title/updated_at. |
| Resolve a public Web app link | [Resolve a public Web app link](resolve.md) | Short-code responses include agent_id; the webapp/t form returns only agent_name. |
| Send a visitor message and read the event stream | [Send a visitor message and read the event stream](stream-message.md) | Create a conversation first. message/send, task control, provider interaction answers, and feedback data variants are unsupported. |
| Visitor event streams and file boundaries | [Visitor event streams and file boundaries](streams-files.md) | Streaming messages, attachment staging, and task artifact reads have distinct completion conditions. HTTP success alone is insufficient. |
| Submit visitor feedback | [Submit visitor feedback](submit-feedback.md) | 201 confirms only the recorded feedback ID; it does not trigger regeneration. |
| Upload a visitor attachment | [Upload a visitor attachment](upload-file.md) | Validate visitor and conversation first, then reserve the entire multipart request length. Request limit: 201 MiB. |

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

Archive a visitor conversation <archive-conversation>
Create a visitor Web app conversation <create-conversation>
Create a visitor session <create-session>
Download a visitor task artifact <download-file>
Public links and visitor identity <identity-lifecycle>
List this visitor's conversations <list-conversations>
Read visitor task events incrementally <list-events>
Read visitor conversation messages <list-messages>
Call an MCP App tool for a visitor task <mcp-call>
Read an MCP application resource for a visitor task <mcp-resource>
Public Web application objects <objects>
Preview visitor task artifacts <preview-file>
Refresh the same visitor session <refresh-session>
Change a visitor conversation title <rename-conversation>
Resolve a public Web app link <resolve>
Send a visitor message and read the event stream <stream-message>
Visitor event streams and file boundaries <streams-files>
Submit visitor feedback <submit-feedback>
Upload a visitor attachment <upload-file>
```
