# Пробный доступ агента и привязка к аккаунту

Попробуйте выполнить поиск Google перед регистрацией, а затем подключите учетную запись владельца, чтобы продолжать использовать тот же профиль CLI.

Каноническая ссылка: https://flashdata.dev/ru/docs/guides/agent-onboarding
Разработчик: 2026-11-04 by FlashData

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

## 1. Проверьте существующий доступ

Запустите бесплатную проверку в среде вашего агента. Если data.accessVerified является true и Google Search разрешен, повторно используйте этот доступ и пропустите шаг 3. Без сохранения профиля, продолжайте шаг 2. Возобновить ожидающий или заблокированный доступ с помощью раздела восстановления ниже.

### Проверьте этот профиль

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

- [Установить CLI](https://flashdata.dev/ru/docs/guides/flashdata-cli/reference.md#install)
- [У тебя уже есть ключ?](https://flashdata.dev/ru/docs/guides/agent-onboarding/reference.md#existing)
- [Восстановить доступ](https://flashdata.dev/ru/docs/guides/agent-onboarding/reference.md#help)

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

### Держите тот же профиль

Рабочие отчеты доступа data.accessVerified: true, access: ready в data.identity.identity и google_search в data.identity.permittedSources.

Эти команды используют профиль по умолчанию и работают в Bash или PowerShell. Для существующего именинного профиля или пользовательского каталога состояния добавьте одно и то же имя --profile и --state-dir ABSOLUTE_PATH к каждой команде, включая те, которые находятся в новом терминале.

FLASHDATA_API_KEY имеет приоритет над сохранённым ключом. Не задавайте эту переменную при проверке пробного доступа и передачи учётных данных для этого профиля. Используйте того же пользователя ОС и сохраняйте приватный каталог состояния: он содержит учётные данные, доказательство регистрации и историю запусков.

Проверьте credentialProtection в auth status. Windows использует DPAPI, macOS использует Keychain, а безголовый Linux может использовать файл учетных данных только для владельца. Доступный магазин OS может потребоваться с --credential-store os.


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

### Вместо этого используйте ключ владельца

Человек в терминале может импортировать ключ через скрытую подсказку ниже и пропустить регистрацию проб и претензии. Агенты должны поставлять его на stdin с --api-key-stdin --non-interactive из своего секретного магазина; никогда не ставьте ключ в аргументах или чате.

Если в профиле уже есть другой доступ, просмотрите его перед использованием auth login --replace. Импорт другого ключа не является претензией. MCP OAuth также является отдельным хост-соединением.

#### Скрытая ключевая подсказка · человеческий терминал

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

- [Управление API-ключами](https://flashdata.dev/ru/docs/guides/api-keys-and-permissions/reference.md)
- [MCP и другие варианты аутентификации](https://flashdata.dev/ru/docs/guides/agent-access/reference.md)

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

## 2. Начать одно приемлемое испытание

Сначала запустите discover. Проверьте data.onboardingAvailable и надбавку в data.onboarding.trial. Если есть возможность запускать init один раз для Google Search. Сервер проверяет соответствие требованиям; CLI сохраняет временный ключ без открытия регистрации или отправки запроса.

### Проверить наличие · бесплатно

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

### Запуск временного доступа

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

- [Текущий протокол](https://flashdata.dev/auth.md)

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

### Проверьте регистрационный чек

ok: true, data.status: trial и google_search в data.connection.scopes. Прочитайте data.connection.trialExpiresAt и data.startingAllowanceCredits. Ключ сохраняется локально, а не распечатывается. Если data.currentBalanceAvailable является false, перед запросом повторите проверку свободного баланса.

Если настройка уже создала доступ, повторно используйте его. Чтобы пометить первую регистрацию агента, добавьте --client codex --audience coding или --client openclaw --audience personal. Сохраняйте точный ввод на повторе; этикетки не дают разрешений.


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

### Пробный баланс и ограничения

Эквиваленты запросов имеют одинаковый стартовый кредитный баланс; они не являются оставшимися запросами или независимыми квотами. Источники только для владельцев, такие как YouTube Download, не могут тратить пробные кредиты.

| предел | Что проверить |
| --- | --- |
| Кредиты/срок годности | Текущие дефолты: кредит 1 для часов 72. Прочтите открытие для гранта и срока службы; квитанция дает срок действия и предоставленные источники. |
| Регистрация | Регистрация 3 на IP-адрес в течение часов 24, совместно используемая пользователями этого IP-адреса. Глобальная пробная квота может также приостановить новые регистрации. |
| параллелизм | Держите пробную работу последовательной: один пункт на партию и одна отложенная работа. Проверяйте возвращенные лимиты, прежде чем отправлять больше. |

- [Кредиты и количество запросов](https://flashdata.dev/ru/docs/guides/credits-and-billing/reference.md#estimate)
- [Доступ только для загрузки](https://flashdata.dev/ru/docs/guides/agent-onboarding/reference.md#download-only)

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

## 3. Попробуйте один поиск

Сначала предварительный просмотр. Требуйте data.estimateAvailable, доступную цену google_search в data.estimate.prices и availableCredits, покрывающую estimatedCredits. Остановитесь, если чек провалится. Предварительный просмотр бесплатный; следующая команда отправляет один поиск.

### Проверить баланс и стоимость · без запроса

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

### Один поиск - до пяти результатов

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


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

### Проверьте результат

Ожидайте ok: true и data.status: done. Читайте заголовки, ссылки и фрагменты из data.results[].organic, а также заряд от data.usage.credits. Чистые органические результаты действительны. Перед тем, как заявлять, повторение этой точной задачи с trial-search возвращает сохраненный результат. Сохраняйте профиль и состояние, а также сохраняйте любые результаты испытаний, которые вам нужны.

#### Проверить оставшийся баланс · бесплатно

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

- [Прочитайте поисковый ответ](https://flashdata.dev/ru/docs/guides/http-quickstart/reference.md#result)

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

## 4. Храните доступ с учетной записью владельца

Претензия до окончания испытания, если вы хотите продолжить или повторяющееся использование. Когда владелец готов, запустите его в исходном профиле. Делитесь с ними только data.claimUrl и data.confirmationCode; data.expiresAt дает крайний срок.

Ссылка длится 15 минуты, или до окончания испытания, если раньше. Создание ссылки не одобряет доступ или покупку кредитов.

### Создайте ссылку, когда владелец готов

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


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

### Утвердить в браузере

1. Владелец открывает ссылку и подписывается или создает новую учетную запись и проверяет электронную почту. Новая регистрация возобновляет претензию после проверки.
2. Проверьте учетную запись, показанную на странице претензии. Для другого или нового владельца используйте отдельный сеанс браузера. Зарегистрированный счет — это счет, который будет оплачивать последующие запросы.
3. Введите восьмизначный код на этой странице, просмотрите разрешения на продукт и доступ к общему балансу, а затем одобрите. Владелец обрабатывает регистрацию, юридическое принятие, проверку электронной почты и согласие.


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

### Заканчивайте в оригинальном терминале

После утверждения запустите finish в исходном профиле в течение часов 24. CLI сохраняет ключ владельца, проверяет его в новом процессе и подтверждает установку. Ключ не копируется из браузера.

#### Сохранить и проверить доступ владельца

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

#### Затем проверьте у нового терминала тот же пользователь и профиль OS.

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


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

### Подтвердите владельца и баланс

В auth status проверьте предполагаемый accountId и предоставленные области, а также поля ниже. Прочитайте свежий баланс отдельно; будущие запросы расходуют общие кредиты владельца. Неиспользованные временные кредиты не передаются. Новая учетная запись следует за обычным правом на регистрацию; требование не добавляет дополнительного гранта на регистрацию.

Заявка изменяет выставленный счет. Для нового задания под хозяина выберите новый прогон ID. Повторное использование пробного запуска ID возвращает run_account_mismatch без отправки другого запроса; он не передает этот запуск владельцу.

#### Ожидаемые поля · Отрывок ответа

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

- [Настройка повторяющихся задач](https://flashdata.dev/ru/docs/guides/recurring-tasks/reference.md)
- [Кредиты после предъявления](https://flashdata.dev/ru/docs/guides/credits-and-billing/reference.md#trial)
- [Отмените эту связь](https://flashdata.dev/ru/docs/guides/agent-access/reference.md#revoke)

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

## Выберите разрешения на продукцию

Каталог разрешений HTTP разделяет trialEligible и ownerAllowed. До первой регистрации запрашивайте только источники, нужные для задачи. requestedScopes содержит запрошенные разрешения, а scopes — текущий доступ ключа. Для новых продуктов требуется явное предоставление разрешения.

Одобрение разрешает использовать общий баланс владельца, включая купленные кредиты. Ограничения источников не устанавливают лимит расходов для отдельного агента. MCP OAuth — отдельное подключение; оно не привязывает этот профиль CLI к аккаунту.

- [Каталог разрешений и протокол HTTP](https://flashdata.dev/auth.md)

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

## Нужен только YouTube Download?

Используйте ключ владельца с разрешением youtube_download, импортируйте его, а затем настройте хранилище назначения. Download не использует временные пробные кредиты.

CLI 1.2.1 по-прежнему нуждается в источнике, пригодном для тестирования init. Для загрузки только перед регистрацией используйте поток претензий HTTP в auth.md. Не добавляйте несвязанный источник исследования, чтобы обойти это ограничение клиента.

- [Импорт ключа владельца](https://flashdata.dev/ru/docs/guides/agent-onboarding/reference.md#existing)
- [Настройка хранилища и загрузка](https://flashdata.dev/ru/docs/guides/youtube-download-guide/reference.md)
- [Скачать HTTP Flow](https://flashdata.dev/auth.md)

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

## Возобновить остановленный поток

| Что остановилось | Следующее действие |
| --- | --- |
| регистрировать | Для 429 дождитесь Retry-After. Для потерянного ответа перезагрузите init с тем же профилем, доказательством и точным вводом. Сохраняйте существующее состояние; не переключайте IP и не начинайте замену. |
| Поиск | Проверьте trial-search ниже. Тайм-аут не доказывает, что работа не была принята; не меняйте пробег ID, чтобы заставить повторную попытку. |
| Ссылка на претензию | Если ссылка истекла, но пробная версия действительна, создайте новую ссылку в том же профиле, когда владелец готов. Проверьте подписавшегося владельца перед утверждением. |
| Увольнение | После утверждения перезапустите auth finish в исходном профиле в течение часов 24. В ожидании одобрения, прерванного ожидания или утерянного подтверждения не требуется новая регистрация. |
| Исчезнувшее/потерянное государство | Если пробный доступ или передача ключа истекли либо приватный каталог состояния потерян, выполните повторное подключение с одобрения владельца или импортируйте ключ владельца. |

### Проверить сохраненный поиск · нет нового запроса

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

- [Руководство по восстановлению](https://flashdata.dev/ru/docs/guides/agent-recovery/reference.md)
