# Uji coba agen dan penautan akun

Cobalah Google cari sebelum pendaftaran, lalu hubungkan akun pemilik untuk tetap menggunakan yang sama CLI profil.

Referensi kanonikal: https://flashdata.dev/id/docs/guides/agent-onboarding
Diulang: 2026-11-04 oleh FlashData

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

## 1. Periksa akses yang ada

Jalankan pemeriksaan gratis ini di lingkungan agenmu. Jika data.accessVerified adalah true dan Google Search diijinkan, gunakan kembali akses tersebut dan lewatkan untuk langkah 3. Tanpa profil tersimpan, lanjutkan langkah 2. Melanjutkan penundaan atau memblokir akses menggunakan bagian pemulihan di bawah ini.

### Periksa profil ini

```bash
flashdata auth status --json --non-interactive
```

- [Pasang CLI](https://flashdata.dev/id/docs/guides/flashdata-cli/reference.md#install)
- [Sudah punya kuncinya?](https://flashdata.dev/id/docs/guides/agent-onboarding/reference.md#existing)
- [Akses recover](https://flashdata.dev/id/docs/guides/agent-onboarding/reference.md#help)

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

### Pertahankan profil yang sama

Laporan akses data.accessVerified: true, access: ready dalam data.identity.identity, dan google_search dalam data.identity.permittedSources.

Perintah ini menggunakan profil baku dan bekerja di Bash atau PowerShell. Untuk profil yang sudah ada atau direktori keadaan gubahan, tambahkan yang sama --profile NAMA dan --state-dir ABSOLUTE_PATH untuk setiap perintah, termasuk mereka dalam terminal segar.

FLASHDATA_API_KEY didahulukan daripada kunci yang tersimpan. Biarkan variabel ini tidak disetel saat menguji uji coba dan penyerahan kredensial profil ini. Gunakan pengguna OS yang sama dan pertahankan direktori status privat; direktori ini menyimpan kredensial, bukti pendaftaran, dan riwayat eksekusi.

Inspeksi credentialProtection dalam auth status. Windows menggunakan DPAPI, macOS menggunakan Keychain, dan tanpa kepala Linux dapat menggunakan sebuah owner- hanya berkas kredensial. Toko OS yang tersedia dapat diperlukan dengan --credential-store os.


<a id="existing"></a>

### Pakai kunci pemilik yang ada saja

Seseorang di terminal dapat mengimpor kunci melalui prompt tersembunyi di bawah ini dan melewatkan pendaftaran pengadilan dan mengklaim. Para agen harus mensuplai di stdin dengan --api-key-stdin --non-interactive dari toko rahasia mereka; jangan pernah menaruh kunci dalam argumen atau percakapan.

Jika profil ini memiliki akses yang berbeda, periksa terlebih dahulu menggunakan auth login --replace. Mengimpor kunci lain bukan sebagai jawaban klaim. MCP OAuth juga merupakan sambungan host terpisah.

#### Prompt kunci tersembunyi

```bash
flashdata auth login
flashdata auth status --json --non-interactive
```

- [Pengelolaan kunci API](https://flashdata.dev/id/docs/guides/api-keys-and-permissions/reference.md)
- [MCP dan opsi otentikasi lainnya](https://flashdata.dev/id/docs/guides/agent-access/reference.md)

<a id="trial"></a>

## 2. Mulai satu pengadilan yang memenuhi syarat

Jalankan discover dulu. Periksa data.onboardingAvailable dan uang saku dalam data.onboarding.trial. Jika onboarding tersedia, jalankan init sekali untuk Google Search. Pemeriksaan server eligibilitas; CLI menyimpan kunci sementara tanpa membuka pendaftaran atau mengirimkan permintaan.

### Periksa ketersediaan

```bash
flashdata discover --json --non-interactive
```

### Mulai akses sementara

```bash
flashdata init --name "Research assistant" --scopes google_search --json --non-interactive
```

- [Protokol saat ini](https://flashdata.dev/auth.md)

<a id="trial-receipt"></a>

### Periksa tanda terima registrasi

Diharapkan ok: true, data.status: trial dan google_search in data.connection.scopes. Baca data.connection.trialExpiresAt dan data.startingAllowanceCredits. Kunci disimpan secara lokal, tidak dicetak. Jika data.currentBalanceAvailable adalah false, jalankan kembali pemeriksaan keseimbangan gratis sebelum kueri.

Jika setup sudah membuat akses, gunakan kembali. Untuk melabeli pendaftaran pertama agen, tambahkan --client codex --audience coding atau --client openclaw --audience personal. Simpan masukan yang tepat pada suatu coba ulang; label tidak memberikan izin.


<a id="trial-limits"></a>

### Pembagian dan batas ujian

Permintaan ekuivalen berbagi saldo awal kredit yang sama; mereka tidak tersisa permintaan atau kuota independen. Pemilik - hanya sumber seperti YouTube Download tidak dapat menghabiskan kredit percobaan.

| Batas | Apa yang harus diperiksa |
| --- | --- |
| Kredit / kadaluwarsa | Default saat ini: kredit 1 untuk jam 72. Baca penemuan untuk hibah dan seumur hidup; tanda terima memberikan habis dan sumber yang diberikan. |
| Pendaftaran | 3 registrasi per IP per jam 24, dibagikan oleh pengguna IP tersebut. Penutup percobaan global juga dapat menghentikan registrasi baru. |
| konkuenCity in Texas, United States | Pertahankan sekuensial percobaan: satu hal per batch dan satu pekerjaan yang tertunda. Periksa kembali batas sebelum mengirimkan lebih banyak. |

- [Cacah permintaan dan kredit](https://flashdata.dev/id/docs/guides/credits-and-billing/reference.md#estimate)
- [Download- hanya akses](https://flashdata.dev/id/docs/guides/agent-onboarding/reference.md#download-only)

<a id="first-task"></a>

## 3. Coba satu pencarian

Preview dulu. Perlu data.estimateAvailable, harga yang tersedia google_search dalam data.estimate.prices, dan availableCredits meliputi estimatedCredits. Berhenti jika cek gagal. Pratilik bebas; perintah selanjutnya menyerahkan pencarian.

### Periksa saldo dan biaya

```bash
flashdata account balance --json --non-interactive
flashdata search "battery recycling" --num 5 --dry-run --json --non-interactive
```

### Satu pencarian sampai lima hasil

```bash
flashdata search "battery recycling" --num 5 --run-id trial-search --json --non-interactive
```


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

### Periksa hasil

Diharapkan ok: true dan data.status: done. Baca judul, link dan snippet dari data.results[].organic, dan muatan dari data.usage.credits. Hasil organik kosong valid. Sebelum mengklaim, mengulangi tugas ini dengan trial-search mengembalikan hasilnya. Menjaga profil dan negara, dan mempertahankan setiap hasil percobaan yang Anda butuhkan.

#### Periksa keseimbangan yang tersisa

```bash
flashdata account balance --json --non-interactive
```

- [Baca sebuah respon pencarian](https://flashdata.dev/id/docs/guides/http-quickstart/reference.md#result)

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

## 4. Simpan akses dengan akun pemilik

Klaim sebelum percobaan berakhir bila anda ingin melanjutkan atau mengulangi penggunaan. Ketika pemiliknya siap, jalankan ini dalam profil asli. Berbagi hanya data.claimUrl dan data.confirmationCode dengan mereka; data.expiresAt memberikan tenggat waktu.

Taut berlangsung 15 menit, atau sampai sidang berakhir jika lebih cepat. Membuat link tidak menyetujui akses atau kredit pembelian.

### Buat link klaim ketika pemilik siap

```bash
flashdata auth claim --json --non-interactive
```


<a id="owner-approval"></a>

### Approve dalam peramban

1. Pemilik membuka tautan dan tanda-tanda masuk, atau membuat akun baru dan memverifikasi email. Sebuah tanda tangan baru melanjutkan klaim setelah verifikasi.
2. Periksa akun yang ditunjukkan pada halaman klaim. Untuk pemilik yang berbeda atau baru, gunakan sesi peramban terpisah. Sign-in account adalah account yang akan membayar untuk permintaan kemudian.
3. Masukkan kode delapan digit pada halaman itu, tinjau perizinan produk dan berbagi-keseimbangan akses, kemudian setuju. Pemilik menangani pendaftaran, penerimaan hukum, verifikasi email dan persetujuan.


<a id="finish"></a>

### Selesai di terminal asli

Setelah persetujuan, jalankan finish dalam profil asli dalam waktu 24 jam. CLI menyimpan kunci pemiliknya, memastikannya dalam proses baru dan mengakui instalasi. Tak ada kunci yang disalin dari peramban.

#### Simpan dan verifikasi akses pemilik

```bash
flashdata auth finish --wait --timeout 10m --json --non-interactive
```

#### Kemudian periksa dari terminal baru yang sama pengguna dan profil OS

```bash
flashdata auth status --json --non-interactive
flashdata account balance --json --non-interactive
```


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

### Konfirmasikan pemilik dan keseimbangan

Dalam auth status, verifikasi yang dimaksud accountId dan diberikan scopes, ditambah bidang di bawah ini. Baca keseimbangan baru secara terpisah; permintaan masa depan menghabiskan kredit bersama pemilik. Kredit sementara yang tak digunakan tidak ditransfer. Sebuah akun baru mengikuti eligibilitas pendaftaran normal; mengklaim tidak menambahkan tambahan hibah pendaftaran.

Mengklaim perubahan akun tagihan. Untuk tugas baru di bawah pemilik, pilih run baru ID. Menggunakan percobaan ID mengembalikan run_account_mismatch tanpa mengirimkan kueri lain; itu tidak mentransfer yang ke pemilik.

#### Diharapkan bagian-bagian yang dikeluarkan

```json
{
  "ok": true,
  "data": {
    "accessVerified": true,
    "identity": {
      "identity": {
        "accountType": "owned",
        "access": "ready",
        "installed": true,
        "recurringAllowed": true
      }
    }
  }
}
```

- [Mengatur tugas yang berulang](https://flashdata.dev/id/docs/guides/recurring-tasks/reference.md)
- [Kredit setelah klaim](https://flashdata.dev/id/docs/guides/credits-and-billing/reference.md#trial)
- [Mengembalikan sambungan ini](https://flashdata.dev/id/docs/guides/agent-access/reference.md#revoke)

<a id="permissions"></a>

## Pilih perizinan produk

Katalog izin HTTP membedakan trialEligible dan ownerAllowed. Sebelum pendaftaran pertama, minta hanya sumber yang diperlukan untuk tugas Anda. requestedScopes berisi izin yang diminta; scopes menunjukkan akses kunci saat ini. Produk baru memerlukan pemberian izin secara eksplisit.

Persetujuan mengizinkan penggunaan saldo bersama pemilik, termasuk kredit yang dibeli. Pembatasan sumber tidak menetapkan batas pengeluaran per agen. MCP OAuth adalah koneksi terpisah dan tidak menautkan profil CLI ini ke akun.

- [Akses katalog dan protokol HTTP](https://flashdata.dev/auth.md)

<a id="download-only"></a>

## Hanya perlu YouTube Download?

Gunakan kunci pemilik dengan izin youtube_download, impor, lalu konfigurasi penyimpanan tujuan. Unduh tidak menggunakan kredit percobaan sementara.

CLI 1.2.1 masih membutuhkan sumber yang memenuhi syarat untuk init. Untuk Download- hanya onboarding sebelum sign-up, gunakan aliran klaim HTTP dalam auth.md. Jangan tambahkan sumber percobaan hanya untuk melewati batasan klien.

- [Impor kunci pemilik](https://flashdata.dev/id/docs/guides/agent-onboarding/reference.md#existing)
- [Atur penyimpanan dan unduh](https://flashdata.dev/id/docs/guides/youtube-download-guide/reference.md)
- [Download- hanya aliran HTTP](https://flashdata.dev/auth.md)

<a id="help"></a>

## Lanjutkan aliran berhenti

| Apa yang berhenti | Aksi berikutnya |
| --- | --- |
| Register | Untuk 429, tunggu Retry-After. Untuk respon yang hilang, coba lagi init dengan profil yang sama, bukti, dan masukan yang tepat. Pertahankan keadaan yang ada; jangan menukar IP atau memulai percobaan pengganti. |
| Cari | Inspeksi trial-search di bawah ini. Sebuah timeout tidak membuktikan bahwa tidak ada pekerjaan yang diterima; jangan mengubah menjalankan ID untuk memaksa sebuah coba lagi. |
| Taut claim | Bila tautan berakhir tapi percobaan valid, buat sebuah tautan segar dalam profil yang sama ketika pemiliknya siap. Periksa sinyal pemilik sebelum persetujuan. |
| Handoff | Setelah persetujuan, tayangan ulang auth finish dalam profil asli dalam waktu 24 jam. Persetujuan yang tertunda, menunggu yang terganggu atau pengakuan yang hilang tidak memerlukan pendaftaran baru. |
| Keadaan terlama / hilang | Untuk percobaan yang kadaluwarsa atau handoff, atau direktori keadaan privat yang hilang, gunakan koneksi ulang yang disetujui atau impor kunci pemilik. |

### Inspeksi pencarian tersimpan

```bash
flashdata runs show trial-search --json --non-interactive
```

- [Panduan Pemulihan](https://flashdata.dev/id/docs/guides/agent-recovery/reference.md)
