# Simpan dan gunakan kembali hasil

Agar hasilnya tetap hasilnya dengan input aslinya, link sumber dan penggunaan, kemudian serahkan ke proses lain tanpa pertanyaan lain.

Referensi boonical: https://flashdata.dev/ms/docs/guides/save-results
Diulas: 2026-11-05 oleh FlashData

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

## Sekali kueri, gunakan hasilnya di seberang tugas

Buat laporan, jalankan kembali pengurai Anda atau berikan agen kemudian langkah bukti yang sama. Aliran kerja ini menyimpan satu pencarian sebagai arsip portabel; membaca bahwa arsip tidak membutuhkan kunci FlashData maupun keadaan CLI asli.

### Apa yang akan kau simpan

```text
archive/saved-search/
  request.json        Pertanyaan dan parameter asli lema
  Respon response.json tidak berubah API
  citations.ndjson    Gelar, sumber URLs snippet dan snippet
  manifest.json jalankan ID, penggunaan, ukuran berkas dan SHA-256
```

- [Sudah ada hasil sinkronisasinya?](https://flashdata.dev/ms/docs/guides/save-results/reference.md#jobs)
- [Simpan dataset Bulk](https://flashdata.dev/ms/docs/guides/save-results/reference.md#bulk)
- [Simpan media unduhan](https://flashdata.dev/ms/docs/guides/save-results/reference.md#media)

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

## Sebelum kau mulai

Kegunaan sebuah folder kerja baru, FlashData CLI dengan izin google_search dan kredit yang tersedia. Gagal menggunakan kembali sebuah profil terotentikasi atau FLASHDATA_API_KEY. Pemeriksaan Bash menggunakan jq; Windows organ PowerShell 7. script arsip lokal menggunakan Python 3.10+ dan perpustakaan standarnya.

Teruskan ketika data.accessVerified adalah true. Untuk CLI retries, simpan profil yang sama, OS user dan direktori state. Seorang agen harus memuat bukti yang ada dari toko rahasianya.

### Periksa akses tersimpan Anda

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

- [Pasang CLI](https://flashdata.dev/ms/docs/guides/flashdata-cli/reference.md#install)
- [Xachive membuat kunci API](https://flashdata.dev/app/api-keys)
- [Sebaliknya gunakan HTTP](https://flashdata.dev/ms/docs/guides/save-results/reference.md#http)

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

## 1. Mengekalkan masukan dan menyimpan satu respon

Simpan request.json di bawah, kemudian jalankan satu perintah. --input menggunakan permintaan yang tepat ini; jaga berkas tidak berubah setelah itu. --output menyimpan badan API dalam search.json; --json cetak metadata CLI. pencarian- tersimpan adalah tugas ini menjalankan lokal ID.

### request.json

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

### Bash

#### \"Takkan Satu Pencarian\".

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


### PowerShell

#### \"Takkan Satu Pencarian\".

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



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

## 2. Sahkan tanggapan yang disimpan

Sumber ekspektasi: google_search, status: done dan sebuah array hasil. Cetakan masing-masing hasil organik judul, tautan dan snippet. Hasil aktual bervariasi; koleksi yang sukses kosong berbeda dengan permintaan gagal atau medan yang hilang.

### Bash / jq

#### Sahkan dan baca 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

#### Sahkan dan baca 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. Arsipkan masukan, respon dan kutipan

Simpan archive.py di bawah, kemudian jalankan dengan menjalankan ID dari langkah 1. Ia melestarikan berkas mentah, mengekstrak sumber link dan menulis manifest.json terakhir dengan checksum file dan penggunaan. Expect complete: true; jumlah kutipan tergantung pada hasil pencarian. Tidak ada permintaan jaringan yang dibuat.


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

### Simpan archive.py

Aisex archive.py di samping request.json dan search.json di dalam folder kerja anda. Salin kode lengkap di bawah ke dalamnya dan menyimpannya.

archive contoh hasil Google Search. Direktori arsip yang telah ada disimpan secara utuh. Tetap jaga request.json, search.json dan pasangannya berjalan bersama-sama sampai pengarsipan selesai.

#### 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>

### Buat arkib

Jalankan dari folder yang berisi archive.py, request.json dan search.json.

#### Bash

##### Bina arkib baru

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


#### PowerShell 7

##### Bina arkib baru

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



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

## 4. Francy Memanfaatkan ulang arsip tanpa kredensial

Simpan reuse.py dibawah. Salin folder archive/saved-search lengkap ke proses yang membutuhkannya, kemudian jalankan pembaca ini. Ini membenarkan setiap berkas sebelum mencetak pertanyaan asli, penggunaan dan kutipan. Ini bekerja setelah API-key pembatalan atau hosting-result expiry karena hanya membaca salinan disimpan Anda.


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

### Simpan reuse.py

Cipta reuse.py Di dalam folder kerja yang berisi archive/. Pada mesin lain, salin kedua reuse.py dan lengkap direktori archive/saved-search, menjaga bentangan ini.

#### 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>

### Membaca arsip yang disimpan

Simpan reuse.py, kemudian jalankan dari foldernya. Argumen terakhir adalah jalur ke arsip salinan.

#### Bash

##### Membaca arsip yang disalin itu

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


#### PowerShell 7

##### Membaca arsip yang disalin itu

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



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

### Ekspor dari jurnal CLI sebagai gantinya

Jika Anda masih memiliki profil CLI asli dan direktori negara, ekspor yang disimpan dijalankan ke nama berkas baru. Ini tidak membuat pertanyaan baru, tapi itu membenarkan akses langsung pertama. Berkas hasil atau arsip yang ada dapat dibaca secara lokal tanpa pemeriksaan itu.

#### Eksport Ekspor export yang selesai dijalankan

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


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

## Putuskan kapan untuk digunakan kembali atau segarkan

Catatan archived_at ketika Anda menyimpan berkas, bukan ketika halaman sumber berubah. Aplikasi Anda memutuskan bagaimana bukti baru-baru ini harus; menyalin berkas tidak menyegarkan isinya.

| Task | Aksi |
| --- | --- |
| Anda dapat menjalankan ulang parser, membuat ulang laporan atau melanjutkan langkah agen | Memanfaatkan kembali respon yang disimpan. Simpan sumber URLs, parameter pertanyaan dan penggunaan bersamanya. |
| Buku harian yang baru akan diadakan atau menjawab pertanyaan yang telah diubah | Aisex membuat task/run ID baru, folder kerja dan arsip. Jaga snapshots yang lebih tua sebagai sejarah. |
| Penghitungan penggunaan di seluruh berkas turunan | Hitung pertanyaan aslinya sekali. Penyalinan tanggapan atau membuat laporan lain tidak menciptakan muatan lain. |

- [ULANG tugas dan jalankan IDs](https://flashdata.dev/ms/docs/guides/recurring-tasks/reference.md)
- [Semua hasil format yang ada](https://flashdata.dev/ms/docs/guides/response-formats/reference.md#completed-results)

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

## Kenal apa yang berakhir

| Hasil | Apa yang harus disimpan | Retensi Plak |
| --- | --- | --- |
| Pertanyaan Realtime | Berkas respon dan input asli dari A.S | Salinan tersimpan Anda mengikuti kebijakan penyimpanan Anda |
| Async / Batch Pekerjaan | Yob ID, penerimaan dan hasil pengiriman JSON | 24 jam sesudah selesai |
| Bulk | Manifest dan semua bagian NDJSON | 24 Jam setelah seluruh pekerjaan selesai; cek expiresAt |
| YouTube Download | Pengiriman JSON dan media di tujuan Anda | Pengiriman JSON: retensi kerja. Media Media: daur hidup ember Anda |
| cache cebisan MCP | Hasil yang dirakit sepenuhnya | menit 10; hanya empat hasil besar terbaru per kunci API dipertahankan |


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

## Sebaliknya, jaga mobil kecil

Tetap jaga respon asli tidak berubah. Simpan sebuah sidecar kecil dengan input, sumber, waktu simpan dan penggunaan sehingga proses selanjutnya dapat memahami apa yang menghasilkan berkas tersebut. Simpan sumber URLs dan setem waktu video ketika mengubah hasil.

### 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>

## Simpan secara langsung dengan HTTP

CLIQ dalam langkah 1. Simpan request.json yang sama terlebih dahulu; ini menjalankan satu pertanyaan baru menggunakan Bash, cURL 7.76+ dan jq. ¡Reuse FLASHDATA_API_KEY dan pilih folder tanpa search.json. Setelah validasi oleh Ázía, skrip arsip yang sama bekerja dengan hasil ini; pilih tugas Anda sendiri ID untuk --run-id.

Sebuah exit non-nol cURL berarti hasilnya belum siap digunakan. Periksa respon yang disimpan sebelum mencoba lagi; tenggat sambungan dapat terjadi setelah sebuah pertanyaan diterima. Use perintah validasi dalam langkah 2.

### Kehendaki kunci anda jika diperlukan

```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
```

### Simpan respon 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>

## Simpan pekerjaan latar belakang yang sudah ada

Use submission.json dari panduan async dan kredensial akun yang sama. Perintah - perintah ini mengambil kembali pekerjaan yang ada; mereka tidak mengajukan pertanyaan lain. XACLI menunggu penyelesaian dan menangani redirect hasil. Simpan hasil dalam waktu 24 jam penyelesaian.

### CLI + jq

#### Tunggu, ambil dan simpan

```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

Pemeriksaan status berhenti jika pekerjaan belum selesai. Jika masih dibaris gilir atau berjalan, tunggu dan jalankan snippet baca-saja ini lagi; periksa pekerjaan yang gagal sebagai gantinya. 302 telah diunduh tanpa meneruskan kunci API anda. Respons sementara divalidasi sebelum job-result.json dibuat.

#### 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
)
```


- [Kembali ke pekerjaan segerak yang sudah ada](https://flashdata.dev/ms/docs/guides/async-batch/reference.md#resume)
- [Kontrak respon hasil produksi](https://flashdata.dev/ms/docs/reference/realtime-and-async/reference.md#results)
- [Retrievee sebagai Markdown](https://flashdata.dev/ms/docs/guides/response-formats/reference.md#completed-results)

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

## Simpan setiap bagian hasil Bulk

Gantikan BULK_ID dengan ID dalam penerimaan anda. Setelah pekerjaan selesai, CLI mengikuti manifes dan menyimpan setiap bagian sebagai satu berkas NDJSON. Pastikan manifest juga ketika Anda perlu menghitung dan sebagian metadata.

Berkas tersebut dapat berisi baik baris yang sukses maupun gagal. Masukan reconcile indeks dan hitungan sebelum menandai seluruh tugas selesai. Jangan jalankan ulang seluruh berkas masukan untuk memulihkan satu baris yang gagal.

### Pengumpulan pekerjaan selesai

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

- [Periksa setiap input sebelum import](https://flashdata.dev/ms/docs/guides/bulk/reference.md#audit)
- [Manifes, hitung dan NDJSON](https://flashdata.dev/ms/docs/reference/bulk-processing/reference.md#downloadBulkJobManifest)

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

## Simpan catatan pengiriman dan media

delivery.json berisi rekaman pengiriman, bukan video atau audio byte. Simpan URL-nya, ukuran dan hasil tambah semak di samping tugas. Media tinggal di tempat penyimpanan tujuanmu dan mengikuti daur hidup penyimpanan itu.

Untuk tujuan pribadi, gunakan kelayakan penyedia tersebut atau menandatangani URL untuk memeriksa objek tersebut. Hasil sementara yang hilang JSON tidak berarti media tersimpan Anda dihapus.

### Periksalah suatu hasil Download tersimpan · jq

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

- [Ukuran tentusah, checksum dan media](https://flashdata.dev/ms/docs/guides/youtube-download-guide/reference.md#verify-media)

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

## Alih alihkan bahagian MCP sebelum menyimpan

Saat sebuah alat mengembalikan result_id, potongan dan next_offset, baca sisa potongan dengan get_resultQ menggunakan kunci API yang sama. Gunakan next_offset yang tepat yang dikembalikan oleh alat; nilai di bawah adalah placeholder.

1. Tambahkan setiap potongan dalam susunan ofset. Ikuti next_offset sampai null.
2. Parse teks bergabung sekali sebagai JSONLalu tulis hasil lengkap ke berkas atau penyimpananmu sendiri.
3. Simpan sebelum expires_at. Respon besar baru yang baru dapat mengusir hasil yang lebih tua sebelum batas 10-minute; cache menyimpan empat per kunci API.

### MCP tools/call argumen irC

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

- [Runonable MCP client dengan koleksi chunk](https://flashdata.dev/ms/docs/guides/mcp-custom-client/reference.md)

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

## Baiki masalah penyimpanan dan pengambilan kembali

| Problem | Fix |
| --- | --- |
| Berkas keluaran fanifine sudah ada | Periksa dulu. Untuk CLI yang telah selesai dijalankan, gunakan runs show dengan nama berkas keluaran baru daripada mengajukan pertanyaan lain. |
| CLI tidak dapat menemukan larian | Use the original OS, profile and state directory. Jika kau tetap punya pekerjaan jauh ID, dapatkan pekerjaan itu secara langsung. |
| 401 / 403 Diguna ulang | Name auth status --json Dan mengembalikan akses yang valid. Sebuah berkas lokal yang sudah disimpan masih dapat dibaca tanpa akses API. |
| 409 / 410 | 409: tunggu pekerjaan yang sudah ada. 410: gunakan salinan tersimpan Anda; hasil sementara telah berakhir. |
| Kesalahan disk phyfig setelah pertanyaan | Tetap jalankan ID atau pekerjaan ID. Fix penyimpanan dan memulihkan pekerjaan yang sudah ada sebelum mempertimbangkan penyerahan baru. |
| Arsip Fagodi tidak memiliki manifes atau checksum gagal | Pulihkan atau salin file asli lagi. WHO Simpan arsip tidak lengkap untuk pemeriksaan; membangun ulang arsip tidak memerlukan pertanyaan baru. |
| MCP · result_unavailable | Periksa hasil ID, offset, kunci API dan expiry. Gunakan salinan tersimpan jika cache telah berakhir; jangan loop dengan mengulangi pertanyaan terbayar. |

- [Perintah pemulihan CLI](https://flashdata.dev/ms/docs/guides/cli-automation/reference.md#recover)
- [Permintaan permintaan troubIeshooting](https://flashdata.dev/ms/docs/guides/troubleshooting/reference.md)
