> ## Documentation Index
> Fetch the complete documentation index at: https://docs.veadk.xyz/llms.txt
> Use this file to discover all available pages before exploring further.

# 应用与会话

应用是服务已加载的智能体入口，会话保存一个用户与该应用的交互状态和事件。先查询应用名称，再创建会话，使用返回的 `id` 发起调用或管理会话

`user_id` 划分会话命名空间，不代表调用者已经通过身份认证。服务访问控制与启动方式见 [Agent API Server 概述](https://docs.veadk.xyz/productions/api-reference/preview/zh/agent-api-server/overview.md)；Harness 部署应使用[对应会话接口](https://docs.veadk.xyz/productions/api-reference/preview/zh/harness-runtime/create-session.md)

| 方法 | 路径 | 接口 |
| - | - | - |
| GET | `/list-apps` | [列出应用](https://docs.veadk.xyz/productions/api-reference/preview/zh/agent-api-server/list-apps.md) |
| GET | `/health` | [健康检查](https://docs.veadk.xyz/productions/api-reference/preview/zh/agent-api-server/health.md) |
| GET | `/apps/{app_name}/users/{user_id}/sessions/{session_id}` | [获取会话](https://docs.veadk.xyz/productions/api-reference/preview/zh/agent-api-server/get-session.md) |
| POST | `/apps/{app_name}/users/{user_id}/sessions` | [创建会话](https://docs.veadk.xyz/productions/api-reference/preview/zh/agent-api-server/create-session.md) |
| DELETE | `/apps/{app_name}/users/{user_id}/sessions/{session_id}` | [删除会话](https://docs.veadk.xyz/productions/api-reference/preview/zh/agent-api-server/delete-session.md) |
| GET | `/apps/{app_name}/users/{user_id}/sessions` | [列出会话](https://docs.veadk.xyz/productions/api-reference/preview/zh/agent-api-server/list-sessions.md) |
| GET | `/version` | [获取服务版本](https://docs.veadk.xyz/productions/api-reference/preview/zh/agent-api-server/version.md) |
| PATCH | `/apps/{app_name}/users/{user_id}/sessions/{session_id}` | [更新会话状态](https://docs.veadk.xyz/productions/api-reference/preview/zh/agent-api-server/update-session.md) |
| POST | `/apps/{app_name}/users/{user_id}/sessions/{session_id}` | [按路径创建会话](https://docs.veadk.xyz/productions/api-reference/preview/zh/agent-api-server/create-session-with-id.md) |
| GET | `/apps/{app_name}/app-info` | [获取应用信息](https://docs.veadk.xyz/productions/api-reference/preview/zh/agent-api-server/get-app-info.md) |


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.