İçeriğe geç
TR
API anahtarı al
Belgeleri incele

Kılavuzlar

Kaydet ve tekrarlama sonuçları

Orijinal giriş, kaynak bağlantıları ve kullanımı ile sonuç alın, sonra başka bir sorgu olmadan başka bir işlem yapın.

Bu sayfada

Bir kez, bu sonucu görevlerin karşılaştırılması

Rapor oluşturun, ayrıştırıcınızı yeniden çalıştırın veya sonraki ajan adımına aynı kanıtı verin. Bu iş akışı bir aramayı taşınabilir arşiv olarak kaydeder; arşivi okumak FlashData anahtarı veya özgün CLI durumu gerektirmez.

Ne tutacağız
archive/saved-search/
  request.json orijinal sorgu ve parametreler
  response.json değişmedi API yanıt
  citations.ndjson başlıkları, kaynak URLs ve parçalar
  manifest.json, ID, kullanım, dosya boyutları ve SHA-256

Başlamadan önce başlamadan önce

Yeni bir çalışma klasörü kullanın, The Use a new working klasör, the the FlashData CLI with with with ile google_search İzin ve mevcut krediler. Gerçekleştirilmiş bir profil veya FLASHDATA_API_KEY. Bash denetim kullanımları jq; Windows Kullanım kullanım kullanımı kullanır PowerShell 7. Yerel arşiv senaryoları kullanır Python 3.10+ ve standart kütüphanesi.

data.accessVerified, true olduğunda devam edin. CLI retries için, aynı profili tut, OS kullanıcı ve eyalet rehberi. Bir ajan, kendi gizli mağazasından mevcut credential'ı yüklemelidir.

kaydedilen erişiminizi kontrol edin
flashdata auth status --json

1. Girişi tutun ve bir yanıt tasarruf edin

Save Kaydet request.json Aşağıda, bir komut çalıştırın. --input Bu tam istek kullanır; dosyayı daha sonra değişmeden tutar. --output Kurtarır API Vücutta vücut search.json; --json Baskılar baskı CLI metadata. kurtarılmış arama bu görevin yerel koşmaktır ID.

request.json
{
  "source": "google_search",
  "query": "battery recycling research",
  "params": {
    "num": 5
  }
}
Run one search
flashdata query --input request.json \
  --run-id saved-search --output search.json --json

2. Kurtarılan yanıtın Geçerliliği

Bekle kaynağı: google_search, status: done ve bir sonuç dizisi. Her organik sonucun unvanı, bağlantı ve parçaları yazdırın. Actual sonuçları değişir; boş başarılı bir koleksiyon başarısız bir istek veya eksik bir alandan farklıdır.

Geçerlilik ve okuma 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. Giriş, yanıt ve alıntılar

archive.py'u aşağıda kurtarın, sonra ID'u 1'nun adımından çalıştırın. Çiğ dosyaları korur, kaynak bağlantılarını çıkarır ve manifest.json'u dosya çekleri ve kullanımı ile son bulur. complete: true'u bekleyin; alıntı sayısı arama sonuçlarına bağlıdır. Hiçbir ağ isteği yapılır.

Save Kaydet archive.py

archive.py'un yanında request.json ve search.json'u çalışma klasöründe oluşturun. Aşağıdaki tam kodu kopyalayın ve onu kurtarın.

Örnek arşivler Google Search sonuçları. Mevcut arşiv direktörleri sağlam tutuluyor. request.json, search.json ve eşleştirme tamamlandıktan sonra birlikte çalışır.

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

Arşiv Oluşturun

archive.py, request.json ve search.json içeren klasörden hareket edin.

Yeni bir arşiv oluşturun
python3 archive.py --run-id saved-search

4. Arşivleri kimliksiz Yeniden Kullanın

Aşağıdaki reuse.py'u kurtarın. Tüm archive/saved-search klasörüne ihtiyacı olan süreçte kopyalayın, sonra bu okuyucuyu çalıştırın. Orijinal sorgu, kullanım ve alıntıları baskı yapmadan önce her dosyayı doğrular. API-key revokasyondan sonra veya ev sahipliği yapan-result expiry'den sonra çalışır, çünkü sadece kaydedilen kopyanızı okur.

Save Kaydet reuse.py

Create Create CreateCreate Create Create reuse.py Çalışma klasöründe içeren çalışma klasörü archive/. Başka bir makinede, her ikisini de kopyalayın reuse.py Ve tam olarak archive/saved-search Rehber, bu düzeni tut.

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

Kurtarılan arşivleri Oku

reuse.py'u kurtar, sonra klasöründen çalıştırın. Nihai argüman, kopyalanan arşive giden yoldur.

Kopyalanan arşivleri okuyun
python3 reuse.py archive/saved-search

Bunun yerine CLI dergisinden ihracat

Hala orijinal CLI profili ve eyalet rehberiniz varsa, kurtarılanın yeni bir dosya adına geçmesi gerekir. Bu yeni bir sorgu yapmaz, ancak ilk önce canlı erişimi doğrulamaktadır. Mevcut bir sonuç dosyası veya arşiv bu çek olmadan yerel olarak okunabilir.

Tamamlanan run
flashdata runs show saved-search --result --output search-copy.json --json

Yeniden tekrarlama veya yenilemeye karar verirken karar verin

archived_at kayıtları dosyaları kurtardığınızda, bir kaynak sayfası değiştiğinde değil. Uygulamanız, kanıtların nasıl olması gerektiğine karar verir; Bir dosyayı kopyalayın içeriğini yenilemez.

Görev Görev GöreviAction Action Action
Ayrıştırıcıyı yeniden çalıştırın, raporu yeniden oluşturun veya ajan adımına devam edinKurtarılan cevabı yeniden kullanın. Kaynak URLs, sorgu parametreleri ve onunla kullanım.
Yeni bir günlük kısa veya bir değişiklik sorgulayınYeni bir task/run ID, çalışma klasörü ve arşivi oluşturun. Tarih olarak eski anlıkları tut.
Türleme dosyaları arasında yer alan tablo kullanımıBir kez orijinal sorguyu sayın. Bir yanıt kopyalamak veya başka bir rapor yapmak başka bir ücret yaratmaz.

Neyin sona erdiğini bilin

Sonuç Sonuç SonuçNe tutmak içinRetention
Realtime queryYanıt dosyası ve orijinal girişTasarruf edilen kopyaınız depolama politikanızı takip ediyor
Async / Batch işiİş ID, teslim makbul ve sonuç JSON024 saatler tamamlandıktan sonra
BulkManifest ve tüm NDJSON parçalar24 saatler tüm iş tamamlandıktan sonra; expiresAt
YouTube DownloadTeslimat JSON ve hedefinizdeki medyaJSON: iş tutma. Medya: Kova yaşam döngüsü
MCP chunk önbellekTamamen bir araya gelen sonuç10 dakika; sadece API anahtarı için en yeni dört büyük sonuç muhafaza edilir.

Bunun yerine küçük bir yancar tutun

Özgün değişmemiş cevabı tutun. Giriş, kaynak, zaman ve kullanımla küçük bir yancar tasarruf edin, böylece daha sonraki bir süreç dosyayı neyin üretebileceğini anlayabilir. Sonuçları dönüştürdüğünde kaynak URLs ve video zamantamps tutun.

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
)

Doğrudan HTTP ile Kaydet

Bunu adım 1 içindeki CLI sorgusunun yerine kullanın. Önce aynı request.json dosyasını kaydedin. Örnek Bash, cURL 7.76+ ve jq ile yeni bir sorgu çalıştırır. FLASHDATA_API_KEY değerini yeniden kullanın ve search.json bulunmayan bir klasör seçin. Doğrulamadan sonra aynı arşiv betikleri bu sonuçla çalışır; --run-id için kendi görev ID değerinizi seçin.

A nonzero cURL çıkışı, sonuç kullanıma hazır değildir. Yeniden denemeden önce kurtarılan cevabı göz önünde bulundurun; bir sorgu kabul edildikten sonra bir bağlantı zamanı olabilir. 2 adımdaki geçerlilik komutunu kullanın.

Gerekirse anahtarınızı ayarlayın
# 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 yanıtını kurtar
(
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
)

Mevcut bir arka plan işi kurtarmak

submission.json'u async kılavuzundan ve aynı hesaptan credential'ı kullanın. Bu komutlar mevcut işleri alır; başka bir sorgu göndermezler. CLI tamamlanmayı bekler ve sonuç yönlendirmesini ele alır. 24 saatleri içinde sonucu kurtarın.

Bekle, alın ve kurtarın
(
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
)

Her Bulk sonucunu kurtarın

BULK_ID'u ID'u sizin teslim bülteninizde değiştirin. İş tamamlandıktan sonra, CLI, her parçayı bir NDJSON dosyası olarak takip eder ve kurtarır. Sayılara ve parça metadata'ya ihtiyacınız olduğunda da açık tutun.

Dosya hem başarılı hem de başarısız satırları içerebilir. Reconcile giriş indeksleri ve tüm görevi tamamlamadan önce sayılır. Başarısız bir sırayı kurtarmak için tüm giriş dosyasını yeniden kullanmayın.

Tamamlanan işi toplayın
flashdata bulk results BULK_ID --output bulk-results.ndjson --timeout 30m --json

Teslimat kayıtlarını ve medyayı tut

delivery.json bir teslimat kaydı içeriyor, video veya ses totes değil. URL'unu kurtarın ve görevin yanında kontrol edin. Medya hedef depolamanızda yaşıyor ve bu depolamanın yaşam döngüsünü takip ediyor.

Özel bir hedef için, bu sağlayıcının bilgilerini kullanın veya itirazı denetlemek için URL'u imzaladı. Eksik bir geçici sonuç JSON, depolanmış medyanızın silindiği anlamına gelmez.

Tasarruf edilen bir indirme sonucu · jq
jq '.results[] | {file_url, file_size, md5, downloaded_bytes, output_format}' delivery.json

MCP, tasarruf etmeden önce

Bir araç result_id, chunk ve next_offset'yu döndürürken, kalan chunks'ı get_result ile aynı API anahtarını kullanarak okuyun. next_offset'u araç tarafından geri döndürür; aşağıdaki değerler yer sahipleridir.

  1. Her bir chunk'ı dengeleme emrinde tamamlayın. next_offset'u null olana kadar takip edin.
  2. JSON olarak katıldıktan sonra kendi dosyanıza veya depolamanıza tam sonucu yazın.
  3. expires_at'dan önce tasarruf edin. Yeni büyük yanıtlar 10- dakika sınırından önce daha eski sonuçları evlenebilir; önbellek API anahtarı için dört tutar.
MCP tools/call argümanları
{
  "name": "get_result",
  "arguments": {
    "result_id": "RESULT_ID_FROM_TOOL",
    "offset": 16000
  }
}

Tasarruf ve geri dönüş problemlerini düzeltin

Problem Sorun Problem Problem ProblemFix Fix
Çıkış dosyası zaten varİlk önce tahmin edin. Tamamlanan bir CLI koşmak için, başka bir sorgu göndermek yerine yeni bir çıkış dosyası adı ile runs show kullanın.
CLI, işi bulamazOrijinal OS kullanıcı, profil ve eyalet rehberi kullanın. Uzak bir iş tuttuysanız ID, bu işi doğrudan alın.
401 / 403 yeniden yeniden kullanıma sunulduRun flashdata auth status --json ve geçerli erişimi geri yükleyin. Yerel bir dosya zaten kaydedilen API erişim olmadan hala okunabilir.
409 / 410409: Mevcut iş için bekleyin. 410: kaydedilen kopyanızı kullanın; geçici sonuç sona ermiştir.
Bir sorgudan sonra Disk hatasıID veya iş ID'u tut. Yeni bir gönderim dikkate almadan önce mevcut işleri düzeltin.
Archive'ın açık veya bir çekleri yokGeri yükleme veya orijinal dosyaları tekrar kopyalayın. İnceleme için eksik bir arşiv tutun; arşiv yeniden inşa etmek yeni bir sorgu gerektirmez.
MCP · result_unavailableSonuç olarak ID, denge, API anahtarı ve expiry. Önbellek sona ermişse kaydedilen bir kopya kullanın; ücretli bir sorguyu tekrarlayarak döngü yapmayın.