> ## Documentation Index > Fetch the complete documentation index at: https://docs.dify.ai/llms.txt > Use this file to discover all available pages before exploring further. # 获取研究任务结果列表 > 列出研究任务目前已写入的结果，按 `sequence` 升序排列。 一个任务最多写入两个结果：先是检索检查点（如有），然后是最终结果。在最后一个结果中查看 `answer`。提前停止的任务可能没有任何结果。 规划、创建、轮询和读取结果的完整流程，详见 [运行研究任务](/zh/api-reference/guides/knowledge-base#run-a-research-task)。 ## OpenAPI ````yaml /zh/api-reference/openapi_service.json get /knowledge-fs/spaces/{knowledge_base_id}/research-tasks/{research_task_id}/partials openapi: 3.0.1 info: description: 用于 Dify 应用与知识库的 REST API。应用类接口使用应用 API 密钥认证，知识库类接口使用知识库 API 密钥认证。 title: Dify 服务 API version: 1.0.0 servers: - description: Dify 服务 API 的基础 URL。自部署时，替换为你的 API 基础 URL。 url: https://{api_base_url} variables: api_base_url: default: api.dify.ai/v1 description: API 基础 URL 的主机与路径，不含 `https://` 前缀。 security: - ApiKeyAuth: [] tags: - description: 与聊天消息和交互相关的操作。 name: 对话消息 - description: 文件上传和预览操作。 name: 文件操作 - description: 终端用户信息相关操作。 name: 终端用户 - description: 用户反馈操作。 name: 消息反馈 - description: 与管理会话相关的操作。 name: 会话管理 - description: 文字转语音和语音转文字操作。 name: 语音与文字转换 - description: 获取应用设置和信息的操作。 name: 应用配置 - description: 与管理标注直接回复相关的操作。 name: 标注管理 - description: 暂停等待人工输入的工作流恢复操作。 name: 人工介入 - description: 用于执行和管理工作流的操作。 name: 工作流运行 - description: 文本生成相关操作。 name: 文本生成消息 - description: 用于管理知识库的操作，包括创建、配置和检索。 name: 知识库 - description: 用于在知识库中创建、更新和管理文档的操作。 name: 文档 - description: 用于管理分段和子分段的操作。 name: 分段 - description: 用于管理知识库元数据字段和文档元数据值的操作。 name: 元数据 - description: 用于管理知识库标签和标签绑定的操作。 name: 标签 - description: 用于获取可用模型的操作。 name: 模型 - description: 用于管理和运行知识流水线的操作，包括数据源插件和流水线执行。 name: 知识流水线 - description: 向知识库提问，并流式返回回答。 name: 查询 - description: 查看一次查询检索到了什么，以及原因。 name: 查询记录 - description: 在后台运行研究问题，并获取其结果。 name: 研究任务 - description: 读取知识库中的文档及其文件、修订版本和分段，并用元数据标注文档。 name: 文档与分段 - description: 跟踪、取消或重试索引，并列出知识库的后台任务。 name: 索引任务 - description: 跟踪文档文件、一批文件或数据源的删除，直到完成。 name: 删除作业 - description: 管理为知识库提供内容的数据源，以及它们的定时同步设置和连接。 name: 数据源 - description: 立即同步数据源，导入网站页面或提供商条目，并跟踪、取消或重试运行。 name: 数据源同步与导入 - description: 读取和更改知识库的模型与检索设置，并跟踪更改触发的迁移。 name: 设置 paths: /knowledge-fs/spaces/{knowledge_base_id}/research-tasks/{research_task_id}/partials: get: tags: - Research Tasks summary: 获取研究任务结果列表 description: >- 列出研究任务目前已写入的结果，按 `sequence` 升序排列。 一个任务最多写入两个结果：先是检索检查点（如有），然后是最终结果。在最后一个结果中查看 `answer`。提前停止的任务可能没有任何结果。 规划、创建、轮询和读取结果的完整流程，详见 [运行研究任务](/zh/api-reference/guides/knowledge-base#run-a-research-task)。 operationId: listResearchTaskResults parameters: - description: >- 知识库 ID：即知识库 **API 访问** 对话框中所示服务 API 端点的最后一段（`…/knowledge-fs/spaces/`），也是地址栏中 `/datasets/new/` 之后的那一段。 in: path name: knowledge_base_id required: true schema: format: uuid type: string - description: >- 研究任务 ID，来自 [创建研究任务](/zh/api-reference/research-tasks/create-research-task)。 in: path name: research_task_id required: true schema: format: uuid type: string - description: 不透明游标：原样发送上一页的 `next_cursor`。 in: query name: cursor required: false schema: maxLength: 1000 minLength: 1 type: string - description: 每页条目数。 in: query name: limit required: false schema: default: 25 maximum: 100 minimum: 1 type: integer responses: '200': content: application/json: examples: success: summary: 响应示例 value: data: - answer: null evidence_bundle: createdAt: '2026-09-06T08:00:10.000Z' id: 9a8b7c6d-5e4f-4a3b-8c2d-1e0f9a8b7c6d items: - citations: - documentAssetId: a1b2c3d4-e5f6-4a7b-8c9d-0e1f2a3b4c5d documentVersion: 1 pageNumber: 2 sectionPath: - Policies - Refunds conflicts: [] freshness: sourceUpdatedAt: '2026-08-30T09:12:00.000Z' status: fresh metadata: {} nodeId: 5d4c3b2a-1f0e-4d9c-8b7a-6f5e4d3c2b1a score: 0.82 scores: final: 0.82 rerank: 0.85 retrieval: 0.71 text: >- From 1 March 2025, refunds are issued within 14 days of the return being received. The previous window was 30 days. - citations: - documentAssetId: a1b2c3d4-e5f6-4a7b-8c9d-0e1f2a3b4c5d documentVersion: 1 pageNumber: 3 sectionPath: - Policies - Refunds - Regional exceptions conflicts: [] freshness: sourceUpdatedAt: '2026-08-30T09:12:00.000Z' status: fresh metadata: {} nodeId: c3b2a1f0-e9d8-4c7b-8a6f-5e4d3c2b1a09 score: 0.77 scores: final: 0.77 rerank: 0.8 retrieval: 0.66 text: >- The 14-day window applies to orders shipped to the EU and the UK. Other regions keep the 30-day window until further notice. missingEvidence: [] query: >- What changed in the 2025 refund policy, and which regions are affected? state: partial knowledge_space_id: b2f1d3a4-5e6c-4a7b-8c9d-0e1f2a3b4c5d research_task_job_id: e4d1b7a2-3c5f-4d8e-9a0b-1c2d3e4f5a6b sequence: 1 - answer: >- The 2025 policy shortened the refund window from 30 days to 14 days after the return is received, effective 1 March 2025. The change applies to orders shipped to the EU and the UK; other regions keep the 30-day window. evidence_bundle: createdAt: '2026-09-06T08:00:41.000Z' id: 1f2e3d4c-5b6a-4978-8a7b-6c5d4e3f2a1b items: - citations: - artifactHash: >- 9f86d081884c7d659a2feaa0c55ad015a3bf4f1b2b0b822cd15d6c15b0f00a08 documentAssetId: a1b2c3d4-e5f6-4a7b-8c9d-0e1f2a3b4c5d documentVersion: 1 endOffset: 1978 pageNumber: 2 sectionPath: - Policies - Refunds startOffset: 1840 conflicts: - reason: >- States a 14-day window while another chunk keeps 30 days for some regions. severity: info withNodeId: c3b2a1f0-e9d8-4c7b-8a6f-5e4d3c2b1a09 freshness: observedAt: '2026-09-06T08:00:12.000Z' sourceUpdatedAt: '2026-08-30T09:12:00.000Z' status: fresh metadata: {} nodeId: 5d4c3b2a-1f0e-4d9c-8b7a-6f5e4d3c2b1a score: 0.82 scores: final: 0.82 freshness: 0.9 rerank: 0.85 retrieval: 0.71 text: >- From 1 March 2025, refunds are issued within 14 days of the return being received. The previous window was 30 days. - citations: - documentAssetId: a1b2c3d4-e5f6-4a7b-8c9d-0e1f2a3b4c5d documentVersion: 1 pageNumber: 3 sectionPath: - Policies - Refunds - Regional exceptions conflicts: [] freshness: observedAt: '2026-09-06T08:00:12.000Z' sourceUpdatedAt: '2026-08-30T09:12:00.000Z' status: fresh metadata: {} nodeId: c3b2a1f0-e9d8-4c7b-8a6f-5e4d3c2b1a09 score: 0.77 scores: final: 0.77 freshness: 0.9 rerank: 0.8 retrieval: 0.66 text: >- The 14-day window applies to orders shipped to the EU and the UK. Other regions keep the 30-day window until further notice. missingEvidence: - expectedEvidenceId: 7e6d5c4b-3a29-4180-9f8e-7d6c5b4a3928 metadata: {} reason: not-retrieved text: >- No chunk lists the effective date for regions outside the EU and the UK. query: >- What changed in the 2025 refund policy, and which regions are affected? retrievalQuery: >- 2025 refund policy changes refund window regions affected state: answerable knowledge_space_id: b2f1d3a4-5e6c-4a7b-8c9d-0e1f2a3b4c5d research_task_job_id: e4d1b7a2-3c5f-4d8e-9a0b-1c2d3e4f5a6b sequence: 2 next_cursor: null schema: properties: data: description: 结果，按 `sequence` 升序排列。 items: properties: answer: description: 任务的回答。仅在最终结果中有值，检索检查点中为 `null`。 nullable: true type: string evidence_bundle: description: >- 写入此结果时任务已收集到的检索分段。 如果某项的文档文件在检索后被删除，该项会以占位项的形式返回： - `text` 为 `Evidence deleted or unavailable`。 - `citations[]` 仅保留 `documentAssetId`、`documentVersion` 和空的 `sectionPath`。 - `conflicts` 为空。 - `freshness.status` 为 `unknown`。 - `metadata.traceEvidenceAvailability` 为 `{"status": "unavailable", "reason": "document-deleted-or-unavailable"}`。 properties: createdAt: description: 写入这组分段的时间，ISO 8601 时间戳。 type: string id: description: 这组检索分段的 ID。 type: string items: description: 检索到的分段及其分数和引用，最相关的在前。 items: properties: citations: description: 分段的出处。每项至少一条。 items: description: 偏移量基于解析后的文档文本，并非原始文件或回答中的位置。 properties: artifactHash: description: 引用所指向文档文件的 SHA-256。未记录时不返回。 type: string documentAssetId: description: >- 文档文件 ID。可通过 [获取文档文件](/zh/api-reference/documents-and-chunks/get-document-file) 读取文件名。如需查找对应的文档，将它与 `documentVersion` 一起传给 [按文件获取文档](/zh/api-reference/documents-and-chunks/get-document-by-file)。 type: string documentVersion: description: 检索时文档文件的 `version`。 type: integer endOffset: description: >- 解析后文档文本中的 UTF-8 字节偏移量，从 0 开始计数，为结束位置（不包含）。无法获取时省略。 type: integer pageNumber: description: 页码，从 1 开始，源文件提供页码信息时返回，否则省略。 type: integer sectionPath: description: 从文档根节点到被引用章节的各级章节标题。 items: type: string type: array startOffset: description: >- 解析后文档文本中的 UTF-8 字节偏移量，从 0 开始计数，为起始位置（包含）。无法获取时省略。 type: integer type: object type: array conflicts: description: 此分段与其他检索分段之间的冲突。没有冲突时为空。 items: properties: reason: description: 冲突的内容。 type: string severity: description: '`info`、`warning` 或 `blocking`。' type: string withNodeId: description: 与此分段冲突的分段的 `nodeId`。冲突不针对某一个分段时不返回。 type: string type: object type: array freshness: description: 被引用内容的时效性。 properties: observedAt: description: 最后一次观察到该内容的时间，ISO 8601 时间戳。未知时不返回。 type: string sourceUpdatedAt: description: 源内容最近一次更新的时间，ISO 8601 时间戳。未知时不返回。 type: string status: description: '`fresh`、`stale` 或 `unknown`。' type: string type: object metadata: description: >- 该项的附加详情。占位项会带有 `traceEvidenceAvailability`。 type: object nodeId: description: 检索到的分段的 ID。 type: string score: description: >- 总体相关性，取值范围为 `0` 到 `1`，与 `scores.final` 的值相同。 type: number scores: description: 分数明细，每项取值范围为 `0` 到 `1`。 properties: final: description: 用于排序的综合分数。 type: number freshness: description: 反映来源新近程度的分数。未计算时不返回。 type: number rerank: description: 重排序模型给出的分数。未执行重排序时不返回。 type: number retrieval: description: 向量检索和关键词检索给出的分数。 type: number type: object text: description: 分段文本。 type: string type: object type: array missingEvidence: description: 本次运行预期使用但未能使用的分段。没有时为空。 items: properties: expectedEvidenceId: description: 预期分段的 ID（如已知）。 type: string metadata: description: 附加详情。 type: object reason: description: >- `not-retrieved`、`permission-filtered`、`stale`、`conflict` 或 `unknown`。 type: string text: description: 缺失的内容。 type: string type: object type: array query: description: 研究问题。 type: string retrievalQuery: description: 实际发送给检索的查询文本，仅在与 `query` 不同时返回。 type: string state: description: >- 检索到的分段对回答的支撑程度：`partial`（检索检查点，尚未进行分析）、`answerable`、`not-enough-evidence`、`conflict`（来源之间存在矛盾）或 `permission-limited`（部分分段因权限被排除）。 type: string traceId: description: >- 产生这组分段的运行 ID（如有记录）。研究任务不会记录为查询记录，因此 [获取查询记录](/zh/api-reference/query-records/get-query-record) 不接受此 ID。 type: string type: object knowledge_space_id: description: 知识库的内部 ID，并非路径中的知识库 ID。 type: string research_task_job_id: description: 研究任务 ID。 type: string sequence: description: 该结果在任务中的序号，从 `1` 开始。 type: integer type: object type: array next_cursor: description: 下一页的游标，最后一页时为 `null`。将其作为 `cursor` 传回。 nullable: true type: string type: object description: 一页结果。 '400': content: application/json: examples: knowledge_fs_invalid_request: summary: knowledge_fs_invalid_request (validation) value: code: knowledge_fs_invalid_request message: Agent Knowledge Base request is invalid. status: 400 violations: - field: - limit type: less_than_equal knowledge_fs_invalid_request_path: summary: knowledge_fs_invalid_request (path ID) value: code: knowledge_fs_invalid_request message: Agent Knowledge Base request is invalid. status: 400 description: |- - `knowledge_fs_invalid_request`：请求未通过校验。`violations` 列出每个出错的字段。 - `knowledge_fs_invalid_request`：查询字符串中带有此操作不接受的参数。 - `knowledge_fs_invalid_request`：`research_task_id` 格式不正确。 '401': content: application/json: examples: knowledge_fs_invalid_credential: summary: knowledge_fs_invalid_credential value: code: knowledge_fs_invalid_credential message: Invalid Agent Knowledge Base service credential. status: 401 unauthorized: summary: unauthorized value: code: unauthorized message: Access token is invalid status: 401 description: >- - `unauthorized`：缺少 `Authorization` 请求头，或密钥无法识别、不是知识库 API 密钥。 - `knowledge_fs_invalid_credential`：密钥有效，但其所属工作空间中没有此 ID 的知识库，或该密钥未关联任何工作空间。 '403': content: application/json: examples: forbidden: summary: forbidden (rate limit) value: code: forbidden message: >- Sorry, you have reached the knowledge base request rate limit of your subscription. status: 403 knowledge_fs_access_denied: summary: knowledge_fs_access_denied (key scope) value: code: knowledge_fs_access_denied message: Agent Knowledge Base operation is not allowed. status: 403 knowledge_fs_access_denied_2: summary: knowledge_fs_access_denied (other knowledge base) value: code: knowledge_fs_access_denied failure: action: contact_admin category: authorization code: KNOWLEDGE_FS_ACCESS_DENIED message: >- You do not have permission to perform this Agent Knowledge Base operation. retryPolicy: never traceId: 602b9b60-6564-4ba7-8b59-54312d41377c message: >- You do not have permission to perform this Agent Knowledge Base operation. status: 403 description: >- - `knowledge_fs_access_denied`：该密钥的访问范围限定为其他知识库、此知识库已关闭 **API 访问**，或知识库未处于活动状态。 - `knowledge_fs_access_denied`：该任务所属的知识库与路径中的知识库不同。 - `forbidden`：在 Dify Cloud 上，工作空间已达到其订阅套餐的知识库请求频率限制。所有调用都计入，读取操作也不例外。 '404': content: application/json: examples: knowledge_fs_resource_not_found: summary: knowledge_fs_resource_not_found value: code: knowledge_fs_resource_not_found failure: category: not_found code: KNOWLEDGE_FS_NOT_FOUND message: >- The requested Agent Knowledge Base resource was not found. retryPolicy: never traceId: ca5eb2d9-4242-4950-877c-6c5207b1441e message: The requested Agent Knowledge Base resource was not found. status: 404 not_found: summary: not_found (feature off) value: code: not_found message: >- The requested URL was not found on the server. If you entered the URL manually please check your spelling and try again. status: 404 description: |- - `knowledge_fs_resource_not_found`：任务不存在、属于其他工作空间，或其所在知识库正在删除。 - `not_found`：当前部署已关闭 Agent 知识库功能。 '502': content: application/json: examples: knowledge_fs_upstream_unavailable: summary: knowledge_fs_upstream_unavailable value: code: knowledge_fs_upstream_unavailable message: Agent Knowledge Base is unavailable. status: 502 description: '- `knowledge_fs_upstream_unavailable`：未能及时收到响应，或无法读取响应。稍候重试。' '503': content: application/json: examples: knowledge_fs_operation_unavailable: summary: knowledge_fs_operation_unavailable value: code: knowledge_fs_operation_unavailable message: Agent Knowledge Base operation is not available. status: 503 knowledge_fs_operation_unavailable_upstream: summary: knowledge_fs_operation_unavailable (temporary) value: code: knowledge_fs_operation_unavailable failure: action: retry category: dependency code: KNOWLEDGE_FS_UNAVAILABLE message: >- A service required by Agent Knowledge Base is temporarily unavailable. retryPolicy: manual traceId: 5e2a9c17-3b4d-4f60-8a1b-2c3d4e5f6a7b message: >- A service required by Agent Knowledge Base is temporarily unavailable. status: 503 description: >- - `knowledge_fs_operation_unavailable`：此工作空间尚未配置 Agent 知识库功能、当前部署不提供此操作，或在请求鉴权期间该密钥对此知识库的访问权限发生了变化。 - `knowledge_fs_operation_unavailable`：暂时无法处理该请求。按 `failure.retryPolicy` 处理。 - `knowledge_fs_operation_unavailable`：该知识库由经典知识库升级而来，仍在禁用原先已禁用或已归档的文档。稍后重试。 components: securitySchemes: ApiKeyAuth: bearerFormat: API_KEY description: >- 每个请求都通过 API Key 认证：`Authorization: Bearer {API_KEY}`。应用接口使用应用 API Key，知识库接口使用知识库 API Key（[快速开始](/zh/api-reference/guides/get-started)）。 API Key 应保存在服务端，切勿嵌入客户端代码。缺失或无效的 Key 会返回 HTTP `401`（`unauthorized`）。 scheme: bearer type: http ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.