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

Canonical referans: https://flashdata.dev/tr/docs/guides/save-results
İnceleme: 2026-11-05 Tarafından FlashData

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

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

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

- [Zaten bir async sonucu var mı?](https://flashdata.dev/tr/docs/guides/save-results/reference.md#jobs)
- [Bir Bulk dataset](https://flashdata.dev/tr/docs/guides/save-results/reference.md#bulk)
- [İndirin medya](https://flashdata.dev/tr/docs/guides/save-results/reference.md#media)

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

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

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

- [Yüklemek için CLI](https://flashdata.dev/tr/docs/guides/flashdata-cli/reference.md#install)
- [Bir API anahtarı oluşturun](https://flashdata.dev/app/api-keys)
- [HTTP'u kullanın](https://flashdata.dev/tr/docs/guides/save-results/reference.md#http)

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

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

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

### Bash

#### Run one search

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


### PowerShell

#### Run one search

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



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

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

### Bash / jq

#### Geçerlilik ve okuma 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

#### Geçerlilik ve okuma 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. 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.


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

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

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

### Arşiv Oluşturun

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

#### Bash

##### Yeni bir arşiv oluşturun

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


#### PowerShell 7

##### Yeni bir arşiv oluşturun

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



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

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


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

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

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

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

#### Bash

##### Kopyalanan arşivleri okuyun

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


#### PowerShell 7

##### Kopyalanan arşivleri okuyun

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



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

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

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


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

## 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örevi | Action Action Action |
| --- | --- |
| Ayrıştırıcıyı yeniden çalıştırın, raporu yeniden oluşturun veya ajan adımına devam edin | Kurtarı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ın | Yeni 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. |

- [Görevleri geri almak ve IDs koşmak](https://flashdata.dev/tr/docs/guides/recurring-tasks/reference.md)
- [Mevcut sonuçlar](https://flashdata.dev/tr/docs/guides/response-formats/reference.md#completed-results)

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

## Neyin sona erdiğini bilin

| Sonuç Sonuç Sonuç | Ne tutmak için | Retention |
| --- | --- | --- |
| Realtime query | Yanıt dosyası ve orijinal giriş | Tasarruf edilen kopyaınız depolama politikanızı takip ediyor |
| Async / Batch işi | İş ID, teslim makbul ve sonuç JSON0 | 24 saatler tamamlandıktan sonra |
| Bulk | Manifest ve tüm NDJSON parçalar | 24 saatler tüm iş tamamlandıktan sonra; expiresAt |
| YouTube Download | Teslimat JSON ve hedefinizdeki medya | JSON: iş tutma. Medya: Kova yaşam döngüsü |
| MCP chunk önbellek | Tamamen bir araya gelen sonuç | 10 dakika; sadece API anahtarı için en yeni dört büyük sonuç muhafaza edilir. |


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

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

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

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

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

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

### CLI + jq

#### Bekle, alın ve kurtarın

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

Durum kontrolü, iş tamamlanmamışsa durur. Hala kuyruklanmış veya çalışıyorsa, tekrar bu okumayı bekleyin; bunun yerine başarısız bir işi kontrol edin. A A A a A AA A A 302 Sizin için ileri olmadan indirilir API anahtar. Geçici yanıt job-result.json'dan önce geçerlidir.

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


- [Mevcut bir async işi](https://flashdata.dev/tr/docs/guides/async-batch/reference.md#resume)
- [Sonuç yanıt sözleşme sözleşmesi](https://flashdata.dev/tr/docs/reference/realtime-and-async/reference.md#results)
- [Erişim tarihi olarak Markdown](https://flashdata.dev/tr/docs/guides/response-formats/reference.md#completed-results)

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

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

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

- [ithal etmeden önce her girişi kontrol edin](https://flashdata.dev/tr/docs/guides/bulk/reference.md#audit)
- [Manifest, sayılar ve NDJSON](https://flashdata.dev/tr/docs/reference/bulk-processing/reference.md#downloadBulkJobManifest)

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

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

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

- [Boyut, kontrol ve medya](https://flashdata.dev/tr/docs/guides/youtube-download-guide/reference.md#verify-media)

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

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

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

- [Runnable MCP müşteri with chunk collection](https://flashdata.dev/tr/docs/guides/mcp-custom-client/reference.md)

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

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

| Problem Sorun Problem Problem Problem | Fix 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 bulamaz | Orijinal 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 sunuldu | Run flashdata auth status --json ve geçerli erişimi geri yükleyin. Yerel bir dosya zaten kaydedilen API erişim olmadan hala okunabilir. |
| 409 / 410 | 409: 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 yok | Geri 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_unavailable | Sonuç olarak ID, denge, API anahtarı ve expiry. Önbellek sona ermişse kaydedilen bir kopya kullanın; ücretli bir sorguyu tekrarlayarak döngü yapmayın. |

- [CLI kurtarma komutları](https://flashdata.dev/tr/docs/guides/cli-automation/reference.md#recover)
- [Sorun giderme talep etmek](https://flashdata.dev/tr/docs/guides/troubleshooting/reference.md)
