1. 会话管理
Nexent接口
  • 北向接口
    • 健康检查
      • Health Check
    • 会话管理
      • 获取会话列表
        GET
      • 获取会话历史
        GET
      • 自动生成会话标题
        POST
      • 更新会话标题
        PUT
    • Agent管理
      • 获取已发布Agent信息
      • 获取已发布Agent列表
    • 对话聊天
      • A2A
        • 获取A2A Agent卡片
        • 聊天接口:http+json 非流式
        • 聊天接口:http+json 流式
        • 聊天接口:jsonrpc 非流式
      • 上传聊天附件
      • 开始流式聊天
      • 停止聊天
    • 知识库
      • 获取知识库列表
      • 创建知识库
      • 删除知识库
      • 知识库上传文件
      • 查询知识库文件
      • 删除知识库文件
      • 获取文件信息
      • 获取文档分片
      • 获取当前智能体当前用户的可用aidp知识库
    • Api keys
      • 批量创建 API 用户
      • 刷新 API Key
      • 吊销 API Key
    • 模型管理
      • 查询租户模型列表
  1. 会话管理

获取会话历史

GET
/nb/v1/conversations/{conversation_id}
最后修改时间:2026-09-23 01:32:19
按会话 ID 获取对话历史,history 按消息先后顺序排列
每条历史消息包含发言角色(role)、文本内容(content)与关联文件引用列表(minio_files)

请求参数

Authorization
在 Header 添加参数
Authorization
,其值为在 Bearer 之后拼接 Token
示例:
Authorization: Bearer ********************
Path 参数

Header 参数

请求示例代码

Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
请求示例请求示例
Shell
JavaScript
Java
Swift
curl --location 'http://localhost:5013/api/nb/v1/conversations/9257' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json'

返回响应

🟢200成功
application/json
Bodyapplication/json

示例
{
    "message": "success",
    "data": {
        "conversation_id": 24,
        "history": [
            {
                "role": "user",
                "content": "告诉我批量检查文档权限接口的具体信息",
                "minio_files": [],
                "search": []
            },
            {
                "role": "assistant",
                "content": "根据检索到的知识库文档,以下是“批量检查文档权限接口”的具体信息:\n\n## 接口概述\n批量检查指定用户对多个文档是否有访问权限。[[a1]]\n\n## 基本信息\n| 项目 | 内容 |\n| :--- | :--- |\n| **接口名称** | 批量检查文档权限 |\n| **请求方式** | POST |\n| **请求路径** | `/AIDAM/document/permission/check` |\n| **Content-Type** | `application/json` [[a1]]\n\n## 请求参数\n### 请求体(Request Body)\n| 参数名 | 类型 | 必填 | 说明 |\n| :--- | :--- | :--- | :--- |\n| `userId` | Long | 是 | 用户ID |\n| `documentIds` | List\\<String\\> | 是 | 知识库文档ID列表(数组) [[a1]]\n\n### 请求示例\n```json\n{\n  \"userId\": 123,\n  \"documentIds\": [\"doc001\", \"doc002\", \"doc003\"]\n}\n``` [[a1]]\n\n## 响应参数\n### 响应体(Response Body)\n| 参数名 | 类型 | 说明 |\n| :--- | :--- | :--- |\n| `status` | String | 状态码:`SUCCESS` / `ERROR` / `INVALID` |\n| `msg` | String | 响应消息 |\n| `data` | List\\<Object\\> | 权限检查结果列表 [[a1]]\n\n### data 对象结构\n| 参数名 | 类型 | 说明 |\n| :--- | :--- | :--- |\n| `documentId` | String | 文档ID |\n| `hasPermission` | Boolean | `true`:有权限,`false`:无权限 [[a1]]\n\n### 成功响应示例\n```json\n{\n  \"status\": \"SUCCESS\",\n  \"msg\": \"成功\",\n  \"data\": [\n    {\"documentId\": \"doc001\", \"hasPermission\": true},\n    {\"documentId\": \"doc002\", \"hasPermission\": false},\n    {\"documentId\": \"doc003\", \"hasPermission\": true}\n  ]\n}\n``` [[a1]]\n\n### 失败响应示例\n```json\n{\n  \"status\": \"ERROR\",\n  \"msg\": \"参数不能为空\",\n  \"data\": null\n}\n``` [[a3]]\n\n## 权限判断逻辑\n### 数据查询链路\n1.  通过 `documentId` 在 `jweb_aidam_file_per_management` 表查询获取 `permissionsfileid`\n2.  通过 `permissionsfileid` 关联 `jweb_systemrole_commonfile` 权限表查询权限 [[a3]]\n\n### 三种授权方式(取并集)\n| 授权类型 | roleType | 说明 |\n| :--- | :--- | :--- |\n| 用户授权 | 0 | 用户本人被授权 |\n| 工作组授权 | 1 | 用户所在工作组被授权 |\n| 部门授权 | 2 | 用户所在部门被授权 [[a3]]\n\n> **错误码说明**\n> | 状态码 | 说明 |\n> | :--- | :--- |\n> | `SUCCESS` | 请求成功 |\n> | `ERROR` | 请求失败(服务端异常或参数错误) |\n> | `INVALID` | 未登录或登录已超时 [[a3]]\n\n## 调用示例\n### cURL\n```bash\ncurl -X POST \"http://ip:port/AIDAM/document/permission/check\" \\\n  -H \"Content-Type: application/json\" \\\n  -d '{\n    \"userId\": 123,\n    \"documentIds\": [\"doc001\", \"doc002\", \"doc003\"]\n  }'\n``` [[a3]]\n\n## 变更记录\n| 版本 | 日期 | 说明 |\n| :--- | :--- | :--- |\n| v1.0 | 2025-05-12 | 初始版本 [[a3]]",
                "minio_files": [
                    {
                        "object_name": "workspace/f91b9ff6-a723-4c5a-8c50-350fdff33b4d/c44319700b754c8abd1567664a41f91b/outputs/肝知宝功能介绍.docx",
                        "name": "肝知宝功能介绍.docx",
                        "type": "file",
                        "size": 38395,
                        "url": "s3://nexent/workspace/f91b9ff6-a723-4c5a-8c50-350fdff33b4d/c44319700b754c8abd1567664a41f91b/outputs/肝知宝功能介绍.docx",
                        "description": "",
                        "presigned_url": "http://localhost:5013/api/nb/v1/file/fetch?presigned_url=http%3A%2F%2Fnexent-minio%3A9000%2Fnexent%2Fworkspace%2Ff91b9ff6-a723-4c5a-8c50-350fdff33b4d%2Fc44319700b754c8abd1567664a41f91b%2Foutputs%2F%25E8%2582%259D%25E7%259F%25A5%25E5%25AE%259D%25E5%258A%259F%25E8%2583%25BD%25E4%25BB%258B%25E7%25BB%258D.docx%3FX-Amz-Algorithm%3DAWS4-HMAC-SHA256%26X-Amz-Credential%3D4ba499db3009bf9c334bcf38%252F20260908%252Fcn-north-1%252Fs3%252Faws4_request%26X-Amz-Date%3D20260908T094912Z%26X-Amz-Expires%3D86400%26X-Amz-SignedHeaders%3Dhost%26X-Amz-Signature%3Db854aa3d5ed37954ec0ad371c59133874bf74bc523defb19225cc5166f18513a"
                    }
                ],
                "search": [
                    {
                        "title": "文档权限检查接口文档.md",
                        "text": "# 文档权限检查接口文档\n\n## 接口概述\n\n批量检查指定用户对多个文档是否有访问权限。\n\n---\n\n## 基本信息\n\n|项目|内容|\n\n|--\n\n|--\n\n|\n\n|*\n\n接口名称*\n\n|批量检查文档权限|\n\n|*\n\n请求方式*\n\n|POST|\n\n|*\n\n请求路径*\n\n|`/AIDAM/document/permission/check`|\n\n|*\n\nContent\\\n\nType*\n\n|`application/json`|\n\n---\n\n## 请求参数\n\n### 请求体(Request Body)\n\n|参数名|类型|必填|说明|\n\n|--\n\n|--\n\n|--\n\n|--\n\n|\n\n|`userId`|Long|是|用户ID|\n\n|`documentIds`|List\\&lt;String\\&gt;|是|知识库文档ID列表(数组)|\n\n### 请求示例\n\n```JSON\n\n{\n\n\"userId\": 123,\n\n\"documentIds\": [\"doc001\", \"doc002\", \"doc003\"]\n\n}\n\n```\n\n---\n\n## 响应参数\n\n### 响应体(Response Body)\n\n|参数名|类型|说明| |---|---|---| |`status`|String|状态码:`SUCCESS` / `ERROR` / `INVALID`| |`msg`|String|响应消息| |`data`|List\\&lt;Object\\&gt;|权限检查结果列表|\n\n### data 对象结构\n\n|参数名|类型|说明|\n\n|--\n\n|--\n\n|--\n\n|\n\n|`documentId`|String|文档ID|\n\n|`hasPermission`|Boolean|`true`:有权限,`false`:无权限|\n\n### 成功响应示例\n\n```JSON\n\n{\n\n\"status\": \"SUCCESS\",\n\n\"msg\": \"成功\",\n\n\"data\": [\n\n{\"documentId\": \"doc001\", \"hasPermission\": true},\n\n{\"documentId\": \"doc002\", \"hasPermission\": false},\n\n{\"documentId\": \"doc003\", \"hasPermission\": true}\n\n]\n\n}\n\n```\n\n### 失败响应示例\n\n```JSON\n\n{\n\n\"status\": \"ERROR\",",
                        "source_type": "file",
                        "url": "knowledge_base/20260530014827_0364c067652b41fbaf53e9a1ef185067.md",
                        "filename": "文档权限检查接口文档.md",
                        "published_date": "2026-05-30",
                        "score": 1,
                        "tool_sign": "a",
                        "cite_index": 1
                    },
                    {
                        "title": "docx_processing_assistant.json",
                        "text": "agent_info: {\"7\":{\"agent_id\":7,\"name\":\"docx_processing_assistant\",\"display_name\":\"文档处理助手\",\"description\":\"你是一个docx文档处理助手,能够帮助你处理各种文档相关的任务,包括格式调整、内容编辑和文件转换等。\",\"business_description\":\"你是一个docx文档处理助手\",\"author\":\"test@137.com\",\"max_steps\":5,\"provide_run_summary\":false,\"duty_prompt\":\"你是一个专业的文档处理助手,专门负责处理和分析docx文档。\\n你能够高效地解析文档内容,提取关键信息,并根据用户需求提供相应的文档处理服务。\\n你具备强大的文档理解与信息整合能力,能够生成清晰、准确的文档分析结果或处理方案。\",\"constraint_prompt\":\"1.  由于当前没有可用的工具,在处理docx文档时,请仅依靠你自身的知识和推理能力来完成用户的任务。\\n2.  对于任何涉及创建、编辑、转换或分析docx文档文件本身的操作,请明确告知用户你无法直接执行,因为你没有操作文件的工具。\\n3.  你可以为用户提供关于docx文档格式、结构、常见问题解决方案的指导性建议和文字性说明。\\n4.  如果用户请求需要实际工具支持才能完成的任务(例如合并文档、提取图片、批量修改格式),请引导用户使用专门的文档处理软件或寻求其他具备相应工具的助手帮助。\",\"few_shots_prompt\":\"\",\"enabled\":true,\"tools\":[{\"class_name\":\"KnowledgeBaseSearchTool\",\"name\":\"knowledge_base_search\",\"description\":\"Performs a local knowledge base search based on your query then returns the top search results. A tool for retrieving domain-specific knowledge, documents, and information stored in the local knowledge base. Use this tool when users ask questions related to specialized knowledge, technical documentation, domain expertise, personal notes, or any information that has been indexed in the knowledge base. Suitable for queries requiring access to stored knowledge that may not be publicly available.\",\"inputs\":\"{\\\"query\\\": {\\\"type\\\": \\\"string\\\", \\\"description\\\": \\\"The search query to perform.\\\", \\\"description_zh\\\": \\\"要执行的搜索查询词\\\"}, \\\"index_names\\\": {\\\"type\\\": \\\"array\\\", \\\"description\\\": \\\"The list of index names to search\\\", \\\"description_",
                        "source_type": "file",
                        "url": "knowledge_base/20260530014828_82f3adee990a4269bc03ec2009f552f8.json",
                        "filename": "docx_processing_assistant.json",
                        "published_date": "2026-05-30",
                        "score": 0.691796,
                        "tool_sign": "a",
                        "cite_index": 2
                    },
                    {
                        "title": "文档权限检查接口文档.md",
                        "text": "\"msg\": \"参数不能为空\",\n\n\"data\": null\n\n}\n\n```\n\n---\n\n## 权限判断逻辑\n\n### 数据查询链路\n\n1. 通过 `documentId` 在 `jweb\\_aidam\\_file\\_per\\_management` 表查询获取 `permissionsfileid`\n\n2. 通过 `permissionsfileid` 关联 `jweb\\_systemrole\\_commonfile` 权限表查询权限\n\n### 三种授权方式(取并集)\n\n|授权类型|roleType|说明|\n\n|--\n\n|--\n\n|--\n\n|\n\n|用户授权|0|用户本人被授权|\n\n|工作组授权|1|用户所在工作组被授权|\n\n|部门授权|2|用户所在部门被授权|\n\n> 错误码说明\n\n>\n\n>\n\n|状态码|说明|\n\n|--\n\n|--\n\n|\n\n|`SUCCESS`|请求成功|\n\n|`ERROR`|请求失败(服务端异常或参数错误)|\n\n|`INVALID`|未登录或登录已超时|\n\n---\n\n## 调用示例\n\n### cURL\n\n```Bash\n\ncurl\n\nX POST \"http://ip:port/AIDAM/document/permission/check\" \\\n\nH \"Content\n\nType: application/json\" \\\n\nd '{\n\n\"userId\": 123,\n\n\"documentIds\": [\"doc001\", \"doc002\", \"doc003\"]\n\n}'\n\n```\n\n---\n\n## 变更记录\n\n|版本|日期|说明|\n\n|--\n\n|--\n\n|--\n\n|\n\n|v1\\.0|2025\\\n\n05\\\n\n12|初始版本|",
                        "source_type": "file",
                        "url": "knowledge_base/20260530014827_0364c067652b41fbaf53e9a1ef185067.md",
                        "filename": "文档权限检查接口文档.md",
                        "published_date": "2026-05-30",
                        "score": 0.645092,
                        "tool_sign": "a",
                        "cite_index": 3
                    }
                ]
            }
        ]
    },
    "requestId": "795847a6-53ff-416b-8298-53c40954c542"
}
🟠401Unauthorized
🟠429TooManyRequests
🔴500InternalServerError
修改于 2026-09-23 01:32:19
上一页
获取会话列表
下一页
自动生成会话标题
Built with