# تجربة الوكيل وربط الحساب

حاول Google البحث قبل التوقيع، ثم ربط حساب المالك للاستمرار في استخدام نفس CLI لمحة عامة

مرجع كانوني: https://flashdata.dev/ar/docs/guides/agent-onboarding
Reviewed: 2026-11-04 by FlashData

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

## 1. التحقق من إمكانية الوصول القائمة

شغّل هذا الفحص المجاني في بيئة وكيلك. إذا كانت data.accessVerified بقيمة true وكان Google Search مسموحًا، فأعد استخدام الوصول وانتقل إلى الخطوة 3. إن لم يوجد ملف شخصي محفوظ، فتابع إلى الخطوة 2. استأنف الوصول المعلّق أو المحظور باستخدام قسم الاستعادة أدناه.

### تحقق من هذا

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

- [Install CLI](https://flashdata.dev/ar/docs/guides/flashdata-cli/reference.md#install)
- [هل لديك مفتاح بالفعل؟](https://flashdata.dev/ar/docs/guides/agent-onboarding/reference.md#existing)
- [Recover access](https://flashdata.dev/ar/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 على المفتاح المحفوظ. اترك هذا المتغير غير مضبوط عند اختبار التجربة وتسليم بيانات الاعتماد لهذا الملف الشخصي. استخدم مستخدم نظام التشغيل نفسه واحتفظ بدليل الحالة الخاص؛ فهو يحتوي على بيانات الاعتماد وإثبات التسجيل وسجل عمليات التشغيل.

Inspect credentialProtection in 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/ar/docs/guides/api-keys-and-permissions/reference.md)
- [MCP and other authentication options](https://flashdata.dev/ar/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>

### تحقق من إيصال التسجيل

Expect ok: true, data.status: trial and google_search in 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، أن تنفق ائتمانات التجربة.

| Limit | ما الذي سيتحقق منه؟ |
| --- | --- |
| الأرصدة الدائنة/النهائية | العجز الحالي: ائتمان 1 لساعات 72. (أ) الاكتشاف الجاهز للمنحة والعمر؛ ويعطي الإيصال النفي والمصادر الممنوحة. |
| التسجيل | 3 تسجيلات لكل عنوان IP خلال 24 ساعة، يشترك فيها مستخدمو العنوان نفسه. وقد يوقف الحد العالمي للتجارب التسجيلات الجديدة أيضًا. |
| التكافل | إبقاء أعمال التجربة متتالية: بند واحد لكل دفعة، وواحد في انتظار العمل. تحقق من الحدود قبل تقديم المزيد. |

- [الأرصدة الدائنة وحسابات الطلب](https://flashdata.dev/ar/docs/guides/credits-and-billing/reference.md#estimate)
- [الوصول إلى الموقع الشبكي فقط](https://flashdata.dev/ar/docs/guides/agent-onboarding/reference.md#download-only)

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

## 3. حاول البحث

العرض الأول. Require data.estimateAvailable, an available google_search in data.estimate.prices, and availableCredits covering estimatedCredits. توقّفْ إذا a يَفْشلُ. The preview is free; the next command submit one search.

### الرصيد المتحقق والتكلفة؛ لا استفسار

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

### تحقق من النتيجة

Expect ok: true and data.status: done. اقرأوا ألقاب ووصلات ودميات من data.results[].organic، والشحنة من data.usage.credits. النتائج العضوية فارغة صحيحة. وقبل المطالبة، فإن تكرار هذه المهمة بالضبط مع شركة trial-search يعود إلى نتيجة إنقاذها. حافظ على المواصفات و الولاية وحافظ على أي نتائج التجربة التي تحتاجها

#### التحقق من الرصيد المتبقي مجانا

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

- [اقرأ رد البحث](https://flashdata.dev/ar/docs/guides/http-quickstart/reference.md#result)

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

## 4. حافظ على الدخول مع حساب المالك

المطالبة قبل التجربة تنتهي إذا كنت تريد الاستمرار أو الاستخدام المتكرر. عندما يكون المالك جاهزاً، افحص هذا في الملف الأصلي. Share only data.claimUrl and data.confirmationCode with them; data.expiresAt gives the deadline.

وتستغرق هذه الحلقة دقائق من الـ 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 المقصود والصلاحيات الممنوحة والحقول أدناه. اقرأ الرصيد الحالي منفصلًا؛ فالطلبات المستقبلية تستهلك رصيد المالك المشترك. لا ينتقل الرصيد المؤقت غير المستخدم. يخضع الحساب الجديد لأهلية التسجيل المعتادة؛ ولا يضيف ربط الحساب منحة تسجيل إضافية.

يغيّر ربط الحساب الحسابَ الذي تُحتسب عليه الرسوم. اختر معرّف تنفيذ جديدًا لمهمة جديدة تخص المالك. تعيد إعادة استخدام معرّف تنفيذ التجربة run_account_mismatch دون إرسال استعلام آخر؛ ولا تنقل ذلك التنفيذ إلى المالك.

#### مقتطفات الاستجابة

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

- [إنشاء مهام متكررة](https://flashdata.dev/ar/docs/guides/recurring-tasks/reference.md)
- [الأرصدة الدائنة بعد المطالبة](https://flashdata.dev/ar/docs/guides/credits-and-billing/reference.md#trial)
- [إحياء هذا الوصل](https://flashdata.dev/ar/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 فقط قبل التسجيل، استخدم مسار الربط عبر HTTP في auth.md. لا تضف مصدر تجربة غير مرتبط لمجرد تجاوز قيد العميل.

- [استيراد مفتاح المالك](https://flashdata.dev/ar/docs/guides/agent-onboarding/reference.md#existing)
- [تخزين المعلومات ونقلها](https://flashdata.dev/ar/docs/guides/youtube-download-guide/reference.md)
- [تحميل فقط HTTP التدفق](https://flashdata.dev/auth.md)

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

## إستعادة التدفق المتوقف

| توقف | الإجراء التالي: |
| --- | --- |
| السجل | For 429انتظر Retry-After. وللاستجابة المفقودة، يعاد النظر إلى الـ init بنفس الشكل، والإثبات، والمدخلات الدقيقة. إبقاء الدولة القائمة؛ ولا تبديل IP أو بدء تجربة بديلة. |
| بحث | Inspect trial-search below. ولا يثبت انقطاع الوقت أنه لم يُقبل أي عمل؛ ولا يغير تشغيل ID لإجبار عملية إعادة. |
| الصلة بين المطالبات | وإذا انتهت صلاحية الرابط ولكن التجربة صحيحة، فإن إنشاء صلة جديدة في نفس الصورة عندما يكون المالك مستعدا. تحقق من المالك الموقع قبل الموافقة |
| تسليم | وبعد الموافقة، أعيد تشغيل auth finish في الملف الأصلي في غضون ساعات 24. وفي انتظار الموافقة، لا يتطلب الانتظار المتوقف أو الإقرار المفقود تسجيلا جديدا. |
| الدولة المفقودة/المفقودة | لاستئناف التجربة أو التسليم، أو وضع دليل حكومي خاص مفقود، أو استخدام إعادة الاتصال التي يوافق عليها المالك أو استيراد مفتاح المالك. |

### التفتيش على البحث المنقذ لا يوجد استفسار جديد

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

- [دليل الاسترداد](https://flashdata.dev/ar/docs/guides/agent-recovery/reference.md)
