# 저장 및 재사용 결과

원본 입력, 소스 링크 및 사용으로 결과를 유지하고 다른 쿼리없이 다른 프로세스로 손.

Canonical 참고: https://flashdata.dev/ko/docs/guides/save-results
검토: 2026-11-05 FlashData

<a id="realtime"></a>

## Query는 한 번, 작업을 통해 결과를 사용

보고서를 작성하고 파서를 다시 실행하거나 나중에 에이전트가 동일한 증거를 단계로합니다. 이 워크플로우는 휴대용 아카이브로 하나의 검색을 저장합니다. 아카이브가 FlashData 키 또는 원래 CLI 상태가 필요하지 않다는 것을 읽으십시오.

### 당신이 계속할 것

```text
archive/saved-search/
  request.json 본래 질문 및 모수
  response.json는 API 응답을 바꾸었습니다
  citations.ndjson 제목, 소스 URLs 및 스니펫
  manifest.json는 ID, 사용법, 파일 크기 및 SHA-256를 달립니다
```

- [Already는 async 결과를 가지고 있습니까?](https://flashdata.dev/ko/docs/guides/save-results/reference.md#jobs)
- [Bulk 데이터셋 저장](https://flashdata.dev/ko/docs/guides/save-results/reference.md#bulk)
- [다운로드 된 미디어](https://flashdata.dev/ko/docs/guides/save-results/reference.md#media)

<a id="prepare"></a>

## 시작하기 전에

새로운 작업 폴더를 사용하여 FlashData CLI는 google_search 권한 및 사용 가능한 크레딧을 사용합니다. 인증된 프로파일 또는 FLASHDATA_API_KEY를 재사용합니다. Bash 검사는 jq를 이용합니다; Windows는 PowerShell 7를 사용합니다. 로컬 아카이브 스크립트는 Python 3.10+ 및 표준 라이브러리를 사용합니다.

data.accessVerified가 true일 때 계속. CLI retries의 경우, 동일한 프로파일을 유지, OS 사용자 및 상태 디렉토리. 에이전트는 그것의 비밀 상점에서 기존의 자격에로드해야합니다.

### 자주 묻는 질문

```bash
flashdata auth status --json
```

- [CLI 설치](https://flashdata.dev/ko/docs/guides/flashdata-cli/reference.md#install)
- [API 키 생성](https://flashdata.dev/app/api-keys)
- [대신 HTTP 사용](https://flashdata.dev/ko/docs/guides/save-results/reference.md#http)

<a id="save"></a>

## 1. 입력을 유지하고 하나의 응답을 저장

request.json를 아래에서 저장하면 하나의 명령을 실행합니다. --input는이 정확한 요청을 사용합니다. --output는 search.json의 API 바디를 저장합니다. --json는 CLI 메타데이터를 인쇄합니다. 저장된 연구는이 작업의 로컬 실행 ID입니다.

### request.json

```json
{
  "source": "google_search",
  "query": "battery recycling research",
  "params": {
    "num": 5
  }
}
```

### Bash

#### 1개의 검색을 실행

```bash
flashdata query --input request.json \
  --run-id saved-search --output search.json --json
```


### PowerShell

#### 1개의 검색을 실행

```powershell
flashdata query --input request.json `
  --run-id saved-search --output search.json --json
```



<a id="inspect"></a>

## 2. 저장된 응답을 검증

기대 소스: google_search, status: done 및 결과 배열. 각 유기 결과의 제목, 링크 및 스니펫을 인쇄합니다. 실제 결과는 다를 수 있습니다. 빈 성공적인 컬렉션은 실패한 요청 또는 누락 된 필드와 다릅니다.

### Bash / jq

#### 유효하고 search.json를 읽으십시오

```bash
jq -e '.source == "google_search" and .status == "done"
  and (.results | type == "array")
  and all(.results[]; (.organic | type == "array"))' search.json > /dev/null &&
jq -c '.results[] | .organic[] | {title, link, snippet}' search.json
```


### PowerShell

#### 유효하고 search.json를 읽으십시오

```powershell
$result = Get-Content -Raw -LiteralPath search.json | ConvertFrom-Json
if ($result.source -ne 'google_search' -or $result.status -ne 'done' -or
    -not ($result.results -is [array])) {
  throw 'Inspect search.json before treating the task as complete.'
}
foreach ($page in $result.results) {
  if (-not ($page.organic -is [array])) { throw 'Missing organic results array.' }
  $page.organic | Select-Object title, link, snippet
}
```



<a id="record"></a>

## 3. 입력, 응답 및 인용을 보관

아래 archive.py를 저장하고 1를 단계로 ID를 실행합니다. 그것은 원본 파일을 보존, 소스 링크 추출 및 파일 체크섬과 사용으로 manifest.json를 작성. 예상 complete: true; 인용 수는 검색 결과에 따라 달라집니다. 네트워크 요청이 없습니다.


<a id="archive-script"></a>

### 저장 archive.py

request.json 및 search.json와 같은 archive.py를 작업 폴더에 생성합니다. 아래의 전체 코드를 복사하고 저장합니다.

예 아카이브 Google Search 결과. 관행된 관행은 intact에 보관됩니다. request.json, search.json를 유지하고 완성을 아카이브 할 때까지 매칭 실행합니다.

#### archive.py

```python
# archive.py — Python 3.10+, standard library only; no network requests.
import argparse
import hashlib
import json
import re
from datetime import datetime, timezone
from pathlib import Path
from urllib.parse import urlsplit

parser = argparse.ArgumentParser()
parser.add_argument('--run-id', required=True)
args = parser.parse_args()
if not re.fullmatch(r'[A-Za-z0-9_-]+', args.run_id):
    raise ValueError('Use the CLI run ID from this task.')
request_bytes = Path('request.json').read_bytes()
result_bytes = Path('search.json').read_bytes()
request = json.loads(request_bytes.decode('utf-8-sig'))
result = json.loads(result_bytes.decode('utf-8-sig'))
if (request.get('source') != 'google_search' or result.get('source') != request['source']
        or result.get('status') not in ['done', 'completed']
        or not isinstance(result.get('results'), list)):
    raise ValueError('Inspect the request and result before archiving.')
citations = []
for page in result['results']:
    if not isinstance(page, dict) or not isinstance(page.get('organic'), list):
        raise ValueError('Expected an organic results array, including when it is empty.')
    for item in page['organic']:
        if not isinstance(item, dict) or not isinstance(item.get('link'), str):
            raise ValueError('A result is missing its source URL.')
        url = urlsplit(item['link'])
        if url.scheme not in ['http', 'https'] or not url.netloc:
            raise ValueError('Inspect an unexpected source URL.')
        citations.append({key: item.get(key, '') for key in ['title', 'link', 'snippet']})
files = {'request.json': request_bytes, 'response.json': result_bytes,
         'citations.ndjson': ''.join(json.dumps(row, ensure_ascii=False) + '\n'
                                    for row in citations).encode('utf-8')}
manifest = {'version': 1, 'run_id': args.run_id, 'source': request['source'],
            'archived_at': datetime.now(timezone.utc).isoformat(),
            'usage': result.get('usage'), 'citation_count': len(citations),
            'files': {name: {'bytes': len(data), 'sha256': hashlib.sha256(data).hexdigest()}
                      for name, data in files.items()}}
folder = Path('archive') / args.run_id
folder.mkdir(parents=True)  # Existing archives are preserved. Choose a new run ID for new work.
for name, data in files.items():
    with (folder / name).open('xb') as output:
        output.write(data)
# Write the manifest last. Without it, the archive is incomplete.
with (folder / 'manifest.json').open('x', encoding='utf-8') as output:
    json.dump(manifest, output, ensure_ascii=False, indent=2)
print(json.dumps({'archive': str(folder), 'citations': len(citations), 'complete': True}))
```


<a id="run-archive"></a>

### 아카이브 만들기

archive.py, request.json 및 search.json를 포함하는 폴더에서 실행하십시오.

#### Bash

##### 새로운 아카이브를 구축

```bash
python3 archive.py --run-id saved-search
```


#### PowerShell 7

##### 새로운 아카이브를 구축

```powershell
python archive.py --run-id saved-search
```



<a id="reuse"></a>

## 4. credentials없이 아카이브를 재사용

아래 reuse.py를 저장하십시오. 필요한 프로세스에 완전한 archive/saved-search 폴더를 복사하면이 리더를 실행합니다. 원본 쿼리, 사용 및 인용을 인쇄하기 전에 모든 파일을 확인합니다. API-key 재발급 또는 호스팅-result expiry가 저장된 복사만 읽기 때문에 작동합니다.


<a id="reuse-script"></a>

### 저장 reuse.py

archive/.를 포함하는 작업 폴더에서 reuse.py를 만듭니다 다른 기계에서 reuse.py와 완전한 archive/saved-search 디렉토리를 모두 복사하여이 레이아웃을 유지하십시오.

#### reuse.py

```python
# reuse.py — run without a FlashData key or CLI.
import hashlib
import json
import sys
from pathlib import Path

folder = Path(sys.argv[1])
manifest = json.loads((folder / 'manifest.json').read_text(encoding='utf-8'))
expected = {'request.json', 'response.json', 'citations.ndjson'}
if manifest.get('version') != 1 or set(manifest.get('files', {})) != expected:
    raise ValueError('Unknown or incomplete archive manifest.')
files = {}
for name in sorted(expected):
    data = (folder / name).read_bytes()
    record = manifest['files'][name]
    if len(data) != record['bytes'] or hashlib.sha256(data).hexdigest() != record['sha256']:
        raise ValueError('Archive changed or was not fully copied: ' + name)
    files[name] = data
request = json.loads(files['request.json'].decode('utf-8-sig'))
citations = [json.loads(line) for line in files['citations.ndjson'].decode('utf-8').splitlines()]
if len(citations) != manifest['citation_count']:
    raise ValueError('Citation count does not match the manifest.')
print(json.dumps({'run_id': manifest['run_id'], 'query': request['query'],
                  'archived_at': manifest['archived_at'], 'usage': manifest['usage'],
                  'citations': citations}, indent=2))
```


<a id="read-archive"></a>

### 저장된 아카이브 읽기

reuse.py를 저장하고, 그 폴더에서 실행합니다. 마지막 인수는 복사 된 아카이브 경로입니다.

#### Bash

##### 복사 된 아카이브 읽기

```bash
python3 reuse.py archive/saved-search
```


#### PowerShell 7

##### 복사 된 아카이브 읽기

```powershell
python reuse.py archive/saved-search
```



<a id="cli-cache"></a>

### 대신 CLI 저널에서 내보내기

CLI 프로파일과 state 디렉토리를 가지고 있다면, 저장된 실행을 새 파일 이름으로 내보내십시오. 이것은 새로운 쿼리를 만들지 만, 그것은 첫 번째 라이브 액세스를 정의합니다. 기존의 결과 파일 또는 아카이브는 해당 검사없이 로컬로 읽을 수 있습니다.

#### 완료된 실행 내보내기

```bash
flashdata runs show saved-search --result --output search-copy.json --json
```


<a id="freshness"></a>

## 재사용하거나 새로 고침할 때 결정

archived_at 레코드를 저장할 때, 소스 페이지가 변경 될 때. 귀하의 응용 프로그램은 최근 증거가 있어야하는 방법을 결정합니다. 파일을 복사하면 내용을 새로 고침하지 않습니다.

| 의논하기 | 조치 |
| --- | --- |
| 파서를 다시 실행, 보고서를 재생하거나 에이전트 단계를 계속 | 저장된 응답을 재사용합니다. 소스를 유지 URLs, 쿼리 매개 변수 및 사용. |
| 새로운 일일 간결을 생성하거나 변경된 쿼리에 응답 | 새로운 task/run ID, 작업 폴더 및 아카이브를 만듭니다. 이전 스냅샷을 역사로 유지하십시오. |
| 파생된 파일에 걸쳐 사용 | 한 번에 원래 쿼리를 계산합니다. 응답을 복사하거나 다른 보고서를 작성하지 않습니다 다른 충전. |

- [작업 및 실행 IDs](https://flashdata.dev/ko/docs/guides/recurring-tasks/reference.md)
- [기존의 결과](https://flashdata.dev/ko/docs/guides/response-formats/reference.md#completed-results)

<a id="retention"></a>

## 만료되는 것을 알기

| 제품정보 | 계속하기 | 관련 기사 |
| --- | --- | --- |
| Realtime 쿼리 | 응답 파일 및 원본 입력 | 저장된 사본은 저장 정책을 따릅니다 |
| Async/Batch 일 | ID, 제출 영수증 및 결과 JSON | 완료 후 24 시간 |
| Bulk | 모든 NDJSON 부품 | 24 전체 작업이 완료된 후 시간; expiresAt 확인 |
| YouTube Download | 납품 당신의 목적지에 있는 JSON와 매체 | 납품 JSON: 일 보유. 미디어: 당신의 물통 lifecycle |
| MCP 펑크 캐시 | 완전히 조립 된 결과 | 10 분; API 열쇠 당 4개의 가장 새로운 큰 결과만 유지됩니다 |


<a id="sidecar"></a>

## 대신 작은 sidecar 유지

원래의 응답을 변경하지 마십시오. 입력, 소스, 저장 시간 및 사용으로 작은 sidecar를 저장하므로 나중에 프로세스가 생성 된 파일을 이해할 수 있습니다. 결과를 변환 할 때 소스 URLs 및 비디오 타임스탬프를 유지하십시오.

### Bash / jq · search-record.json

```bash
(
set -euC
jq --arg run_id 'saved-search' --slurpfile request request.json \
  '{run_id: $run_id, source, input: $request[0],
    saved_at: (now | todateiso8601), result_file: "search.json", usage}' \
  search.json > search-record.json
cat search-record.json
)
```


<a id="http"></a>

## HTTP에 직접 저장

CLI 쿼리 대신이를 사용하십시오. 1. 동일한 request.json를 첫째로 저장하십시오; 이것은 Bash, cURL 7.76+ 및 jq를 사용하여 1개의 새로운 조회를 실행합니다. FLASHDATA_API_KEY를 재사용하고 search.json없이 폴더를 선택하십시오. 유효성 검사 후, 동일한 아카이브 스크립트는이 결과와 함께 작동합니다. --run-id에 대한 자신의 작업 ID를 선택하십시오.

nonzero cURL 출구는 결과를 사용할 준비가되지 않습니다. 재발송하기 전에 저장된 응답을 검사하십시오; 조회가 받아들여진 후에 연결 timeout는 일어날 수 있습니다. 2 단계의 유효성 명령을 사용하십시오.

### 필요한 경우 키 설정

```bash
# Bash: paste the key into a hidden prompt, not into this command.
read -r -s -p "FlashData API key: " FLASHDATA_API_KEY
printf '\n'
export FLASHDATA_API_KEY
```

### API 응답 저장

```bash
(
set -euC
: "${FLASHDATA_API_KEY:?Set FLASHDATA_API_KEY first}"
test -f request.json
curl --fail-with-body --silent --show-error --max-time 120 \
  --request POST 'https://data.flashdata.dev/v1/queries/realtime' \
  --header "X-API-Key: $FLASHDATA_API_KEY" \
  --header 'Content-Type: application/json' --header 'Accept: application/json' \
  --data-binary @request.json > search.json
jq . search.json
)
```


<a id="jobs"></a>

## 기존의 배경 작업을 저장

동기화 가이드에서 submission.json를 사용하고 동일한 계정 자격 증명을 사용하십시오. 이 명령은 기존 작업을 검색; 그들은 다른 쿼리를 제출하지 않습니다. CLI는 완료 및 결과 리디렉션을 처리합니다. 24 시간 내에 결과를 저장하십시오.

### CLI + jq

#### 대기, 검색 및 저장

```bash
(
set -euC
JOB_ID=$(jq -er '.remoteId // .id // .submission.id' submission.json)
flashdata jobs wait "$JOB_ID" --json
flashdata jobs result "$JOB_ID" --output job-result.json --json
jq '{source, status, results, usage}' job-result.json
)
```


### HTTP / cURL

작업이 완료되지 않은 경우 상태 체크가 중지됩니다. 아직도 퀴즈 또는 실행중인 경우, 대기하고이 읽기 전용 스니펫을 다시 실행하십시오. 대신 실패한 일을 검사합니다. 302는 API 열쇠를 전달하지 않고 다운로드됩니다. 임시 응답은 job-result.json가 생성되기 전에 유효합니다.

#### Bash · cURL + jq

```bash
(
set -euC
: "${FLASHDATA_API_KEY:?Set FLASHDATA_API_KEY first}"
test ! -e job-result.json || { echo 'Choose a new output filename.' >&2; exit 1; }
JOB_ID=$(jq -er '.remoteId // .id // .submission.id' submission.json)
printf '%s' "$JOB_ID" | grep -Eq '^[A-Za-z0-9_-]+$'
SOURCE=$(jq -er '(.submission // .).source' submission.json)
API="https://api.flashdata.dev/v2/jobs/$JOB_ID"
curl --fail-with-body --silent --show-error \
  --max-time 30 --header "X-API-Key: $FLASHDATA_API_KEY" "$API" >| job-status.json
jq -e --arg id "$JOB_ID" --arg source "$SOURCE" \
  '.job.id == $id and .job.source == $source and .job.status == "completed"' job-status.json >/dev/null
STATUS=$(curl --silent --show-error \
  --header "X-API-Key: $FLASHDATA_API_KEY" \
  --max-time 120 --dump-header result-headers.txt --output job-result.pending \
  --write-out '%{http_code}' "$API/results")
case "$STATUS" in
  200) ;;
  302)
    LOCATION=$(awk 'tolower($1) == "location:" { sub(/\r$/, "", $2); print $2 }' result-headers.txt)
    # No FlashData API key on the signed storage request.
    curl --fail-with-body --silent --show-error --compressed --max-time 120 \
      --proto '=https' --output job-result.pending "$LOCATION" ;;
  *) echo "HTTP $STATUS: inspect job-result.pending and result-headers.txt." >&2; exit 1 ;;
esac
jq -e --arg source "$SOURCE" '.source == $source and (.status == "done" or .status == "completed")
  and (.results | type == "array")' job-result.pending >/dev/null
cat job-result.pending > job-result.json
jq '{source, status, results, usage}' job-result.json
)
```


- [기존의 동기화 작업을 재개](https://flashdata.dev/ko/docs/guides/async-batch/reference.md#resume)
- [결과 응답 계약](https://flashdata.dev/ko/docs/reference/realtime-and-async/reference.md#results)
- [Markdown로 검색](https://flashdata.dev/ko/docs/guides/response-formats/reference.md#completed-results)

<a id="bulk"></a>

## 모든 Bulk 결과 저장

제출 영수증에 ID와 BULK_ID를 대체하십시오. 작업이 완료되면 CLI는 표시를 따르고 모든 부분을 하나의 NDJSON 파일로 저장합니다. 계산과 파트 메타데이터가 필요할 때도 나타날 수 있습니다.

파일은 모두 성공적이고 실패한 행을 포함 할 수 있습니다. 전체적인 작업을 완료하기 전에 Reconcile 입력 인덱스 및 계산. 하나의 실패 행을 복구하는 전체 입력 파일을 다시 실행하지 마십시오.

### 완료된 작업을 수집

```bash
flashdata bulk results BULK_ID --output bulk-results.ndjson --timeout 30m --json
```

- [수입하기 전에 모든 입력을 확인합니다](https://flashdata.dev/ko/docs/guides/bulk/reference.md#audit)
- [가장, 조사 및 NDJSON](https://flashdata.dev/ko/docs/reference/bulk-processing/reference.md#downloadBulkJobManifest)

<a id="media"></a>

## 배송 기록 및 미디어 유지

delivery.json는 납품 기록, 영상 또는 오디오 바이트 아닙니다 포함합니다. 작업에 따라 URL, 크기 및 체크섬을 저장하십시오. 미디어는 목적지 저장에 살고 있으며 그 저장 수명주기를 따르십시오.

개인 대상을 위해 공급자의 자격 증명 또는 서명 URL를 사용하여 객체를 검사합니다. 저장된 임시 결과 JSON는 저장된 매체가 삭제된 것을 의미하지 않습니다.

### 저장된 다운로드 결과 검사 · jq

```bash
jq '.results[] | {file_url, file_size, md5, downloaded_bytes, output_format}' delivery.json
```

- [크기, 체크섬 및 미디어를 검증](https://flashdata.dev/ko/docs/guides/youtube-download-guide/reference.md#verify-media)

<a id="mcp"></a>

## 저장하기 전에 MCP 펑크를 조립

도구가 result_id, 펑크 및 next_offset를 반환하면 동일한 API 키를 사용하여 get_result와 나머지 펑크를 읽습니다. 툴에 의해 반환된 정확한 next_offset를 사용하십시오; 아래 값은 위주인입니다.

1. 오프셋 주문에서 각 펑크를 승인합니다. next_offset를 따라 null입니다.
2. JSON로 한 번 가입된 텍스트를 파싱한 다음 자신의 파일이나 저장에 전체 결과를 작성합니다.
3. expires_at 전에 저장하십시오. 새로운 큰 응답은 10-minute 한계의 앞에 오래된 결과를 퇴치할 수 있습니다; 캐시는 API 열쇠 당 4를 지킵니다.

### MCP tools/call 인수

```json
{
  "name": "get_result",
  "arguments": {
    "result_id": "RESULT_ID_FROM_TOOL",
    "offset": 16000
  }
}
```

- [Runnable MCP 클라이언트와 펑크 수집](https://flashdata.dev/ko/docs/guides/mcp-custom-client/reference.md)

<a id="recovery"></a>

## 문제 해결 및 재평가 문제

| 의 의 | 해결 |
| --- | --- |
| 이미 출력 파일이 있습니다 | 먼저 검사합니다. 완료된 CLI 실행을 위해, 다른 쿼리를 제출하는 대신 새로운 출력 파일 이름을 가진 runs show를 사용하십시오. |
| CLI는 실행할 수 없습니다 | 원래 OS 사용자, 프로필 및 상태 디렉토리를 사용하십시오. 원격 작업 ID를 유지하면 직접 작업을 검색합니다. |
| 재사용에 401/403 | flashdata auth status --json를 실행하고 유효한 접근을 복원하십시오. 이미 저장된 로컬 파일은 여전히 API 액세스없이 읽을 수 있습니다. |
| 409 / 410 | 409: 기존의 작업을 기다립니다. 410: 저장된 복사본을 사용; 임시 결과는 만료되었습니다. |
| 쿼리 후 디스크 오류 | 실행을 유지 ID 또는 작업 ID. 저장을 수정하고 새로운 제출을 고려하기 전에 기존 작업을 복구합니다. |
| Archive는 현명하거나 체크섬이 실패하지 않습니다 | 다시 원본 파일을 복원하거나 복사합니다. 검사를 위해 불완전한 아카이브를 지키십시오; 아카이브를 재건하는 것은 새로운 조회를 요구하지 않습니다. |
| MCP · result_unavailable | 결과 확인 ID, 오프셋, API 키와 만료. 캐시가 만료된 경우 저장된 복사본을 사용하십시오. 지불한 쿼리를 반복해서 루프를 하지 마십시오. |

- [CLI 복구 명령](https://flashdata.dev/ko/docs/guides/cli-automation/reference.md#recover)
- [자주 묻는 질문](https://flashdata.dev/ko/docs/guides/troubleshooting/reference.md)
