Langkau ke kandungan
MS
Dapatkan kunci API
Semak dokumentasi

Panduan

Simpan dan gunakan kembali hasil

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

Pada halaman ini

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

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
flashdata auth status --json

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
{
  "source": "google_search",
  "query": "battery recycling research",
  "params": {
    "num": 5
  }
}
\"Takkan Satu Pencarian\".
flashdata query --input request.json \
  --run-id saved-search --output search.json --json

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.

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

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

Buat arkib

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

Bina arkib baru
python3 archive.py --run-id saved-search

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.

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

Membaca arsip yang disimpan

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

Membaca arsip yang disalin itu
python3 reuse.py archive/saved-search

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
flashdata runs show saved-search --result --output search-copy.json --json

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.

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

Kenal apa yang berakhir

HasilApa yang harus disimpanRetensi Plak
Pertanyaan RealtimeBerkas respon dan input asli dari A.SSalinan tersimpan Anda mengikuti kebijakan penyimpanan Anda
Async / Batch PekerjaanYob ID, penerimaan dan hasil pengiriman JSON24 jam sesudah selesai
BulkManifest dan semua bagian NDJSON24 Jam setelah seluruh pekerjaan selesai; cek expiresAt
YouTube DownloadPengiriman JSON dan media di tujuan AndaPengiriman JSON: retensi kerja. Media Media: daur hidup ember Anda
cache cebisan MCPHasil yang dirakit sepenuhnyamenit 10; hanya empat hasil besar terbaru per kunci API dipertahankan

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
(
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
)

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: 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
(
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
)

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.

Tunggu, ambil dan simpan
(
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
)

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
flashdata bulk results BULK_ID --output bulk-results.ndjson --timeout 30m --json

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
jq '.results[] | {file_url, file_size, md5, downloaded_bytes, output_format}' delivery.json

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
{
  "name": "get_result",
  "arguments": {
    "result_id": "RESULT_ID_FROM_TOOL",
    "offset": 16000
  }
}

Baiki masalah penyimpanan dan pengambilan kembali

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