# 에이전트 체험 및 계정 연결

서명하기 전에 Google 검색을 시도하면 소유자 계정을 연결하여 동일한 CLI 프로파일을 사용하여 유지합니다.

Canonical 참고: https://flashdata.dev/ko/docs/guides/agent-onboarding
검토: 2026-11-04 FlashData

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

## 1. 자주 묻는 질문

이 무료 체크를 에이전트의 환경에서 실행하십시오. data.accessVerified는 true이고 Google Search는 3를 단계로 접근하고 건너뛰기 위하여 허용됩니다. 저장되지 않은 프로필이 없다면, 2를 단계로 계속합니다. 아래 복구 섹션을 사용하여 구출 또는 차단 된 액세스.

### 이 프로필을 확인

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

- [CLI 설치](https://flashdata.dev/ko/docs/guides/flashdata-cli/reference.md#install)
- [이미 열쇠가 있습니까?](https://flashdata.dev/ko/docs/guides/agent-onboarding/reference.md#existing)
- [Recover 액세스](https://flashdata.dev/ko/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 NAME과 --state-dir ABSOLUTE_PATH를 각 명령에 추가하여 신선한 터미널에 포함하십시오.

FLASHDATA_API_KEY는 저장된 키보다 우선합니다. 이 프로필의 체험과 인증 정보 전달을 테스트할 때는 이 변수를 설정하지 마세요. 같은 OS 사용자를 사용하고 비공개 상태 디렉터리를 보존하세요. 이 디렉터리에는 인증 정보, 등록 증명 및 실행 기록이 저장됩니다.

auth status에서 credentialProtection를 검사하십시오. Windows는 DPAPI, macOS는 Keychain를 사용하고, 머리없는 Linux는 소유자 전용 자격 증명 파일을 사용할 수 있습니다. OS 상점은 --credential-store os에 요구될 수 있습니다.


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

### 대신 기존의 소유자 키를 사용합니다

터미널을 사용하는 사람은 아래의 숨겨진 입력 프롬프트로 키를 가져온 뒤 체험 등록과 계정 연결을 건너뛸 수 있습니다. 에이전트는 비밀 저장소의 키를 --api-key-stdin --non-interactive 옵션과 함께 stdin으로 전달해야 합니다. 키를 명령 인수나 채팅에 넣지 마세요.

이미 다른 액세스를 보유한다면 auth login --replace를 사용하기 전에 검토하십시오. 또 다른 열쇠를 수입하는 것은 주장 handoff가 아닙니다. MCP OAuth는 또한 분리되는 주인 연결입니다.

#### 숨겨진 키 프롬프트 · 인간 맨끝

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

- [API 키 관리](https://flashdata.dev/ko/docs/guides/api-keys-and-permissions/reference.md)
- [MCP 및 기타 인증 옵션](https://flashdata.dev/ko/docs/guides/agent-access/reference.md)

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

## 2. 1개의 자격이 된 평가판을 시작하십시오

discover를 먼저 실행하십시오. data.onboardingAvailable 및 data.onboarding.trial의 허용을 확인하십시오. Onboarding이 사용 가능한 경우, 실행 init 한 번에 Google Search. 서버는 eligibility를 검사합니다; CLI는 오프닝 signup 없이 임시 열쇠를 저장하거나 조회를 제출합니다.

### 예약 가능 여부 · 무료

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

### 시험 수당 및 한계

해당 요청은 동일한 시작 신용 잔액을 공유합니다. 그들은 나머지 요청 또는 독립적 인 quotas가 아닙니다. YouTube Download와 같은 소유자 전용 소스는 체험 크레딧을 보낼 수 없습니다.

| 지원하다 | 자주 묻는 질문 |
| --- | --- |
| 크레딧 / 만료 | 현재 기본: 1 크레딧 72 시간. 보조금과 일생에 대한 발견을 읽으십시오. 영수증은 만료 및 승인 된 소스를 제공합니다. |
| - 연혁 | 3 등록은 24 시간 당 IP 당 등록, 그 IP의 사용자에 의해 공유. 글로벌 시험 캡은 새로운 등록을 일시 중지 할 수 있습니다. |
| 계정 관리 | 시험 작업 순차적 유지: 일괄 처리 및 1 건당 한 항목. 더 많은 것을 제출하기 전에 반환 한도 확인. |

- [크레딧 및 요청 수](https://flashdata.dev/ko/docs/guides/credits-and-billing/reference.md#estimate)
- [다운로드 전용 액세스](https://flashdata.dev/ko/docs/guides/agent-onboarding/reference.md#download-only)

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

## 3. 한 검색을 시도

첫 번째 미리보기. data.estimateAvailable, estimatedCredits를 덮는 data.estimate.prices 및 availableCredits에 있는 유효한 google_search 가격을 요구합니다. 체크가 실패하면 중지합니다. 미리보기는 무료입니다; 다음 명령은 하나의 검색을 제출합니다.

### 잔액 및 비용 확인 · 쿼리 없음

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

### 1개의 검색 · 최대 5개의 결과

```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/ko/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. 그 페이지에 8자리 코드를 입력하고, 제품 허가 및 공유밸런스 액세스를 검토 한 다음 승인. 소유자는 가입, 법적 수용, 이메일 검증 및 동의를 처리합니다.


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

- [recurring 작업 설정](https://flashdata.dev/ko/docs/guides/recurring-tasks/reference.md)
- [청구 후 크레딧](https://flashdata.dev/ko/docs/guides/credits-and-billing/reference.md#trial)
- [이 연결을 호출](https://flashdata.dev/ko/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 권한을 가진 소유자 키를 사용하여, 가져 오기, 다음 목적지 저장을 구성합니다. 다운로드는 임시 체험 크레딧을 사용하지 않습니다.

CLI 1.2.1의 init에는 여전히 체험 가능한 소스가 필요합니다. 가입 전 Download 전용 온보딩에는 auth.md의 HTTP 계정 연결 흐름을 사용하세요. 클라이언트 제한을 우회하려고 관련 없는 체험 소스를 추가하지 마세요.

- [소유자 키 가져 오기](https://flashdata.dev/ko/docs/guides/agent-onboarding/reference.md#existing)
- [저장 및 다운로드 구성](https://flashdata.dev/ko/docs/guides/youtube-download-guide/reference.md)
- [다운로드 전용 HTTP 흐름](https://flashdata.dev/auth.md)

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

## 멈춰진 흐름

| 자주 묻는 질문 | 다음 작업 |
| --- | --- |
| 이름 * | 429의 경우, Retry-After를 기다리십시오. 손실된 응답을 위해, 동일한 단면도, 증거 및 정확한 입력을 가진 retry init. 기존 상태 유지; IP를 전환하지 않거나 교체 시험 시작. |
| 검색 | 아래 trial-search를 검사하십시오. 운동은 작동하지 않는 것을 증명하지 않습니다; retry를 강제하기 위해 ID를 실행하지 마십시오. |
| Claim 링크 | 링크가 만료되었지만 체험은 유효하다면 소유자가 준비 될 때 동일한 프로파일에 신선한 링크가 생성됩니다. 승인하기 전에 서명 된 소유자를 확인하십시오. |
| 핸즈프리 | 승인 후, 24 시간 내에 원래 프로필에서 재 실행 auth finish. 잃어버린 승인, 중단 된 대기 또는 분실 된 승인은 새로운 등록이 필요하지 않습니다. |
| 만료 / 분실 상태 | 만료된 체험 또는 손전등의 경우, 또는 분실된 개인 상태 디렉토리, 사용 소유자 승인 재연결 또는 소유자 키를 가져올 수 있습니다. |

### 저장된 검색을 검사 · 새로운 쿼리 없음

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

- [복구 가이드](https://flashdata.dev/ko/docs/guides/agent-recovery/reference.md)
