> ## 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` の昇順で一覧表示します。 タスクが書き込む結果は最大 2 つです。利用可能な場合は検索のチェックポイントが書き込まれ、その後に最終結果が続きます。`answer` は最後の結果で確認してください。早期に停止したタスクには、結果がない場合があります。 計画、作成、ポーリング、結果の読み取りの流れについては、[リサーチタスクの実行](/ja/api-reference/guides/knowledge-base#run-a-research-task) を参照してください。 ## OpenAPI ````yaml /ja/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` の昇順で一覧表示します。 タスクが書き込む結果は最大 2 つです。利用可能な場合は検索のチェックポイントが書き込まれ、その後に最終結果が続きます。`answer` は最後の結果で確認してください。早期に停止したタスクには、結果がない場合があります。 計画、作成、ポーリング、結果の読み取りの流れについては、[リサーチタスクの実行](/ja/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 です。[リサーチタスクを作成](/ja/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: 1 ページあたりのエントリ数です。 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: チャンクの出典です。各項目に 1 つ以上あります。 items: description: >- オフセットは、解析済みのドキュメントテキスト内の位置を指します。元のファイルや回答内の位置ではありません。 properties: artifactHash: description: >- 引用が指すドキュメントファイルの SHA-256 です。記録されていない場合は含まれません。 type: string documentAssetId: description: >- ドキュメントファイル ID です。ファイル名は [ドキュメントファイルを取得](/ja/api-reference/documents-and-chunks/get-document-file) で確認できます。対応するドキュメントを調べるには、この値を `documentVersion` とともに [ファイルからドキュメントを取得](/ja/api-reference/documents-and-chunks/get-document-by-file) に渡してください。 type: string documentVersion: description: 検索時点でのドキュメントファイルの `version` です。 type: integer endOffset: description: >- 解析済みドキュメントテキスト内の 0 始まりの UTF-8 バイトオフセットです。終了位置を表し、この位置自体は範囲に含みません。取得できない場合は省略されます。 type: integer pageNumber: description: >- ソースがページ情報を提供する場合のページ番号で、1 から始まります。それ以外の場合は省略されます。 type: integer sectionPath: description: ドキュメントのルートから、引用されたセクションまでのセクション見出しです。 items: type: string type: array startOffset: description: >- 解析済みドキュメントテキスト内の 0 始まりの UTF-8 バイトオフセットです。開始位置を表し、この位置自体を範囲に含みます。取得できない場合は省略されます。 type: integer type: object type: array conflicts: description: このチャンクと、ほかの検索されたチャンクとの間の矛盾です。ない場合は空です。 items: properties: reason: description: 矛盾の内容です。 type: string severity: description: '`info`、`warning`、`blocking` のいずれかです。' type: string withNodeId: description: >- このチャンクと矛盾するチャンクの `nodeId` です。矛盾が特定の 1 つのチャンクに結び付いていない場合は含まれません。 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 です（記録されている場合）。リサーチタスクはクエリ記録として記録されないため、[クエリ記録を取得](/ja/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: 1 ページ分の結果です。 '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 キーで認証します：`Authorization: Bearer {API_KEY}`。アプリのエンドポイントにはアプリの API キーを、ナレッジのエンドポイントにはナレッジベースの API キーを使用します（[Dify API クイックスタート](/ja/api-reference/guides/get-started)）。 キーはサーバーサイドで保管し、クライアントコードには決して埋め込まないでください。キーが欠落または無効なリクエストは HTTP `401`（`unauthorized`）で失敗します。 scheme: bearer type: http ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.