{
"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\\<String\\>|是|知识库文档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\\<Object\\>|权限检查结果列表|\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"
}