# Percubaan ejen dan pemautan akaun

Coba pencarian Google sebelum signup, kemudian sambungkan akun pemilik untuk tetap menggunakan profil CLI yang sama.

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

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

## 1. Periksa akses yang ada

Kau menjalankan cek gratis ini di lingkungan agenmu. data.accessVerified adalah true dan Google Search diizinkan, gunakan kembali akses tersebut dan lewati langkah 3. Dengan tanpa profil yang disimpan, terus melangkah 2. Melanjutkan akses tertunda atau diblokir menggunakan bagian pemulihan di bawah.

### Periksa profil ini

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

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

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

### Waluke profile yang sama

Berkolaboring access melaporkan data.accessVerified: true, access: ready di data.identity.identity, dan google_search di data.identity.permittedSources.

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

FLASHDATA_API_KEY mengatasi kunci yang disimpan. Biarkan pemboleh ubah ini tidak ditetapkan apabila menguji percubaan dan penyerahan bukti kelayakan profil ini. Gunakan pengguna OS yang sama dan kekalkan direktori keadaan peribadi; direktori ini menyimpan bukti kelayakan, bukti pendaftaran dan sejarah pelaksanaan.

Periksa credentialProtection di auth status. Windows menggunakan DPAPI, macOS menggunakan Keychain, dan Linux tanpa kepala mungkin menggunakan berkas kredensial yang hanya dimiliki. Toko OS yang tersedia dapat diperlukan dengan --credential-store os.


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

### Sebaliknya menggunakan kunci pemilik yang ada

Orang di terminal dapat mengimpor kunci melalui prompt tersembunyi di bawah dan melewatkan pendaftaran pengadilan dan mengklaim. Agen-agen zegoza harus memasoknya di stdin dengan --api-key-stdin --non-interactive dari toko rahasia mereka; tidak pernah menempatkan kunci dalam argumen atau obrolan.

Jika profil sudah memegang akses yang berbeda, tinjaulah sebelum menggunakan auth login --replace. Mengimpor kunci lain bukanlah tuntutan. MCP OAuth juga merupakan sambungan host yang terpisah.

#### Prompt kunci tersembunyi · terminal manusia

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

- [Pengurusan kunci API](https://flashdata.dev/ms/docs/guides/api-keys-and-permissions/reference.md)
- [MCP Otentifikasi lainnya](https://flashdata.dev/ms/docs/guides/agent-access/reference.md)

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

## 2. Mulailah satu pengadilan yang memenuhi syarat

Jalur discover pertama. Periksa data.onboardingAvailable dan uang saku di data.onboarding.trial. Jika onboarding tersedia, jalankan init sekali untuk Google Search. Server keabsahan pemeriksaan kelayakan; CLI menyimpan kunci sementara tanpa penandatanganan pembukaan atau mengajukan pertanyaan.

### Periksa ketersediaan (dalam bahasa Inggris) · gratis

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

### Mulakan akses sementara

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

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

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

### Periksa penerimaan pendaftaran

Expect ok: true, data.status: trial dan google_search dalam data.connection.scopes. ¡data.connection.trialExpiresAt dan data.startingAllowanceCredits. Kunci disimpan secara lokal, tidak dicetak. data.currentBalanceAvailable adalah false, jalankan ulang pemeriksaan saldo bebas sebelum query.

Jika setup sudah dibuat akses, gunakan kembali. Ke label pendaftaran pertama agen, tambahkan --client codex --audience coding OR atau ORANG --client openclaw --audience personal. Simpan kembali masukan yang tepat pada retry; label tidak memberikan izin.


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

### Kesusilaan dan batas - batas percobaan

Request equivalensi permintaan berbagi saldo kredit awal yang sama; mereka tidak tersisa permintaan atau kuota independen. Sumber-hanya pemilik seperti YouTube Download tidak dapat menghabiskan kredit percobaan.

| Batasi | Apa yang harus diperiksa |
| --- | --- |
| Penghargaan / Kedaluwarsa | Nilai bawaan saat ini: Nilai kredit 1 untuk jam 72. Temuan Bacaan untuk hibah dan seumur hidup; penerimaan tersebut memberikan sumber-sumber yang kadaluarsa dan diberikan. |
| Pendaftaran | 3 pendaftaran per IP per 24 Jam kerja, dibagikan oleh pengguna IP itu. Cadangan global mungkin juga menghentikan pendaftaran baru. |
| Konkurrensi | Tetap uji coba pekerjaan berurutan: satu item per kelompok dan satu pekerjaan tertunda. Periksa batas yang dikembalikan sebelum menyerahkan lebih banyak. |

- [Penghargaan dan permintaan dihitung](https://flashdata.dev/ms/docs/guides/credits-and-billing/reference.md#estimate)
- [Akses unduh-sahaja](https://flashdata.dev/ms/docs/guides/agent-onboarding/reference.md#download-only)

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

## 3. Cuba satu pencarian

Pratonton pertama. Persyaratan data.estimateAvailableQ, harga google_search yang tersedia dalam data.estimate.prices, dan availableCredits yang meliputi estimatedCredits. Berhenti jika cek gagal. Preview bebas; perintah berikutnya mengirimkan satu pencarian.

### Periksa keseimbangan dan biaya · tidak ada pertanyaan

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

### Semak hasil

ok: true dan data.status: done. Type, link dan snippet dari data.results[].organic, dan muatan dari data.usage.credits. Hasil organik yang kosong adalah valid. Sebelum mengklaim, mengulangi tugas yang tepat ini dengan trial-search mengembalikan hasil yang disimpannya. Tetap menjaga profil dan negara, dan mempertahankan setiap hasil persidangan yang Anda butuhkan.

#### Periksa sisa keseimbangan · bebas

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

- [Bacalah tanggapan pencarian](https://flashdata.dev/ms/docs/guides/http-quickstart/reference.md#result)

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

## 4. Simpan akses ke akun pemilik

Tuntutan sebelum persidangan berakhir jika Anda ingin terus atau berulang digunakan. Ketika pemilik sudah siap, jalankan ini dalam profil asli. Kongsi hanya data.claimUrl dan data.confirmationCode dengan mereka; data.expiresAt memberikan batas waktu.

link terakhir 15 menit, atau sampai pengadilan berakhir jika lebih cepat. Mewujudkan link tidak menyetujui akses atau kredit pembelian.

### \"Membuat link klaim ketika pemilik sudah siap\"

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


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

### Aquirove in the browser

1. Pemiliknya membuka link dan tanda masuk, atau menciptakan akun baru dan memverifikasi email. Sebuah pendaftaran baru melanjutkan klaim setelah verifikasi.
2. Cek rekening yang ditunjukkan di halaman klaim. Untuk pemilik yang berbeda atau baru, gunakan sesi peramban yang terpisah. Akun yang ditanda-tangani adalah akun yang akan membayar untuk permintaan nanti.
3. Masukkan kode delapan digit pada halaman tersebut, meninjau kembali izin produk dan akses share-balance, kemudian disetujui. Pemiliknya menangani pendaftaran, penerimaan hukum, pengesahan email dan persetujuan.


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

### Finish di terminal asli

Setelah persetujuan, jalankan finish di profil asli dalam 24 jam. CLI menyimpan kunci pemilik, memverifikasinya dalam proses segar dan mengakui pemasangan. 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 segar · sama OS pengguna dan profil

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


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

### Konfirmasikan pemilik dan keseimbangan

Di auth status, verifikasi accountId yang dimaksudkan dan lingkup yang diberikan, ditambah bidang di bawah. FOGT membaca saldo segar secara terpisah; permintaan masa depan menghabiskan kredit bersama pemilik. Kredit sementara yang tidak digunakan tidak dipindahkan. Akun baru yang sesuai dengan kewajiban pendaftaran normal; mengklaim tidak menambahkan hibah tambahan.

Klaim klaim mengubah rekening yang ditagih. Untuk tugas baru di bawah pemilik, pilih ID baru. Mengecoh kembali sebuah uji coba menjalankan ID mengembalikan run_account_mismatch tanpa mengajukan pertanyaan lain; itu tidak mentransfer yang berjalan ke pemilik.

#### Medan - bidang yang diharapkan · kutipan tanggapan

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

- [BILANGAN BULULUL](https://flashdata.dev/ms/docs/guides/recurring-tasks/reference.md)
- [Penghargaan setelah mengklaim](https://flashdata.dev/ms/docs/guides/credits-and-billing/reference.md#trial)
- [Batal sambungan ini](https://flashdata.dev/ms/docs/guides/agent-access/reference.md#revoke)

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

## Pilih izin produk

Katalog kebenaran HTTP membezakan trialEligible daripada ownerAllowed. Sebelum pendaftaran pertama, minta hanya sumber yang diperlukan untuk tugas anda. requestedScopes mengandungi kebenaran yang diminta; scopes menunjukkan akses semasa kunci. Produk baharu memerlukan pemberian kebenaran yang jelas.

Kelulusan membenarkan penggunaan baki bersama pemilik, termasuk kredit yang dibeli. Sekatan sumber tidak menetapkan had perbelanjaan bagi setiap ejen. MCP OAuth ialah sambungan berasingan dan tidak memautkan profil CLI ini kepada akaun.

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

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

## Hanya perlu YouTube Download?

Xifac menggunakan kunci pemilik dengan izin youtube_download, mengimpornya, kemudian mengkonfigurasi penyimpanan tujuan. Download tidak menggunakan kredit pengadilan sementara.

CLI 1.2.1 masih membutuhkan sumber yang dapat diisi-ujian untuk init. Untuk Download-only onboarding sebelum signup, gunakan aliran klaim HTTP dalam auth.md. Jangan menambahkan sumber percobaan yang tidak berhubungan hanya untuk memotong pembatasan klien itu.

- [Import kunci pemilik](https://flashdata.dev/ms/docs/guides/agent-onboarding/reference.md#existing)
- [Konfigur penyimpanan dan muat turun](https://flashdata.dev/ms/docs/guides/youtube-download-guide/reference.md)
- [Aliran HTTP](https://flashdata.dev/auth.md)

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

## Melanjutkan aliran berhenti

| Apa yang berhenti | Tindakan berikutnya |
| --- | --- |
| Daftar | Untuk 429, tunggu Retry-After. Untuk respon yang hilang, coba lagi init dengan profil, bukti yang sama dan masukan yang tepat. ¡Jaga keadaan yang sudah ada; jangan beralih IP atau memulai sidang pengganti. |
| Cari | Periksa trial-search dibawah. Sebuah tenggat waktu tidak membuktikan bahwa tidak ada pekerjaan yang diterima; jangan ubah lari ID untuk memaksa mencoba lagi. |
| Klaim link | Jika link tersebut kadaluarsa tetapi persidangannya valid, buat link segar di profil yang sama ketika pemilik sudah siap. Periksa pemilik yang ditandatangani sebelum persetujuan. |
| AYAH | Setelah disetujui, jalankan ulang auth finish dalam profil asli dalam 24 jam. Penundaan persetujuan, penantian yang terganggu atau pengakuan yang hilang tidak memerlukan pendaftaran baru. |
| Luput / keadaan hilang | Untuk pengadilan atau penyerahan yang telah luput, atau direktori negara swasta yang hilang, gunakan rekoneksi yang disetujui oleh pemilik atau impor kunci pemilik. |

### Periksalah pencarian tersimpan · tidak ada pertanyaan baru

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

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