# Okres próbny agenta i powiązanie konta

Spróbuj wyszukać Google przed rejestracją, a następnie podłącz konto właściciela, aby utrzymać przy użyciu tego samego profilu CLI.

Odniesienie kanoniczne: https://flashdata.dev/pl/docs/guides/agent-onboarding
Przegląd: 2026-11-04 przez FlashData

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

## 1. Sprawdź istniejący dostęp

Sprawdź to w środowisku twojego agenta. Jeśli data.accessVerified en true oraz Google Search jest dozwolone, ponowne użycie, że dostęp i przejść do kroku 3. Bez zapisanego profilu, kontynuuj krok 2. Wznowienie dostępu oczekującego lub zablokowanego za pomocą poniższego punktu odzyskiwania.

### Sprawdź ten profil

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

- [Zainstaluj CLI](https://flashdata.dev/pl/docs/guides/flashdata-cli/reference.md#install)
- [Masz już klucz?](https://flashdata.dev/pl/docs/guides/agent-onboarding/reference.md#existing)
- [Dostęp do recover](https://flashdata.dev/pl/docs/guides/agent-onboarding/reference.md#help)

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

### Zachowaj ten sam profil

Raporty o dostępie roboczym data.accessVerified: true, access: ready w data.identity.identity oraz google_search w data.identity.permittedSources.

Polecenia te używają domyślnego profilu i działają w Bash lub PowerShell. W przypadku istniejącego profilu lub katalogu stanu niestandardowego należy dołączyć tę samą nazwę --profile oraz --state-dir ABSOLUTE_PATH do każdego polecenia, w tym w nowym terminalu.

FLASHDATA_API_KEY ma pierwszeństwo przed zapisanym kluczem. Nie ustawiaj tej zmiennej podczas testowania dostępu próbnego i przekazywania danych uwierzytelniających tego profilu. Używaj tego samego użytkownika systemu i zachowaj prywatny katalog stanu; zawiera dane uwierzytelniające, dowód rejestracji i historię uruchomień.

Sprawdzić credentialProtection w auth status. Windows używa DPAPI, macOS używa Keychain, a bezgłowy Linux może używać tylko własnego pliku. Dostępny sklep OS może być wymagany z --credential-store os.


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

### Użyj istniejącego klucza właściciela

Osoba w terminalu może zaimportować klucz przez ukryty sygnał poniżej i pomiń rejestrację próbną i roszczenia. Agenci powinni dostarczyć go na stdin z --api-key-stdin --non-interactive ze swojego tajnego sklepu; nigdy nie umieszczać klucza w argumentach lub czacie.

Jeśli profil posiada już inny dostęp, należy go przejrzeć przed użyciem auth login --replace. Importowanie innego klucza nie jest obowiązkiem przekazania roszczenia. MCP OAuth jest również oddzielnym połączeniem hosta.

#### Ukryty klucz short · terminal ludzki

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

- [Zarządzanie kluczami API](https://flashdata.dev/pl/docs/guides/api-keys-and-permissions/reference.md)
- [MCP i inne opcje uwierzytelniania](https://flashdata.dev/pl/docs/guides/agent-access/reference.md)

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

## 2. Rozpocząć jeden kwalifikujący się proces

Uruchom najpierw discover. Sprawdź data.onboardingAvailable i zasiłek w data.onboarding.trial. Jeśli jest dostępny, uruchom init raz dla Google Search. Serwer sprawdza kwalifikowalność; CLI zapisuje tymczasowy klucz bez otwierania rejestracji lub składania zapytania.

### Sprawdź dostępność · za darmo

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

### Uruchomienie tymczasowego dostępu

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

- [Bieżący protokół](https://flashdata.dev/auth.md)

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

### Sprawdź potwierdzenie rejestracji

Oczekuj ok: true, data.status: trial i google_search w data.connection.scopes. Przeczytaj data.connection.trialExpiresAt i data.startingAllowanceCredits. Klucz jest zapisany lokalnie, a nie drukowany. Jeśli data.currentBalanceAvailable jest false, przed zapytaniem należy ponownie uruchomić bezpłatne sprawdzenie salda.

Jeśli konfiguracja już stworzyła dostęp, użyj go ponownie. Aby oznaczyć pierwszą rejestrację agenta, należy dodać --client codex --audience coding lub --client openclaw --audience personal. Utrzymanie dokładnego wejścia na powtórkę; etykiety nie przyznają uprawnień.


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

### Dodatek na badania i limity

Ekwiwalenty wniosków dzielą ten sam początkowy bilans kredytowy; nie są to pozostałe wnioski ani niezależne kwoty. Tylko właściciele źródeł, takich jak YouTube Download, nie mogą wydawać kredytów próbnych.

| Granica | Co sprawdzić |
| --- | --- |
| Kredyty / wygaśnięcie | Bieżące niewykonanie zobowiązania: kredyt 1 dla godzin 72. Odczytaj odkrycie dotacji i okresu jej trwania; pokwitowanie daje wygaśnięcie i przyznane źródła. |
| Rejestracja | 3 rejestracje na IP na 24 godziny, udostępniane przez użytkowników tego IP. Globalny limit próbny może również wstrzymać nowe rejestracje. |
| Konkursowe | Zachować pracę próbną sekwencyjną: jeden element na partię i jeden w toku pracy. Sprawdź zwrócone limity przed przesłaniem więcej. |

- [Kredyty i wnioski się liczą](https://flashdata.dev/pl/docs/guides/credits-and-billing/reference.md#estimate)
- [Dostęp tylko do pobierania](https://flashdata.dev/pl/docs/guides/agent-onboarding/reference.md#download-only)

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

## 3. Spróbuj jednego wyszukiwania

Podgląd pierwszy. Wymagane data.estimateAvailable, dostępna cena google_search w data.estimate.prices i availableCredits na pokrycie estimatedCredits. Zatrzymaj się, jeśli czek nie wypali. Podgląd jest darmowy; następne polecenie przedstawia jedno wyszukiwanie.

### Sprawdź bilans i koszt · bez zapytania

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

### Jedno wyszukiwanie · do pięciu wyników

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


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

### Sprawdź wynik

Oczekuj ok: true i data.status: done. Czytaj tytuły, linki i snippety z data.results[].organic, a opłata z data.usage.credits. Pusty wynik organiczny jest ważny. Przed twierdzeniem, powtarzając to dokładne zadanie z trial-search zwraca zapisany wynik. Zachowaj profil i stan, i zachować wszelkie wyniki badań, których potrzebujesz.

#### Sprawdź pozostałe saldo · wolne

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

- [Przeczytaj odpowiedź wyszukiwania](https://flashdata.dev/pl/docs/guides/http-quickstart/reference.md#result)

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

## 4. Zachować dostęp do konta właściciela

Zaskarżyć przed zakończeniem procesu, jeśli chcesz kontynuować lub ponownie używać. Kiedy właściciel jest gotowy, uruchom to w oryginalnym profilu. Podziel się tylko data.claimUrl i data.confirmationCode z nimi; data.expiresAt podaje termin.

Link trwa 15 minut, lub do czasu wygaśnięcia procesu, jeśli wcześniej. Tworzenie odnośnika nie zatwierdza kredytów dostępu lub zakupu.

### Utwórz link do roszczenia, gdy właściciel jest gotowy

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


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

### Zatwierdzenie w przeglądarce

1. Właściciel otwiera link i podpisuje się, lub tworzy nowe konto i weryfikuje e-mail. Nowy podpis ponownie zgłasza wniosek po weryfikacji.
2. Sprawdź konto pokazane na stronie roszczenia. Dla innego lub nowego właściciela, użyj oddzielnej sesji przeglądarki. Konto signed- na koncie jest to konto, które będzie płacić za późniejsze wnioski.
3. Wprowadź ośmiocyfrowy kod na tej stronie, przejrzyj uprawnienia do produktów i dostęp do bilansu, a następnie zatwierdź. Właściciel zajmuje się rejestrowaniem, akceptacją prawną, weryfikacją e-mailem i zgodą.


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

### Zakończ w oryginalnym terminalu

Po zatwierdzeniu, uruchomić finish w oryginalnym profilu w obrębie 24 godzin. CLI zapisuje klucz właściciela, weryfikuje go w nowym procesie i uznaje instalację. Żaden klucz nie jest kopiowany z przeglądarki.

#### Zapisz i zweryfikuj dostęp właściciela

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

#### Następnie sprawdzić ze świeżego terminala · ten sam użytkownik OS i profil

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


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

### Potwierdź właściciela i saldo

W auth status zweryfikuj zamierzony accountId i przyznaj zakresy, plus pola poniżej. Odczyt świeżej równowagi oddzielnie; przyszłe wnioski wydają wspólne kredyty właściciela. Niewykorzystane tymczasowe kredyty nie są przenoszone. Nowe konto jest zgodne ze zwykłą kwalifikacją do rejestracji; twierdzenie nie dodaje dodatkowej dotacji do rejestracji.

Twierdzenie zmienia rachunek. Dla nowego zadania pod właścicielem, wybierz nowy bieg ID. Ponowne użycie przebiegu próbnego ID zwraca run_account_mismatch bez składania kolejnego zapytania; nie przenosi się go do właściciela.

#### Oczekiwane pola · fragment odpowiedzi

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

- [Ustaw powtarzające się zadania](https://flashdata.dev/pl/docs/guides/recurring-tasks/reference.md)
- [Kredyty po stwierdzeniu](https://flashdata.dev/pl/docs/guides/credits-and-billing/reference.md#trial)
- [Otworzyć to połączenie](https://flashdata.dev/pl/docs/guides/agent-access/reference.md#revoke)

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

## Wybierz uprawnienia do produktów

Katalog uprawnień HTTP rozróżnia trialEligible i ownerAllowed. Przed pierwszą rejestracją poproś tylko o źródła potrzebne do zadania. requestedScopes zawiera żądane uprawnienia, a scopes określa bieżący dostęp klucza. Nowe produkty wymagają wyraźnego przyznania uprawnień.

Zatwierdzenie umożliwia korzystanie ze wspólnego salda właściciela, w tym zakupionych kredytów. Ograniczenia źródeł nie ustanawiają limitu wydatków na agenta. MCP OAuth to oddzielne połączenie i nie wiąże tego profilu CLI z kontem.

- [Katalog uprawnień i protokół HTTP](https://flashdata.dev/auth.md)

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

## Potrzebujesz tylko YouTube Download?

Użyj klucza właściciela za pozwoleniem youtube_download, zaimportuj go, a następnie skonfiguruj miejsce przeznaczenia. Pobieranie nie wykorzystuje tymczasowych kredytów próbnych.

CLI 1.2.1 nadal wymaga źródła kwalifikowanego do badania dla init. Do pobrania - tylko na pokładzie przed rejestracją, należy użyć przepływu reklamacji HTTP w auth.md. Nie dodawaj niepowiązanego źródła prób tylko po to, by obejść to ograniczenie klientów.

- [Importuj klucz właściciela](https://flashdata.dev/pl/docs/guides/agent-onboarding/reference.md#existing)
- [Konfiguracja pamięci masowej i pobierania](https://flashdata.dev/pl/docs/guides/youtube-download-guide/reference.md)
- [Przepływ tylko HTTP](https://flashdata.dev/auth.md)

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

## Wznowić zatrzymany przepływ

| Co się zatrzymało | Następna akcja |
| --- | --- |
| Rejestr | Dla 429, czekać na Retry-After. Aby uzyskać utraconą odpowiedź, ponownie wypróbuj init z tym samym profilem, dowodem i dokładnym wejściem. Zachować istniejący stan; nie przełączać IP ani nie rozpoczynać próby zastępczej. |
| Szukaj | Sprawdź trial-search poniżej. Timeout nie dowodzi, że praca nie została zaakceptowana; nie zmieniaj biegu ID, aby wymusić ponowną próbę. |
| Powiązanie stron | Jeśli link wygasł, ale proces jest ważny, utworzyć nowy link w tym samym profilu, gdy właściciel jest gotowy. Sprawdzić podpis właściciela przed zatwierdzeniem. |
| Przekazywanie | Po zatwierdzeniu, ponownie uruchomić auth finish w oryginalnym profilu w ciągu 24 godzin. W oczekiwaniu na zatwierdzenie, przerwa w czekaniu lub utracone potwierdzenie nie wymaga nowej rejestracji. |
| Wygasłe / utracone | W przypadku przeterminowanego procesu lub przekazania, lub utraconego prywatnego katalogu państwowego, należy użyć zatwierdzonego przez właściciela ponownego połączenia lub zaimportować klucz właściciela. |

### Sprawdź zapisane wyszukiwanie · nie ma nowego zapytania

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

- [Przewodnik po odzyskiwaniu](https://flashdata.dev/pl/docs/guides/agent-recovery/reference.md)
