# Soalan lazim dan penyelesaian masalah

Periksa akses Anda, perbaiki permintaan yang gagal atau cari jawaban tentang penggunaan FlashData.

Referensi boonical: https://flashdata.dev/ms/docs/guides/troubleshooting
Diulas: 2026-11-04 oleh FlashData

- [Perbaikan sebuah kesalahan](https://flashdata.dev/ms/docs/guides/troubleshooting/reference.md#fix) — Perintah dan perbaikan oleh gejala
- [Pertanyaan umum](https://flashdata.dev/ms/docs/guides/troubleshooting/reference.md#faq) — Akses, kredit, dan data

<a id="diagnose"></a>

## Kita akan mulai dengan cek akses gratis

Jalankan pemeriksaan di mana tugas itu gagal. Guna kelayakannya yang sudah ada; perintah ini tidak mengajukan pertanyaan.

### CLI

Gunakan CLI yang disimpan. Untuk profil bernama, tambahkan --profile NAMA ke setiap perintah. Bacaan ini tidak menghabiskan kredit pertanyaan.

#### Akun gratis dibaca

```bash
flashdata --version
flashdata doctor --offline
flashdata auth status --json
```

- [Sediakan kunci](https://flashdata.dev/ms/docs/guides/api-keys-and-permissions/reference.md#store)

### Bash / cURL

Use the task's sudah ada FLASHDATA_API_KEY di terminal yang sama, kontainer atau pekerjaan terjadwal. Kemudi membutuhkan cURL 7.76+.

#### akun baca JSON

```bash
(
: "${FLASHDATA_API_KEY:?Set FLASHDATA_API_KEY first}"
curl --fail-with-body --silent --show-error --max-time 20 \
  --header "X-API-Key: $FLASHDATA_API_KEY" \
  'https://api.flashdata.dev/v2/api-access/identity' || exit
printf '\n'
)
```


### PowerShell 7

Use the task's sudah ada FLASHDATA_API_KEY di terminal yang sama, kontainer atau pekerjaan terjadwal.

#### akun baca JSON

```powershell
& {
  $ErrorActionPreference = 'Stop'
  if ([string]::IsNullOrWhiteSpace($env:FLASHDATA_API_KEY)) {
    throw 'Set FLASHDATA_API_KEY first'
  }
  $flashdataHeaders = @{ 'X-API-Key' = $env:FLASHDATA_API_KEY }
  $flashdataBase = 'https://api.flashdata.dev/v2'
  $flashdataUri = "$flashdataBase/api-access/identity"
  Invoke-RestMethod -Uri $flashdataUri `
    -Headers $flashdataHeaders -TimeoutSec 20 -MaximumRedirection 0 |
    ConvertTo-Json -Depth 20
}
```


- [401 / 403Bukti kelayakan](https://flashdata.dev/ms/docs/guides/troubleshooting/reference.md#credentials)
- [402: kredit](https://flashdata.dev/ms/docs/guides/troubleshooting/reference.md#credits)
- [429Batas tingkat](https://flashdata.dev/ms/docs/guides/troubleshooting/reference.md#rate-limit)
- [400 / 422Permintaan: permintaan](https://flashdata.dev/ms/docs/guides/troubleshooting/reference.md#request)
- [Mending atau pekerjaan gagal](https://flashdata.dev/ms/docs/guides/troubleshooting/reference.md#jobs)
- [Masa Kehabisan Masa Tamat / 5xx](https://flashdata.dev/ms/docs/guides/troubleshooting/reference.md#uncertain)
- [Sambungan MCP](https://flashdata.dev/ms/docs/guides/troubleshooting/reference.md#mcp)

<a id="check-result"></a>

### Apa yang harus diperiksa

Identitinya harus memiliki access: ready dan termasuk sumber Anda dalam lingkup. Dalam CLI JSON, identitas berada di data.identity.identity; juga membutuhkan data.accessVerified: true. Perintah sukses dengan accessVerified: false belum diverifikasi akses.

Untuk profil CLI bernama, tambahkan --profile NAMA ke setiap perintah di bawah. ¡Jaga pengguna --state-dir dan OS asli. FLASHDATA_API_KEY Membatalkan penyelamatan CLI Kuncinya adalah: Host SDK dan MCP menggunakan konfigurasi kredensial mereka sendiri.


<a id="fix"></a>

## Cari dan perbaiki masalahnya

Buka gejala yang cocok dengan kesalahanmu. Guna IDs Penerimaan dan penerimaan dari tugas aslinya.


<a id="runtime"></a>

### Perintah Ufine tidak ditemukan atau profil hilang

Tak ada executable: pasang rilis untuk OS/CPU anda dan tambahkan direktorinya ke PATH. Profil someless: gunakan direktori pengguna dan keadaan OS asli. Periksa di dalam penjadwal atau kontainer juga.

#### Bash

##### Memerlukan barang yang bisa dieksekusi

```bash
command -v flashdata
flashdata --version
flashdata doctor --offline
```


#### PowerShell

##### Memerlukan barang yang bisa dieksekusi

```powershell
Get-Command flashdata
flashdata --version
flashdata doctor --offline
```


- [Pemasangan CLI](https://flashdata.dev/ms/docs/guides/flashdata-cli/reference.md#install)
- [Profil Profil dan direktori negara bagian](https://flashdata.dev/ms/docs/guides/cli-automation/reference.md#profiles)

<a id="credentials"></a>

### 401 / 403Kunci, skop atau ekspiri

Untuk mengganti kunci pemilik tersimpan, tampal kunci yang disetujui ke dalam prompt tersembunyi. FLASHDATA_API_KEY telah ditetapkan, update rahasia itu dalam waktu jalan sebagai gantinya; menyimpan kunci CLI lain tidak akan menimpanya.

1. 401Periksa kunci yang sudah kadaluarsa, dicabut atau salah dikonfigurasi. 403Bandingkan sumber yang diminta dengan ruang lingkup identitas.
2. ¡REST dan SDK menggunakan X-API-Key. Token MCP OAuth tidak dapat menggantikan kunci API. Untuk akses sementara, gunakan klaim pemulihan di bawah ini.

#### Kepingan dan sahkan kunci pemilik tersimpan

```bash
flashdata auth login --replace
flashdata auth status --json
```

- [Hak akses dan putaran kunci monmon](https://flashdata.dev/ms/docs/guides/api-keys-and-permissions/reference.md#rotate)
- [Klaim pemulihan](https://flashdata.dev/ms/docs/guides/troubleshooting/reference.md#claim)
- [Sambungan kembali MCP](https://flashdata.dev/ms/docs/guides/troubleshooting/reference.md#mcp)

<a id="claim"></a>

### Klaim klaim disetujui, tapi agen masih memiliki akses pengadilan

Setelah menyelesaikan handoff dalam profil CLI yang sama yang menciptakan klaim. Pemiliknya melengkapi pendaftaran, pengesahan email dan persetujuan di dalam peramban; CLI menerima kredensial.

#### Sudah disetujui

##### Sudah selesai dan sahkan

```bash
flashdata auth finish --wait --timeout 10m
flashdata auth status --json
```


#### Kedaluwarsa

Permintaan link segar untuk sidang yang ada, biarkan pemilik menyetujui, kemudian menjalankan auth finish. Jangan jalankan init lagi.

##### Perbaharui kembali link klaim

```bash
flashdata auth claim
```


- [Tuntutan dan penyerahan](https://flashdata.dev/ms/docs/guides/agent-onboarding/reference.md#help)
- [Periksa akses pemilik untuk tugas yang berulang](https://flashdata.dev/ms/docs/guides/recurring-tasks/reference.md)

<a id="credits"></a>

### 402: kredit tidak mencukupi

Bandingkan availableCredits dengan harga saat ini untuk sumber anda. Klaim klaim pengadilan yang kelelahan untuk menggunakan saldo pemilik, atau membiarkan pemilik meninjau Billing sebelum mencoba lagi.

#### CLI

Gunakan CLI yang disimpan. Untuk profil bernama, tambahkan --profile NAMA ke setiap perintah. Bacaan ini tidak menghabiskan kredit pertanyaan.

##### Akun gratis dibaca

```bash
flashdata account balance
flashdata account pricing --source google_search --request-count 1
```

- [Sediakan kunci](https://flashdata.dev/ms/docs/guides/api-keys-and-permissions/reference.md#store)

#### Bash / cURL

Use the task's sudah ada FLASHDATA_API_KEY di terminal yang sama, kontainer atau pekerjaan terjadwal. Kemudi membutuhkan cURL 7.76+.

##### akun baca JSON

```bash
(
: "${FLASHDATA_API_KEY:?Set FLASHDATA_API_KEY first}"
curl --fail-with-body --silent --show-error --max-time 20 \
  --header "X-API-Key: $FLASHDATA_API_KEY" \
  'https://api.flashdata.dev/v2/api-access/balance' || exit
printf '\n'
curl --fail-with-body --silent --show-error --max-time 20 \
  --header "X-API-Key: $FLASHDATA_API_KEY" \
  'https://api.flashdata.dev/v2/api-access/pricing?source=google_search&request_count=1' || exit
printf '\n'
)
```


#### PowerShell 7

Use the task's sudah ada FLASHDATA_API_KEY di terminal yang sama, kontainer atau pekerjaan terjadwal.

##### akun baca JSON

```powershell
& {
  $ErrorActionPreference = 'Stop'
  if ([string]::IsNullOrWhiteSpace($env:FLASHDATA_API_KEY)) {
    throw 'Set FLASHDATA_API_KEY first'
  }
  $flashdataHeaders = @{ 'X-API-Key' = $env:FLASHDATA_API_KEY }
  $flashdataBase = 'https://api.flashdata.dev/v2'
  $flashdataUri = "$flashdataBase/api-access/balance"
  Invoke-RestMethod -Uri $flashdataUri `
    -Headers $flashdataHeaders -TimeoutSec 20 -MaximumRedirection 0 |
    ConvertTo-Json -Depth 20
  $flashdataUri = "$flashdataBase/api-access/pricing?source=google_search&request_count=1"
  Invoke-RestMethod -Uri $flashdataUri `
    -Headers $flashdataHeaders -TimeoutSec 20 -MaximumRedirection 0 |
    ConvertTo-Json -Depth 20
}
```


- [Billing](https://flashdata.dev/app/billing)
- [Percubaan dan pemautan akaun](https://flashdata.dev/ms/docs/guides/agent-onboarding/reference.md)
- [Memprihatinkan sumber lain](https://flashdata.dev/ms/docs/guides/credits-and-billing/reference.md)

<a id="rate-limit"></a>

### 429Tunggu sebelum mencoba lagi

Kemuliaan baca Retry-After pada respon gagal: detik atau tanggal HTTP. Tunggu sampai saat itu dan kurangi konkurensi. Pendaftaran uji coba uji coba mengizinkan tiga pendaftaran per IP per 24-jam jendela; menggunakan kembali profil dan bukti pendaftaran asli.

Bacaan gratis ini menunjukkan menyimpan header, status, dan tubuh. Use Retry-After dari operasi yang gagal; kueri, pendaftaran dan batas baca akun dapat berbeda.

#### Merebut tanggapan · Bash / cURL / jq

```bash
# Bash + cURL + jq. This is a free account read.
(
test -n "$FLASHDATA_API_KEY" || { printf 'Set FLASHDATA_API_KEY first\n' >&2; exit 1; }
curl --silent --show-error --max-time 20 \
  --header "X-API-Key: $FLASHDATA_API_KEY" \
  --dump-header diagnostic-headers.txt --output diagnostic.json \
  --write-out '%{http_code}\n' \
  'https://api.flashdata.dev/v2/api-access/identity' > diagnostic-status.txt || exit
printf 'HTTP '; cat diagnostic-status.txt
awk 'tolower($1) == "retry-after:" {
  $1=""; sub(/^ /, ""); sub(/\r$/, ""); print "Retry-After: " $0
}' diagnostic-headers.txt
if jq -e 'type == "object"' diagnostic.json >/dev/null 2>&1; then
  jq '{access, scopes, status, code, requestId}
    | with_entries(select(.value != null))' diagnostic.json
else
  printf 'Non-JSON response saved in diagnostic.json; check the HTTP status.\n'
fi
)
```

#### Menginspeksi kapasitas akun

```bash
flashdata account limits
```

- [Batasan kadar dan pengurangan](https://flashdata.dev/ms/docs/guides/usage-and-limits/reference.md)

<a id="request"></a>

### 400 / 422: gagal input atau pemrosesan ditolak

Kode baca, detail dan fieldErrors dari HTTP error. Membetulkan badan permintaan, menyimpannya sebagai request.json, kemudian memvalidasinya. KELUARAN Muaturun kelayakan penyimpanan dalam sebuah berkas masukan pribadi. if 422 berasal dari hasil pekerjaan yang sudah ada, inspeksi job.error terlebih dahulu.

#### Disahkan tanpa penyerahan yang dibayar

```bash
flashdata query --input request.json --mode async --dry-run --json
```

- [Referensi permintaan sumber wikipedia](https://flashdata.dev/ms/docs/reference/reference.md)
- [Masukan unduhan swasta access-input](https://flashdata.dev/ms/docs/guides/cli-automation/reference.md#storage)
- [Periksalah sebuah pekerjaan yang sudah ada](https://flashdata.dev/ms/docs/guides/troubleshooting/reference.md#jobs)

<a id="jobs"></a>

### Job tertunda, atau HTTP 200 dengan pekerjaan yang gagal

Bacalah pekerjaan dari submission.json, penerimaanmu yang telah disimpan. HTTP 200 Woadon berarti pembacaan status berhasil; job.status (Y: i) (Y: i) adalah hasil tugas (data.status dalam CLI JSON). Untuk Batch, simpan masukan yang relevan dari kueri sebagai submission.json.

| Negara atau error | Tindakan berikutnya |
| --- | --- |
| pending / processing | Tunggu pada pekerjaan yang sama; jangan menyerahkannya lagi. |
| completed | Kutip dan simpan hasil yang ada. |
| failed | Periksa job.error sebelum menyerahkan pekerjaan yang dikoreksi. |
| 404 | Periksa pekerjaan ID dan rekening pengiriman. |
| 409 | Hasil belum siap. jajak pendapat tetap sama. |
| 410 | Ketersimpanan JSON berakhir setelah jam 24. Gunakan salinan tersimpan Anda; media yang disampaikan memiliki retensi penyimpanan sendiri. |

#### CLI

##### Periksalah pekerjaan yang disimpan · Bash / jq

```bash
# Bash + jq. CLI receipts use remoteId; HTTP receipts use id.
(
set -e
JOB_ID=$(jq -er '.remoteId // .id' submission.json)
flashdata jobs get "$JOB_ID" --json
)
```

##### Masih berjalan · menggunakan JOB_ID yang dikembalikan

```bash
flashdata jobs wait JOB_ID
```

##### Selesai · gunakan nama berkas keluaran baru

```bash
flashdata jobs result JOB_ID --output recovered-result.json
```


#### HTTP / cURL

##### Periksalah pekerjaan yang disimpan

```bash
# Bash + cURL + jq. Read the saved async submission receipt.
(
set -e
test -n "$FLASHDATA_API_KEY" || { printf 'Set FLASHDATA_API_KEY first\n' >&2; exit 1; }
STATUS_URL=$(jq -er '(.submission // .).links[]
  | select(.rel == "self") | .href' submission.json)
curl --fail-with-body --silent --show-error --max-time 30 \
  --header "X-API-Key: $FLASHDATA_API_KEY" \
  --header 'Accept: application/json' \
  "$STATUS_URL" --output job.json
jq '.job | {id, status, error}' job.json
)
```


- [Pemungutan suara dan pengambilan hasil HTTP](https://flashdata.dev/ms/docs/guides/async-batch/reference.md)
- [Kapasitas job-pending](https://flashdata.dev/ms/docs/guides/usage-and-limits/reference.md)

<a id="uncertain"></a>

### Masa Kehabisan Masa Tamat / 5xx: Apakah tugas itu diterima?

Periksa jalankan asli dan History sebelum mencoba kembali POST. Pemulihan kembali pekerjaan yang diterima. Jika penerimaan tidak diketahui, jaga jangka ID dan dukungan kontak; mengubah IDs dan pengiriman ulang dapat menggandakan biaya.

#### Periksa nilai · pertama menggantikan RUN_ID

```bash
flashdata runs show RUN_ID
```

#### Pemulihan dikonfirmasi menerima pekerjaan

```bash
flashdata runs recover RUN_ID
```

- [Sejarah permintaan](https://flashdata.dev/app/jobs)
- [Keputusan Pemulihan Liut](https://flashdata.dev/ms/docs/guides/agent-recovery/reference.md)

<a id="output"></a>

### CLI output_exists): berkas hasil sudah ada

XACLI tidak menindih berkas --output. Í Baca berkas yang ada, atau pilih nama file keluaran baru sambil menjaga --run-id asli dan permintaan. Jangan ciptakan ID baru untuk melewati kesalahan ini.

#### Periksalah lari yang asli

```bash
flashdata runs show RUN_ID
```

- [Berkas output dan pemulihan dijalankan](https://flashdata.dev/ms/docs/guides/cli-automation/reference.md)

<a id="results"></a>

### Pencarian kosong, hilang kapsi atau unduhan tak terbaca

Perintah-perintah ini hanya membaca berkas hasil lokal, bukan amplop CLI's stdout.

#### Google Search

Jika status dilakukan dan organik kosong, melonggarkan filter kueri. Simpan hasil kosong dalam catatan tugas Anda.

##### Periksa hasil tersimpan · Bash / jq

```bash
jq '{status, usage, resultCount: (.results | length)}' result.json
jq '(.results[0].organic // []) | length' result.json
```

- [Filter dan paginasi pencarian finepa](https://flashdata.dev/ms/docs/guides/google-search-guide/reference.md)

#### Aplikasi YouTube

Kata metadata ode bahasa, tidak peduli apakah trek manual atau otomatis. Iafinger Pilih bahasa yang terdaftar dan set auto explicitly: true untuk otomatis, false untuk manual. Tak ada lagu yang cocok berarti tak ada keterangan untuk pemilihan itu; FlashData tidak menghasilkan pengganti.

##### Periksa bahasa yang tersedia · Bash / jq

```bash
jq '.results[0].transcriptLanguages' metadata.json
```

- [Pilih trek kapsi](https://flashdata.dev/ms/docs/guides/youtube-data-guide/reference.md#captions)

#### YouTube Download

Membaca penerimaan delivery.json yang telah selesai. Knotownload objek dengan kredensial penyimpanan tujuan anda, kemudian bandingkan ukurannya dan MD5 dengan penerimaan. Sebuah file_url swasta tidak menjadi publik setelah pengiriman.

##### Periksa nilai pengiriman · Bash / jq

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

- [ukuran dan checksum tentusah](https://flashdata.dev/ms/docs/guides/youtube-download-guide/reference.md#delivery)


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

### MCP Alat-alat fengeus hilang atau autentikasi sudah kadaluarsa

Periksa tuan rumah yang menjalankan tugas. Server yang terdaftar mengkonfirmasi konfigurasi, bukan koneksi yang bekerja. Jika dikonfigurasikan koneksi OAuth yang di-konfigur memerlukan log masuk, jalankan perintah loginnya dan lengkapkan persetujuan peramban, maka segarkan kembali daftar alat.

#### Codex

Terbuka /mcp dalam Codex CLI untuk memeriksa status dan alat sambungan. Dalam aplikasi, periksa server yang telah dikonfigurasi dan mulai sesi baru setelah penetapan perubahan.

##### Konfigurasi pemeriksaan yogon

```bash
codex mcp list
```

##### Hanya ketika login OAuth diperlukan

```bash
codex mcp login flashdata --scopes mcp:research
```

- [Persediaan server Codex](https://flashdata.dev/ms/docs/integrations/codex/reference.md)

#### OpenClaw

##### Operator yang dikonfigurasi oleh server

```bash
openclaw mcp doctor flashdata --probe
```

##### Hanya ketika login OAuth diperlukan

```bash
openclaw mcp login flashdata
openclaw mcp doctor flashdata --probe
```

- [Persediaan server OpenClaw](https://flashdata.dev/ms/docs/integrations/openclaw/reference.md)

#### Kunci API / server lokal

Login OAuth tidak memperbaiki sambungan API-key. Periksa kunci di lingkungan tuan rumah dan izin sumbernya. Untuk stdio lokal, periksa persyaratan MCP paket Node.js dan start ulang host setelah memperbarui lingkungannya.

##### Untuk stdio lokal

```bash
node --version
```

- [Orang Suruhan API-key dan lokal MCP ***** *persiapan **](https://flashdata.dev/ms/docs/integrations/mcp-clients/reference.md)


<a id="skills"></a>

### Keterampilan tidak dipasang tapi agen tidak dapat menemukan atau menggunakannya

Periksa proyek yang sama, profil host dan pasang lokasi, kemudian mulai sesi agen baru. Kemampuan tugas CLI membutuhkan CLI; flashdata-mcp membutuhkan server MCP yang terhubung. Instalasi sebuah keterampilan tidak menghubungkan server atau izin akun hibah.

#### Codex · CLI Ketrampilan seni

##### Periksa standar CLI skill bundle

```bash
flashdata skills verify --agent codex
```


#### Codex · MCP Ketrampilan

##### Periksa hanya opsional kemampuan MCP

```bash
flashdata skills verify --agent codex --skill flashdata-mcp
```


#### OpenClaw

##### Ketersediaan keterampilan cek Keterampilan

```bash
openclaw skills list --eligible
openclaw skills check
```


- [Kemampuan memasang atau meng-update](https://flashdata.dev/ms/docs/guides/agent-skill/reference.md)
- [Gnect MCP](https://flashdata.dev/ms/docs/integrations/mcp-clients/reference.md)

<a id="faq"></a>

## Pertanyaan yang sering diajukan


<a id="faq-access"></a>

### Menyambungkan akses

| Pertanyaan | Jawapan |
| --- | --- |
| Apa aku perlu agen AI? | Tidak. Gunalah HTTP API, Go/Python/TypeScript SDK, CLI konsol atau konsol langsung. Ketrampilan dan kemampuan MCP adalah pilihan tambahan untuk agen. |
| Antarmuka mana yang harus kupilih? | Use an SDK atau HTTP API di dalam sebuah aplikasi, CLIQ untuk tugas terminal, dan MCP untuk sebuah MCP-capable host. Keterampilan menyediakan instruksi untuk tugas CLI atau alat MCP yang terhubung; mereka tidak menggantikan autentikasi. |
| BISAkah saya menggunakan lagi kelayakan untuk tugas yang berulang? | Ya. Ya. Use owner access dan menjaga profil CLI yang dilindungi sama, runtime secret atau MCP connection. Untuk akses API-key, periksa recurringAllowed: true. Waince, tuan rumah atau penjadwalmu yang menjalankan jadwal. |
| Apakah menghapus pengaturan lokal mencabut akses? | Tidak. Batalik ulang kunci API atau sambungan di konsol. Memadam pengaturan lokal hanya menghapus salinan lokal tersebut. |

- [Tak ada antarmuka yang dipilih](https://flashdata.dev/ms/docs/reference.md)
- [Penyelenggaraan tugas yang berulang](https://flashdata.dev/ms/docs/guides/recurring-tasks/reference.md)
- [Agen-agen yang terhubung oleh agen-agen licik](https://flashdata.dev/app/settings/connections)

<a id="faq-billing"></a>

### Cobaan dan Penghargaan

| Pertanyaan | Jawapan |
| --- | --- |
| Apa agen bisa mencoba FlashData sebelum mendaftar? | Ya, dengan akses sementara yang dapat memenuhi syarat melalui CLI atau diboarding API. Gunakan kembali profil dan bukti pendaftaran yang sama. Melanjutkan penggunaan kebutuhan mengklaim atau pemilik kunci API yang sudah ada. |
| Apakah mengklaim menambahkan hibah percobaan lagi? | Klaim klaim itu sendiri tidak memberikan kredit percobaan tambahan. Permintaan permintaan permintaan masa depan menggunakan saldo rekening pemilik; kredit sementara yang tidak digunakan tidak dipindahkan. A akun yang baru dibuat mengikuti kebijakan signup-credit normal. |
| Berapa banyak permintaan yang bisa kuterima? | Periksa keseimbangan akun dan harga sumber. Permintaan tergantung pada sumber, dan tugas sumber campuran berbagi satu keseimbangan. YouTube Download diharga oleh byte yang diunduh, bukan jumlah permintaan tetap. |

- [Percubaan dan pemautan akaun](https://flashdata.dev/ms/docs/guides/agent-onboarding/reference.md)
- [count permintaan](https://flashdata.dev/ms/docs/guides/credits-and-billing/reference.md)
- [Pendaftaran dan batasan permintaan](https://flashdata.dev/ms/docs/guides/usage-and-limits/reference.md)

<a id="faq-results"></a>

### Sumber dan hasil

| Pertanyaan | Jawapan |
| --- | --- |
| Kenapa agenku bisa mencari tapi tidak mengunduhnya? | download download membutuhkan akses pemilik, izin youtube_download dan penyimpanan tujuan. Uji coba sementara dan mcp:research OAuth tidak termasuk Download. Sebuah kunci API pemilik yang diberi wewenang dapat menggunakannya melalui CLI, HTTP atau MCP. |
| Apa Google Search kembali ke halaman web penuh? | Ia mengembalikan hasil pencarian dan kutipan. Anda aplikasi atau agen membaca URLs terpilih. |
| Apakah FlashData menghasilkan video summary atau kapsi? | Ini mengambil data meta dan gambar yang ada. Ia tidak menghasilkan keterangan yang hilang; model Anda menulis ringkasan dari hasil yang tersedia. |

- [Google Search](https://flashdata.dev/ms/docs/guides/google-search-guide/reference.md)
- [YouTube Data](https://flashdata.dev/ms/docs/guides/youtube-data-guide/reference.md)
- [YouTube Download](https://flashdata.dev/ms/docs/guides/youtube-download-guide/reference.md)

<a id="support"></a>

## Masih terjebak? Kirim laporan minimal

Simpan badan ralat HTTP atau ralat JSON CLI daripada stderr sebagai diagnostic.json. Ekstrak pengecam hanya selepas arahan gagal. Jangan sertakan kunci, teks pertanyaan peribadi atau URL bertandatangan dalam laporan. Bagi respons bukan JSON, laporkan status HTTP daripada diagnostic-status.txt.

### Rekod semakan akses CLI percuma · Bash

```bash
flashdata auth status --json 2> diagnostic.json
```

### Pengidentifikasi galat · Bash / jq

```bash
# A saved HTTP error or CLI --json error; local files only.
date -u '+%Y-%m-%dT%H:%M:%SZ'
jq '(.error // .) as $e | {
  status: ($e.httpStatus // $e.status),
  code: $e.code,
  requestId: $e.requestId,
  runId: (.runId // $e.runId),
  jobId: $e.remoteId,
  retryAfter: $e.retryAfter
} | with_entries(select(.value != null))' diagnostic.json
```

### Laporan dukungan Sodium

```text
Waktu UTC:
Versi Klien + klien:
Sumber + tahap (aut / tunduk / jajak pendapat / pengambilan):
Status HTTP + kode error:
Permintaan ID / pekerjaan ID / jalankan ID:
Hasil penyerahan: diterima / ditolak / tidak diketahui
Diharapkan hasil aktual vs:
```

- [Referensi kode-kesalahan](https://flashdata.dev/ms/docs/errors/reference.md)
- [Hubungi sokongan](https://flashdata.dev/ms/contact)
