# Ajan denemesi ve hesap bağlama

Aynı Google aramayı imzalamadan önce deneyin, o zaman aynı CLI profili kullanmaya devam etmek için bir sahibi hesabı bağlayın.

Canonical referans: https://flashdata.dev/tr/docs/guides/agent-onboarding
İnceleme: 2026-11-04 Tarafından FlashData

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

## 1. Mevcut erişim kontrolü

Bu ücretsiz check in your agent's environment. data.accessVerified, true ve Google Search'ye izin verilirse, 3'ye adım atabilir. Hiçbir kurtarma profili olmadan, 2'yu adım atmaya devam edin. Aşağıdaki kurtarma bölümünü kullanarak devam eden veya bloke edilen erişim.

### Bu profili kontrol edin

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

- [Yükleme yükleme CLI](https://flashdata.dev/tr/docs/guides/flashdata-cli/reference.md#install)
- [Zaten bir anahtar var mı?](https://flashdata.dev/tr/docs/guides/agent-onboarding/reference.md#existing)
- [Yeniden kayıt erişimi](https://flashdata.dev/tr/docs/guides/agent-onboarding/reference.md#help)

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

### Aynı profili Keep the same profile

Çalışma erişim raporları data.accessVerified: true, access: ready içeri in in in In in in içinde data.identity.identityVe google_search içeri in in in In in in içinde data.identity.permittedSources.

Bu komutlar, Bash veya PowerShell'da varsayılan profili ve çalışmasını kullanır. Mevcut bir profil veya özel devlet rehberi için, aynı --profile NAME ve --state-dir ABSOLUTE_PATH'yu yeni bir terminalde de dahil olmak üzere her komuta gönderin.

FLASHDATA_API_KEY, kayıtlı anahtardan önceliklidir. Bu profilin deneme erişimini ve kimlik bilgisi devrini test ederken bu değişkeni ayarlamayın. Aynı OS kullanıcısını kullanın ve özel durum dizinini koruyun; bu dizin kimlik bilgilerini, kayıt kanıtını ve çalıştırma geçmişini içerir.

Inspect credentialProtection içeri in in in In in in içinde auth status. Windows Kullanım kullanım kullanımı kullanır DPAPI, macOS Kullanım kullanım kullanımı kullanır KeychainVe kafasız Linux Bir sahibi yalnızca credential dosyasını kullanabilir. Mevcut bir an mevcut OS Dükkanlar ile gerekli olabilir --credential-store Os.


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

### Bunun yerine mevcut bir sahibinin anahtarını kullanın

Bir terminaldeki bir kişi aşağıda gizli bir şekilde anahtar ithal edebilir ve deneme kayıtlarını atlayabilir ve iddia edebilir. Ajanslar bunu tedarik etmeli stdin with with with ile --api-key-stdin --non-interactive Gizli mağazalarından; asla tartışma veya sohbette bir anahtar koymayın.

Profil zaten farklı erişime sahipse, auth login --replace kullanarak önce gözden geçirin. Başka bir anahtarı ithal etmek iddia elioff değildir. MCP OAuth aynı zamanda ayrı bir ev sahibi bağlantıdır.

#### Gizli anahtar · insan terminali

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

- [API anahtarı yönetimi](https://flashdata.dev/tr/docs/guides/api-keys-and-permissions/reference.md)
- [MCP ve diğer kimlik doğrulama seçenekleri](https://flashdata.dev/tr/docs/guides/agent-access/reference.md)

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

## 2. Uygun bir deneme başlatın

discover ilk önce. data.onboardingAvailable ve data.onboarding.trial'daki ödenekleri kontrol edin. Eğer dolap mevcutsa, init için bir kez Google Search çalıştırın. Sunucu uygunluk kontrol eder; CLI, açılış işareti olmadan geçici anahtarı kurtarır veya bir sorgu gönderir.

### Kontrol kullanılabilirliği · ücretsiz

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

### Geçici erişime başlayın

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

- [Mevcut protokol](https://flashdata.dev/auth.md)

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

### Kayıt makbulunu kontrol edin

ok: true, data.status: trial ve google_search'u data.connection.scopes'da bekliyor. data.connection.trialExpiresAt ve data.startingAllowanceCredits'u okuyun. Anahtar yerel olarak kurtarılır, basılı değil. data.currentBalanceAvailable, false ise, sorgulanmadan önce ücretsiz bakiye kontrolü yeniden çalıştırın.

Kurulum zaten erişim yarattıysa, yeniden kullanın. Bir ajanın ilk kayıtlarını etiketlemek için, --client codex --audience coding veya --client openclaw --audience personal. Yeniden denemede tam giriş yapın; etiketler izin vermez.


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

### Deneme izni ve sınırları

İstek eşdeğerleri aynı başlangıç kredi dengesini paylaşıyor; geri kalan istekler veya bağımsız kotalar değiller. YouTube Download gibi sadece kaynaklar deneme kredilerini yapamaz.

| Limit Sınır sınırı | Ne kontrol etmek için |
| --- | --- |
| Kredi / genişlet | Mevcut varsayılanlar: 1 kredi için 72 saatler. hibe ve yaşam için keşif okuyun; makbuz expiry'ye verir ve kaynaklar verilir. |
| Kayıt Kaydı Kayıt Kayıt Kayıt Kaydı | 3 IP başına kayıt kayıtları 24 Saatler, o IP kullanıcıları tarafından paylaşılan. Küresel deneme kapağı da yeni kayıtları durdurabilir. |
| Concurrency | Deneme görevlerini sırayla çalıştırın: her batch içinde bir öğe ve aynı anda bir bekleyen iş. Daha fazlasını göndermeden önce yanıttaki sınırları kontrol edin. |

- [Krediler ve talep sayıları](https://flashdata.dev/tr/docs/guides/credits-and-billing/reference.md#estimate)
- [Download-only access](https://flashdata.dev/tr/docs/guides/agent-onboarding/reference.md#download-only)

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

## 3. Bir arama deneyin

İlk önce. Gereklilik Gereklilik data.estimateAvailable, mevcut bir google_search fiyat fiyat fiyatı data.estimate.pricesVe availableCredits Tartla estimatedCredits. Bir çek başarısız olursa durdurun. Tanıtım ücretsizdir; bir sonraki komut bir arama gönderir.

### Kontrol dengesi ve maliyeti · sorgu yok

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

### One search · up to five results

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


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

### Sonucu kontrol edin

ok: true ve data.status: done'u bekleyin. Başlıkları, bağlantıları ve parçaları okuyun data.results[].organic, ve sorumlu data.usage.credits. Boş organik sonuçlar geçerlidir. Bahsedilmeden önce, bu kesin görevi trial-search ile tekrarlayın, kurtarılan sonucu döndürür. Profili ve devleti tut ve ihtiyacınız olan herhangi bir deneme sonuçlarını tut.

#### Kalan bakiyeyi kontrol edin · ücretsiz

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

- [Bir arama yanıtını okuyun](https://flashdata.dev/tr/docs/guides/http-quickstart/reference.md#result)

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

## 4. Bir sahibi hesabı ile erişim tutun

Denemeden önce talep devam etmek veya tekrarlamak istiyorsanız sona erer. Sahibi hazır olduğunda, bunu orijinal profilde çalıştırın. Sadece data.claimUrl ve data.confirmationCode'u onlarla paylaşın; data.expiresAt son tarih verir.

Bağlantı 15 dakika geçerlidir; deneme daha erken sona ererse bağlantı da sona erer. Bağlantıyı oluşturmak erişimi onaylamaz veya kredi satın almaz.

### Sahibi hazır olduğunda bir iddia bağlantısı oluşturun

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


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

### Tarayıcıda Approve

1. Sahibi bağlantı ve işaretleri açar veya yeni bir hesap yaratır ve e-postayı verir. Yeni bir işaret doğrulamadan sonra iddiayı yeniden başlatır.
2. Talep sayfasında gösterilen hesabı kontrol edin. Farklı veya yeni bir sahibi için, ayrı bir tarayıcı seansı kullanın. İmzalanan hesabı, daha sonra talepler için ödeyecek olan hesaptır.
3. Bu sayfada sekiz dijital kod girin, ürün izinlerini gözden geçirin ve paylaşılan-balance erişim, sonra onaylayın. Sahibi işaret eder, yasal kabul, e-posta doğrulama ve onay alır.


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

### Orijinal terminalde bitirin

Onaylandıktan sonra, koşmak finish Orijinal profil içinde 24 saatler. CLI, sahibi anahtarı kurtarır, taze bir süreçte bunu doğrular ve yüklemeyi kabul eder. Tarayıcıdan anahtar kopyalanmaz.

#### Kaydet ve doğrulama sahibi erişim

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

#### Sonra taze bir terminalden kontrol edin · aynı OS kullanıcı ve profil

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


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

### Sahibi onaylayın ve dengeyi onaylayın

auth status, amaçlanan accountId'u doğrulayın ve aşağıdaki alanlardan yararlanın. Taze bakiyeyi ayrı okuyun; gelecekteki talepler sahibinin ortak kredilerini harcar. Kullanılmamış geçici krediler transfer edilmez. Yeni bir hesap normal işaretleme uygunluk takip eder; iddia edilen ekstra işaret hibesi yoktur.

Faturalı hesabı değiştirir. Sahibi altında yeni bir görev için, yeni bir run ID. seçin. Bir deneme çalıştırmak için ID, run_account_mismatch'u başka bir sorgu göndermeden döndürür; bu sahibine giden transfer değildir.

#### Beklenilen alanlar · yanıt alıntı

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

- [Tekrarlanan görevleri oluşturun](https://flashdata.dev/tr/docs/guides/recurring-tasks/reference.md)
- [Krediler iddia ettikten sonra](https://flashdata.dev/tr/docs/guides/credits-and-billing/reference.md#trial)
- [Revoke this connection](https://flashdata.dev/tr/docs/guides/agent-access/reference.md#revoke)

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

## Ürün izinlerini seçin

HTTP izin kataloğu trialEligible ile ownerAllowed değerlerini ayırır. İlk kayıttan önce yalnızca görevinizin gerektirdiği kaynakları isteyin. requestedScopes istenen izinleri, scopes ise anahtarın mevcut erişimini gösterir. Yeni ürünler için açıkça izin verilmesi gerekir.

Onay, satın alınan krediler dâhil hesap sahibinin ortak bakiyesinin kullanılmasına izin verir. Kaynak kısıtlamaları ajan başına harcama sınırı oluşturmaz. MCP OAuth ayrı bir bağlantıdır ve bu CLI profilini hesaba bağlamaz.

- [İzin kataloğu ve HTTP protokolü](https://flashdata.dev/auth.md)

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

## Sadece YouTube Download'a mı ihtiyacınız var?

youtube_download iznine sahip bir hesap sahibi anahtarını içe aktarın, ardından hedef depolamayı yapılandırın. Download geçici deneme kredilerini kullanmaz.

CLI 1.2.1 hala init için uygun bir deneme kaynağı gerektirir. Yalnızca işaret etmeden önce yükleme için HTTP iddia akışını auth.md'da kullanın. Bu müşteri kısıtlamasını atlamak için ilgili bir deneme kaynağı eklemeyin.

- [Bir sahibin anahtarını İthalat](https://flashdata.dev/tr/docs/guides/agent-onboarding/reference.md#existing)
- [Configure storage and download](https://flashdata.dev/tr/docs/guides/youtube-download-guide/reference.md)
- [Download-only HTTP akışı](https://flashdata.dev/auth.md)

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

## Resume a stop flow

| Ne durdu? | Sonraki eylem |
| --- | --- |
| Register Register Register | 429 için Retry-After süresini bekleyin. Yanıt kaybolduysa init komutunu aynı profil, kanıt ve aynı girdilerle tekrarlayın. Mevcut durumu koruyun; IP değiştirmeyin ve yerine yeni deneme başlatmayın. |
| Ara | Aşağıdaki trial-search kaydını inceleyin. Zaman aşımı, işin kabul edilmediğini kanıtlamaz; yeniden denemeyi zorlamak için çalıştırma ID değerini değiştirmeyin. |
| Talep Linki | Bağlantının süresi dolmuş ancak deneme hâlâ geçerliyse, hesap sahibi hazır olduğunda aynı profilde yeni bağlantı oluşturun. Onaydan önce oturum açmış hesabın doğru olduğunu kontrol edin. |
| Handoff | Onaydan sonra, yenidenrun auth finish Orijinal profil içinde 24 saatler. Pending onayı, kesintili bir bekle ya da kayıp bir onay yeni bir kayıt gerektirmez. |
| Açıklama / kayıp devlet | Geç bir deneme veya eloff veya kayıp bir özel devlet rehberi için, sahibi onaylı bir yeniden bağlantı kullanın veya bir sahibi anahtar ithal edin. |

### Kurtarılan aramayı Inspect the save search · no new query

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

- [Recovery guide](https://flashdata.dev/tr/docs/guides/agent-recovery/reference.md)
