# Nexent接口

## API Docs
- 北向接口 > 健康检查 [Health Check](https://s.apifox.cn/487d01f6-1b3c-45fe-8185-307296a685e5/health-check-425130982e0.md): 健康检查接口，无需鉴权
- 北向接口 > 会话管理 [获取会话列表](https://s.apifox.cn/487d01f6-1b3c-45fe-8185-307296a685e5/%E8%8E%B7%E5%8F%96%E4%BC%9A%E8%AF%9D%E5%88%97%E8%A1%A8-425130983e0.md): 返回当前用户（由 Authorization 中的 access_key 识别）名下未删除的会话列表，按创建时间倒序排列。
- 北向接口 > 会话管理 [获取会话历史](https://s.apifox.cn/487d01f6-1b3c-45fe-8185-307296a685e5/%E8%8E%B7%E5%8F%96%E4%BC%9A%E8%AF%9D%E5%8E%86%E5%8F%B2-425130984e0.md): 按会话 ID 获取对话历史，history 按消息先后顺序排列
- 北向接口 > 会话管理 [自动生成会话标题](https://s.apifox.cn/487d01f6-1b3c-45fe-8185-307296a685e5/%E8%87%AA%E5%8A%A8%E7%94%9F%E6%88%90%E4%BC%9A%E8%AF%9D%E6%A0%87%E9%A2%98-506146732e0.md): 使用租户当前配置的主语言模型，根据 question 生成简短标题，并将标题保存到 conversation_id 对应的会话。
- 北向接口 > 会话管理 [更新会话标题](https://s.apifox.cn/487d01f6-1b3c-45fe-8185-307296a685e5/%E6%9B%B4%E6%96%B0%E4%BC%9A%E8%AF%9D%E6%A0%87%E9%A2%98-425130985e0.md): 更新指定会话的标题。title 为 query 参数；可选 meta_data（JSON 字符串）用于审计记录。
- 北向接口 > Agent管理 [获取已发布Agent信息](https://s.apifox.cn/487d01f6-1b3c-45fe-8185-307296a685e5/%E8%8E%B7%E5%8F%96%E5%B7%B2%E5%8F%91%E5%B8%83agent%E4%BF%A1%E6%81%AF-489729457e0.md): 按 agent_name 获取单个已发布 Agent 的详细信息
- 北向接口 > Agent管理 [获取已发布Agent列表](https://s.apifox.cn/487d01f6-1b3c-45fe-8185-307296a685e5/%E8%8E%B7%E5%8F%96%E5%B7%B2%E5%8F%91%E5%B8%83agent%E5%88%97%E8%A1%A8-425130986e0.md): 返回调用方可用的已发布 Agent 列表，包含调用方租户发布的 Agent 与资产所有者租户发布的 Agent
- 北向接口 > 对话聊天 > A2A [获取A2A Agent卡片](https://s.apifox.cn/487d01f6-1b3c-45fe-8185-307296a685e5/%E8%8E%B7%E5%8F%96a2a-agent%E5%8D%A1%E7%89%87-505057296e0.md):  获取指定 endpoint_id 对应的 A2A Agent 能力卡片（公开接口，无需鉴权）
- 北向接口 > 对话聊天 > A2A [聊天接口：http+json 非流式](https://s.apifox.cn/487d01f6-1b3c-45fe-8185-307296a685e5/%E8%81%8A%E5%A4%A9%E6%8E%A5%E5%8F%A3httpjson-%E9%9D%9E%E6%B5%81%E5%BC%8F-505058938e0.md): A2A 协议的 HTTP+JSON 非流式聊天接口，请求体为 A2A Message 结构
- 北向接口 > 对话聊天 > A2A [聊天接口：http+json 流式](https://s.apifox.cn/487d01f6-1b3c-45fe-8185-307296a685e5/%E8%81%8A%E5%A4%A9%E6%8E%A5%E5%8F%A3httpjson-%E6%B5%81%E5%BC%8F-505062428e0.md): 
- 北向接口 > 对话聊天 > A2A [聊天接口：jsonrpc 非流式](https://s.apifox.cn/487d01f6-1b3c-45fe-8185-307296a685e5/%E8%81%8A%E5%A4%A9%E6%8E%A5%E5%8F%A3jsonrpc-%E9%9D%9E%E6%B5%81%E5%BC%8F-505068738e0.md): 
- 北向接口 > 对话聊天 [上传聊天附件](https://s.apifox.cn/487d01f6-1b3c-45fe-8185-307296a685e5/%E4%B8%8A%E4%BC%A0%E8%81%8A%E5%A4%A9%E9%99%84%E4%BB%B6-470503480e0.md): 以 multipart/form-data 上传聊天附件（files 字段，可多文件）。上传成功后返回上传摘要（summary）与每个文件的引用信息
- 北向接口 > 对话聊天 [开始流式聊天](https://s.apifox.cn/487d01f6-1b3c-45fe-8185-307296a685e5/%E5%BC%80%E5%A7%8B%E6%B5%81%E5%BC%8F%E8%81%8A%E5%A4%A9-425130987e0.md): 以 SSE（text/event-stream）发起流式聊天。agent_name 与 query 必填；conversation_id 缺省时创建新会话，并在流首前置 conversation_created 事件
- 北向接口 > 对话聊天 [停止聊天](https://s.apifox.cn/487d01f6-1b3c-45fe-8185-307296a685e5/%E5%81%9C%E6%AD%A2%E8%81%8A%E5%A4%A9-425130988e0.md): 停止指定会话正在进行的流式响应。可选 query 参数 meta_data（JSON 字符串）用于审计记录
- 北向接口 > 知识库 [获取知识库列表](https://s.apifox.cn/487d01f6-1b3c-45fe-8185-307296a685e5/%E8%8E%B7%E5%8F%96%E7%9F%A5%E8%AF%86%E5%BA%93%E5%88%97%E8%A1%A8-476177224e0.md): 返回知识库索引列表。仅资产管理员（asset 租户）可调用，其他租户返回 403
- 北向接口 > 知识库 [创建知识库](https://s.apifox.cn/487d01f6-1b3c-45fe-8185-307296a685e5/%E5%88%9B%E5%BB%BA%E7%9F%A5%E8%AF%86%E5%BA%93-476177219e0.md): 创建知识库。{index_name} 为知识库的展示名称；仅资产管理员可调用，其他租户返回 403
- 北向接口 > 知识库 [删除知识库](https://s.apifox.cn/487d01f6-1b3c-45fe-8185-307296a685e5/%E5%88%A0%E9%99%A4%E7%9F%A5%E8%AF%86%E5%BA%93-476177218e0.md): 删除指定知识库（索引）及其分片、MinIO 源文件与缓存
- 北向接口 > 知识库 [知识库上传文件](https://s.apifox.cn/487d01f6-1b3c-45fe-8185-307296a685e5/%E7%9F%A5%E8%AF%86%E5%BA%93%E4%B8%8A%E4%BC%A0%E6%96%87%E4%BB%B6-476177220e0.md): 以 multipart/form-data 上传文件到知识库并触发 data-process 处理（chunking_strategy=basic）。仅资产管理员可调用，其他租户返回 403
- 北向接口 > 知识库 [查询知识库文件](https://s.apifox.cn/487d01f6-1b3c-45fe-8185-307296a685e5/%E6%9F%A5%E8%AF%A2%E7%9F%A5%E8%AF%86%E5%BA%93%E6%96%87%E4%BB%B6-476177221e0.md): 查询知识库下的文件列表。仅资产管理员可调用，其他租户返回 403
- 北向接口 > 知识库 [删除知识库文件](https://s.apifox.cn/487d01f6-1b3c-45fe-8185-307296a685e5/%E5%88%A0%E9%99%A4%E7%9F%A5%E8%AF%86%E5%BA%93%E6%96%87%E4%BB%B6-476177222e0.md): 删除知识库中的指定文件。path_or_url 为必填（文件路径，通过“查询知识库文件”接口获取）；可选 scope：full（默认，删除分片与源文件）或 source_only（仅删除分片保留源文件）
- 北向接口 > 知识库 [获取文件信息](https://s.apifox.cn/487d01f6-1b3c-45fe-8185-307296a685e5/%E8%8E%B7%E5%8F%96%E6%96%87%E4%BB%B6%E4%BF%A1%E6%81%AF-476177223e0.md): 获取/下载知识库文件。仅资产管理员可调用，其他租户返回 403
- 北向接口 > 知识库 [获取文档分片](https://s.apifox.cn/487d01f6-1b3c-45fe-8185-307296a685e5/%E8%8E%B7%E5%8F%96%E6%96%87%E6%A1%A3%E5%88%86%E7%89%87-495532523e0.md): 获取知识库中指定文件的分片（chunks）列表。{index_id} 通过“获取知识库列表”接口获取；仅资产管理员可调用，其他租户返回 403
- 北向接口 > 知识库 [获取当前智能体当前用户的可用aidp知识库](https://s.apifox.cn/487d01f6-1b3c-45fe-8185-307296a685e5/%E8%8E%B7%E5%8F%96%E5%BD%93%E5%89%8D%E6%99%BA%E8%83%BD%E4%BD%93%E5%BD%93%E5%89%8D%E7%94%A8%E6%88%B7%E7%9A%84%E5%8F%AF%E7%94%A8aidp%E7%9F%A5%E8%AF%86%E5%BA%93-504542522e0.md): 返回指定 Agent 当前用户可用的知识库列表（本地知识库或 AIDP 知识库，取决于 Agent 配置的 tool）
- 北向接口 > Api keys [批量创建 API 用户](https://s.apifox.cn/487d01f6-1b3c-45fe-8185-307296a685e5/%E6%89%B9%E9%87%8F%E5%88%9B%E5%BB%BA-api-%E7%94%A8%E6%88%B7-504930255e0.md): 批量创建 API 用户并返回其 API Key（仅创建时返回完整 Key）。仅管理员（ADMIN / SU）可调用，非管理员返回 403
- 北向接口 > Api keys [刷新 API Key](https://s.apifox.cn/487d01f6-1b3c-45fe-8185-307296a685e5/%E5%88%B7%E6%96%B0-api-key-504930256e0.md): 吊销目标用户的全部有效 API Key，然后创建并返回一个新 Key（仅创建时返回完整 Key）
- 北向接口 > Api keys [吊销 API Key](https://s.apifox.cn/487d01f6-1b3c-45fe-8185-307296a685e5/%E5%90%8A%E9%94%80-api-key-504930257e0.md): 吊销目标用户的全部有效 API Key。user_id 与 email 必须且只能传一个；仅管理员（ADMIN / SU）可调用，非管理员返回 403
- 北向接口 > 模型管理 [查询租户模型列表](https://s.apifox.cn/487d01f6-1b3c-45fe-8185-307296a685e5/%E6%9F%A5%E8%AF%A2%E7%A7%9F%E6%88%B7%E6%A8%A1%E5%9E%8B%E5%88%97%E8%A1%A8-506141911e0.md): 根据 Authorization 请求头中的 API Key 识别用户和租户，返回该租户当前配置且未删除的模型