リサーチタスク
リサーチタスクの結果一覧を取得
リサーチタスクがこれまでに書き込んだ結果を、sequence の昇順で一覧表示します。
タスクが書き込む結果は最大 2 つです。利用可能な場合は検索のチェックポイントが書き込まれ、その後に最終結果が続きます。answer は最後の結果で確認してください。早期に停止したタスクには、結果がない場合があります。
計画、作成、ポーリング、結果の読み取りの流れについては、リサーチタスクの実行 を参照してください。
GET
/
knowledge-fs
/
spaces
/
{knowledge_base_id}
/
research-tasks
/
{research_task_id}
/
partials
リサーチタスクの結果一覧を取得
curl --request GET \
--url https://{api_base_url}/knowledge-fs/spaces/{knowledge_base_id}/research-tasks/{research_task_id}/partials \
--header 'Authorization: Bearer <token>'import requests
url = "https://{api_base_url}/knowledge-fs/spaces/{knowledge_base_id}/research-tasks/{research_task_id}/partials"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://{api_base_url}/knowledge-fs/spaces/{knowledge_base_id}/research-tasks/{research_task_id}/partials', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://{api_base_url}/knowledge-fs/spaces/{knowledge_base_id}/research-tasks/{research_task_id}/partials",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://{api_base_url}/knowledge-fs/spaces/{knowledge_base_id}/research-tasks/{research_task_id}/partials"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("Authorization", "Bearer <token>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://{api_base_url}/knowledge-fs/spaces/{knowledge_base_id}/research-tasks/{research_task_id}/partials")
.header("Authorization", "Bearer <token>")
.asString();require 'uri'
require 'net/http'
url = URI("https://{api_base_url}/knowledge-fs/spaces/{knowledge_base_id}/research-tasks/{research_task_id}/partials")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'
response = http.request(request)
puts response.read_body{
"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
}
Authorizations
すべてのリクエストは API キーで認証します：Authorization: Bearer {API_KEY}。アプリのエンドポイントにはアプリの API キーを、ナレッジのエンドポイントにはナレッジベースの API キーを使用します（Dify API クイックスタート）。
キーはサーバーサイドで保管し、クライアントコードには決して埋め込まないでください。キーが欠落または無効なリクエストは HTTP 401（unauthorized）で失敗します。
Path Parameters
ナレッジベース ID です。ナレッジベースの API アクセス ダイアログに表示されるサービス API エンドポイントの最後のセグメント（…/knowledge-fs/spaces/<knowledge base ID>）です。アドレスバーでは /datasets/new/ の後のセグメントです。
リサーチタスク ID です。リサーチタスクを作成 から取得します。
Query Parameters
不透明なカーソルです。前のページの next_cursor を変更せずに送信してください。
Required string length:
1 - 10001 ページあたりのエントリ数です。
Required range:
1 <= x <= 100Was this page helpful?
⌘I
リサーチタスクの結果一覧を取得
curl --request GET \
--url https://{api_base_url}/knowledge-fs/spaces/{knowledge_base_id}/research-tasks/{research_task_id}/partials \
--header 'Authorization: Bearer <token>'import requests
url = "https://{api_base_url}/knowledge-fs/spaces/{knowledge_base_id}/research-tasks/{research_task_id}/partials"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://{api_base_url}/knowledge-fs/spaces/{knowledge_base_id}/research-tasks/{research_task_id}/partials', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://{api_base_url}/knowledge-fs/spaces/{knowledge_base_id}/research-tasks/{research_task_id}/partials",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://{api_base_url}/knowledge-fs/spaces/{knowledge_base_id}/research-tasks/{research_task_id}/partials"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("Authorization", "Bearer <token>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://{api_base_url}/knowledge-fs/spaces/{knowledge_base_id}/research-tasks/{research_task_id}/partials")
.header("Authorization", "Bearer <token>")
.asString();require 'uri'
require 'net/http'
url = URI("https://{api_base_url}/knowledge-fs/spaces/{knowledge_base_id}/research-tasks/{research_task_id}/partials")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'
response = http.request(request)
puts response.read_body{
"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
}