# ทดลองใช้เอเจนต์และเชื่อมโยงบัญชี

ลอง Google ค้นหาก่อนที่จะทําการเซ็น แล้วทําการเชื่อมต่อบัญชีผู้ใช้เจ้าของ เพื่อใช้ค่าเดิมต่อไป CLI โปรไฟล์

อ้างอิงทางคลอง: https://flashdata.dev/th/docs/guides/agent-onboarding
Recorder: 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/th/docs/guides/flashdata-cli/reference.md#install)
- [มีกุญแจแล้วเหรอ?](https://flashdata.dev/th/docs/guides/agent-onboarding/reference.md#existing)
- [การเข้าใช้อีกครั้ง](https://flashdata.dev/th/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 มีลำดับความสำคัญเหนือคีย์ที่บันทึกไว้ อย่าตั้งค่าตัวแปรนี้ขณะทดสอบการทดลองใช้และการส่งต่อข้อมูลรับรองของโปรไฟล์นี้ ใช้ผู้ใช้ OS คนเดิมและเก็บไดเรกทอรีสถานะส่วนตัวไว้ เพราะมีข้อมูลรับรอง หลักฐานการลงทะเบียน และประวัติการเรียกใช้งาน

ขอบเขตสี credentialProtection ใน auth status. Windows ใช้ DPAPI, macOS ใช้ Keychainและไร้หัว Linux อาจใช้แฟ้มที่เป็นเจ้าของเท่านั้น ที่มีอยู่ OS สามารถเรียกเก็บได้ --credential-store ออส


<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/th/docs/guides/api-keys-and-permissions/reference.md)
- [MCP และตัวเลือกการตรวจสอบสิทธิ์อื่น ๆ](https://flashdata.dev/th/docs/guides/agent-access/reference.md)

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

## 2. เริ่มการทดสอบอย่างเหมาะสม

เรียกใช้ discover ก่อน ตรวจสอบ data.onboardingAvailable และเงินบริจาคด้วย data.onboarding.trial. หากมีการใช้งานบนเครื่อง ให้ทํางาน init ครั้งเดียวสําหรับ Google Search. เซิร์ฟเวอร์ตรวจสอบความเข้ากันได้; CLI บันทึกกุญแจชั่วคราวโดยไม่ต้องเปิดการเซ็นหรือส่งคําร้องขอ

### Check Access free

```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 ที่ หมวก ทดสอบ ทั่ว โลก อาจ หยุด การ จด ทะเบียน ใหม่ ได้ ด้วย. |
| เงินตรา | ให้การทดลองทํางาน sequantial: หนึ่งรายการต่อชุด และหนึ่งในระหว่างงาน Check about miditions before. สืบค้นเมื่อทําการส่งข้อมูลเพิ่มเติม. |

- [เงิน เครดิต และ สิ่ง ที่ ขอ ไว้ นับ ว่า สําคัญ](https://flashdata.dev/th/docs/guides/credits-and-billing/reference.md#estimate)
- [ใช้งานแบบดาวน์โหลดอย่างเดียว](https://flashdata.dev/th/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/th/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 และให้ขอบเขตกับทุ่งด้านล่าง อ่านค่าสมดุลใหม่แยก; อนาคตต้องการใช้เครดิตที่ใช้ร่วมกันของเจ้าของ บัตรเครดิตชั่วคราวที่ไม่ได้ใช้ไม่มีการโอน บัญชีใหม่ต่อไปนี้การลงนามปกติ enjutions; อ้างว่าไม่มีการเพิ่มการเซ็นรับรองเพิ่มเติม

อ้างว่าเปลี่ยนบัญชีที่เรียกเก็บเงิน สําหรับงานใหม่ภายใต้เจ้าของ ให้เลือกตัวประมวลผลใหม่ ID ดําเนินการทดลองอีกครั้ง ID กลับค่า run_account_mismatch ไม่ต้องส่งคําถามอีก ข้อหนึ่ง; มันไม่ได้ทําการโอนสิ่งที่ประมวลผลไปยังเจ้าของ

#### การตอบรับที่ต้องการ

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

- [ตั้งค่างานที่เกิดขึ้นซ้ํา](https://flashdata.dev/th/docs/guides/recurring-tasks/reference.md)
- [เงิน เครดิต หลัง จาก ที่ อ้าง](https://flashdata.dev/th/docs/guides/credits-and-billing/reference.md#trial)
- [เรียกคืนการเชื่อมต่อนี้](https://flashdata.dev/th/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. สําหรับการดาวน์โหลดอย่างเดียวบนเครื่อง ก่อนที่จะทําการเซ็น, ใช้ HTTP รับการไหลเข้า auth.md. อย่าเพิ่มแหล่งการทดลองที่ไม่เกี่ยวข้องกัน เพียงเพื่อข้ามข้อห้ามของลูกค้า

- [นําเข้ากุญแจเจ้าของ](https://flashdata.dev/th/docs/guides/agent-onboarding/reference.md#existing)
- [ปรับแต่งการจัดเก็บและดาวน์โหลด](https://flashdata.dev/th/docs/guides/youtube-download-guide/reference.md)
- [ดาวน์โหลดได้อย่างเดียว HTTP การไล่ระดับสี](https://flashdata.dev/auth.md)

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

## การไหลที่หยุดค้างไว้

| อะไรหยุด | การกระทําถัดไป |
| --- | --- |
| ลงทะเบียน | สําหรับ 429รอ Retry-After. สําหรับการตอบสนองที่สูญหาย ให้ลองใหม่ init โดยมีโพรไฟล์เดียวกัน, พิสูจน์และป้อนข้อมูลที่แน่นอน คงสถานะเดิมไว้; อย่าสลับ IP หรือเริ่มต้นการทดลองแทน |
| ค้นหา | Inspect trial-search ด้านล่างนี้ เวลาหมดเวลา ไม่พิสูจน์ว่ามีการยอมรับงานใด ๆ อย่าเปลี่ยนการทํางาน ID เพื่อบังคับให้ลองใหม่ |
| อ้างที่อยู่เชื่อมโยง | หากลิงก์หมดอายุ แต่การทดสอบใช้ได้ โปรดสร้างที่อยู่เชื่อมโยงใหม่ในโพรไฟล์เดียวกันนี้เมื่อเจ้าของพร้อม ตรวจสอบเจ้าของที่ลงนามก่อนที่จะอนุมัติ |
| ส่งมอบ | หลังจากอนุมัติแล้ว ให้ทําอีกครั้ง auth finish ในโพรไฟล์เดิมภายใน 24 ชั่วโมง การอนุมัติตามคําสั่ง การรอที่ขัดหรือการยอมรับเสีย ไม่จําเป็นต้องมีการลงทะเบียนใหม่ |
| หมดอายุแล้ว / สูญเสียสถานะ | สําหรับการทดลองที่หมดอายุแล้ว หรือปล่อยไป หรือไดเรกทอรีส่วนตัวสูญหาย ให้ใช้การเชื่อมต่อเจ้าของ หรือนําเข้ากุญแจของเจ้าของ |

### แสดงเฉพาะการค้นหาที่บันทึกไว้

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

- [เครื่อง นํา ทาง ที่ ฟื้น ตัว](https://flashdata.dev/th/docs/guides/agent-recovery/reference.md)
