본문으로 건너뛰기
KO
API 키 받기
문서 둘러보기

가이드

저장 및 재사용 결과

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

이 페이지의 내용

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

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

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

시작하기 전에

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

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

자주 묻는 질문
flashdata auth status --json

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

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

request.json
{
  "source": "google_search",
  "query": "battery recycling research",
  "params": {
    "num": 5
  }
}
1개의 검색을 실행
flashdata query --input request.json \
  --run-id saved-search --output search.json --json

2. 저장된 응답을 검증

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

유효하고 search.json를 읽으십시오
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

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

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

저장 archive.py

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

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

archive.py
# 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}))

아카이브 만들기

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

새로운 아카이브를 구축
python3 archive.py --run-id saved-search

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

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

저장 reuse.py

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

reuse.py
# 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))

저장된 아카이브 읽기

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

복사 된 아카이브 읽기
python3 reuse.py archive/saved-search

대신 CLI 저널에서 내보내기

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

완료된 실행 내보내기
flashdata runs show saved-search --result --output search-copy.json --json

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

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

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

만료되는 것을 알기

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

대신 작은 sidecar 유지

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

Bash / jq · search-record.json
(
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
)

HTTP에 직접 저장

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

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

필요한 경우 키 설정
# 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 응답 저장
(
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
)

기존의 배경 작업을 저장

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

대기, 검색 및 저장
(
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
)

모든 Bulk 결과 저장

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

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

완료된 작업을 수집
flashdata bulk results BULK_ID --output bulk-results.ndjson --timeout 30m --json

배송 기록 및 미디어 유지

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

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

저장된 다운로드 결과 검사 · jq
jq '.results[] | {file_url, file_size, md5, downloaded_bytes, output_format}' delivery.json

저장하기 전에 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 인수
{
  "name": "get_result",
  "arguments": {
    "result_id": "RESULT_ID_FROM_TOOL",
    "offset": 16000
  }
}

문제 해결 및 재평가 문제

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