دليل إعداد BYOK — تهيئة مزوّدي الذكاء الاصطناعي
الفصل الحادي والثلاثون: دليل إعداد BYOK — تهيئة مزوّدي الذكاء الاصطناعي
فكّر في BYOK (Bring Your Own Key) كإحضار حبوب قهوتك الخاصة إلى مقهى يمتلك آلة إسبريسو — يوفّر SeaMeet محرك الاستخراج والتحليل، وأنت تُزوّد بيانات اعتماد الوصول إلى الذكاء الاصطناعي. يحافظ هذا على تدفق بياناتك مباشرةً بينك وبين مزوّد الذكاء الاصطناعي الذي اخترته، بدون وسيط.
يرشدك هذا الفصل عبر إعداد كلا المكوّنَين المطلوبَين: مفتاح ملخص الذكاء الاصطناعي (Gemini) ومزوّد وكيل الذكاء الاصطناعي (GitHub Copilot أو Claude Code).
أهداف الفصل
بعد قراءة هذا الفصل، ستكون قادرًا على:
- فهم المفاتيح المطلوبة ولماذا
- الحصول على مفتاح API Gemini مجاني من Google AI Studio
- تثبيت GitHub Copilot CLI وضبطه (الطبقة المجانية)
- تثبيت Claude Code CLI وضبطه كبديل
- التحقق من عمل كلا المكوّنَين
- تحديث مفتاح أو إزالته عند الحاجة
نظرة عامة: ما تحتاجه
يتكون BYOK من مكوّنَين:
┌─────────────────────────────────────────────────────────────┐
│ مكوّنات BYOK │
├──────────────────────┬──────────────────────────────────────┤
│ أ. ملخص الذكاء الاصطناعي │ مفتاح API Gemini (مطلوب) │
│ (مطلوب) │ يُشغّل: النسخ، الملخصات، │
│ │ بنود العمل، القرارات، الفصول │
├──────────────────────┼──────────────────────────────────────┤
│ ب. وكيل الذكاء الاصطناعي │ GitHub Copilot CLI ← أو → │
│ (تحتاج خيارًا واحدًا على الأقل) │ Claude Code CLI │
│ │ يُشغّل: تحليل لقطات الشاشة، │
│ │ استعلامات الذكاء الاصطناعي المخصصة │
└──────────────────────┴──────────────────────────────────────┘
يجب ضبط أ وخيار واحد على الأقل من ب لكي تعمل جميع ميزات الذكاء الاصطناعي.
الجزء أ: ملخص الذكاء الاصطناعي — مفتاح API Gemini
لماذا Gemini؟
يستخدم SeaMeet نموذج Gemini من Google للنسخ الصوتي، وملخصات الاجتماعات، واستخراج بنود العمل، والمخرجات الذكاء الاصطناعي ذات الصلة. تحتوي واجهة برمجة تطبيقات Gemini على طبقة مجانية سخية ت غطي أحمال عمل الاجتماعات النموذجية.
الحصول على مفتاح API Gemini
- افتح متصفحك وانتقل إلى Google AI Studio (aistudio.google.com/apikey)
- سجّل الدخول بحساب Google إذا طُلب منك
- انقر على Create API Key
- اختر أو أنشئ مشروع Google Cloud عند الطلب
- انسخ المفتاح المُنشأ (يبدأ بـ
AIza…)
الطبقة المجانية: تسمح الطبقة المجانية لـ Gemini بعدد كبير من استدعاءات API يوميًا. للاستخدام النموذجي لتسجيل الاجتماعات (بضع ساعات من الصوت أسبوعيًا)، الطبقة المجانية كافية لمعظم المستخدمين.
الخصوصية: يُرسَل صوتك مباشرةً إلى واجهة برمجة تطبيقات Google للنسخ. راجع سياسة استخدام بيانات Google للذكاء الاصطناعي إذا كان هذا يُثير مخاوف لحالة استخدامك.
إدخال مفتاحك في SeaMeet
أثناء معالج الإعداد (المرة الأولى بعد الاشتراك):
- يفتح المعالج تلقائيًا بعد اشتراكك
- الخطوة الأولى تُظهر قسم ملخص الذكاء الاصطناعي
- الصق مفتاح Gemini في حقل الإدخال
- يُتحقق من المفتاح تلقائيًا — سترى:
- ✅ علامة اختيار خضراء: المفتاح صحيح
- ❌ علامة X حمراء: المفتاح غير صحيح أو نُسخ بشكل خاطئ — تحقق وأعد اللصق
- انقر التالي للمتابعة إلى إعداد وكيل الذكاء الاصطناعي
لاحقًا، عبر الإعدادات:
- افتح الإعدادات (⚙️)
- انتقل إلى AI → مفاتيح API
- ابحث عن قسم ملخص الذكاء الاصطناعي
- انقر تعديل أو الصق في حقل مفتاح Gemini
- انقر حفظ — يُتحقق من المفتاح تلقائيًا
اختبار المفتاح وإزالته
في إعدادات مفاتيح API:
- زر اختبار — يتحقق من المفتاح مقابل واجهة برمجة تطبيقات Google
- زر إزالة — يحذف المفتاح المُخزَّن؛ ميزات ملخص الذكاء الاصطناعي ستكون غير متاحة حتى تُضيف مفتاحًا جديدًا
إذا فشل التحقق من مفتاح، يُمسح تلقائيًا لمنع تخزين مفتاح معطوب. فقط الصق مفتاحًا جديدًا.
الجزء ب: مزوّد وكيل الذكاء الاصطناعي
تحتاج إلى مزوّد وكيل ذكاء اصطناعي واحد على الأقل. يدعم SeaMeet حاليًا اثنَين:
| المزوّد | التكلفة | الحد | الأنسب لـ |
|---|---|---|---|
| GitHub Copilot CLI | مجاني (خطة Copilot المجانية) | 50 محادثة/شهر | البداية، الاستخدام الخفيف |
| Claude Code CLI | مدفوع (Claude Pro أو Max) | حدود أعلى | الاستخدام المنتظم، المستخدمون المتقدمون |
يمكنك تثبيت كليهما والتبديل بينهما من الإعدادات → AI.
الخيار الأول: GitHub Copilot CLI (مجاني)
GitHub Copilot CLI هي أداة سطر أوامر تستخدمها SeaMeet كوكيل الذكاء الاصطناعي. تشمل طبقة GitHub Copilot المجانية 50 طلب وكيل شهريًا — كافية للتحليل الأحياني للقطات الشاشة واستعلامات الذكاء الاصطناعي.
الخطوة الأولى: تثبيت GitHub Copilot CLI
اختر الطريقة التي تناسب نظامك:
Windows (winget):
winget install GitHub.cli
macOS (Homebrew):
brew install gh
Linux (apt):
sudo apt install gh
ملاحظة: تُظهر واجهة إعداد SeaMeet أزرار نسخ بجوار كل أمر — يمكنك نسخ الأمر الدقيق دون كتابته.
الخطوة الثانية: المصادقة مع GitHub
بعد التثبيت، افتح طرفية ونفّذ:
gh auth login
اتبع المطالبات لتسجيل الدخول إلى حساب GitHub الخاص بك. يربط هذا أداة سطر الأوامر بحساب GitHub الخاص بك ويُفعّل ميزات Copilot.
الخطوة الثالثة: الكشف في SeaMeet
- في إعداد مفاتيح API في SeaMeet (أو الإعدادات → AI → مفاتيح API):
- ابحث عن قسم وكيل الذكاء الاصطناعي → بطاقة GitHub Copilot
- انقر تحديث (🔄)
- يفحص SeaMeet عن أداة سطر الأوامر المثبّتة
- إذا وُجدت: تظهر حالة ✅ "مكتشف"
- إذا لم تُوجَد: تحقق من تثبيتك وكرّر
حد 50 محادثة/شهر: الخطة المجانية لـ Copilot كافية للبدء، لكن إذا استخدمت وكيل الذكاء الاصطناعي كثيرًا قد تصل إلى الحد. يمكنك الترقية إلى GitHub Copilot Pro، أو التبديل إلى Claude Code CLI لحدود أعلى.
الخيار الثاني: Claude Code CLI (مدفوع)
Claude Code هي أداة سطر الأوامر من Anthropic. تتطلب اشتراك Claude Pro أو Max لكن لها حدود استخدام أعلى من طبقة Copilot المجانية.
الخطوة الأولى: تثبيت Claude Code CLI
Windows (PowerShell):
irm https://claude.ai/install.ps1 | iex
macOS / Linux:
curl -fsSL https://claude.ai/install.sh | sh
تُظهر واجهة إعداد SeaMeet أزرار نسخ لكل أمر تثبيت.
الخطوة الثانية: المصادقة
بعد التثبيت، افتح طرفية ونفّذ:
claude auth
سجّل الدخول بحساب Anthropic (يتطلب خطة Claude Pro أو Max).
الخطوة الثالثة: الكشف في SeaMeet
- في الإعدادات → AI → مفاتيح API → وكيل الذكاء الاصطناعي → بطاقة Claude Code
- انقر تحديث (🔄) للكشف عن أداة سطر الأوامر المثبّتة
- تظهر ✅ "مكتشف" عند إيجادها
اختيار مزوّدك الافتراضي
إذا كان لديك كل من Copilot وClaude مثبّتَين، يتيح لك SeaMeet اختيار المستخدم افتراضيًا:
- اذهب إلى الإعدادات → AI → مفاتيح API
- في قسم وكيل الذكاء الاصطناعي، ستظهر كلتا البطاقتين كمكتشفتَين
- استخدم زر الانتقاء أو المحدد لاختيار المزوّد النشط
- يُستخدَم المزوّد المختار لجميع طلبات وكيل الذكاء الاصطناعي
يمكنك التبديل بين المزوّدَين في أي وقت من الإعدادات.
التحقق من عمل كل شيء
بعد الإعداد، أجرِ فحصًا شاملًا سريعًا:
اختبار ملخص الذكاء الاصطناعي:
- افتح أي تسجيل في مكتبتك
- انقر على AI Insights → "Generate Summary"
- إذا اكتمل بدون خطأ: ✅ مفتاح Gemini يعمل
اختبار وكيل الذكاء الاصطناعي:
- التقط لقطة شاشة باستخدام SeaMeet
- افتحها في عارض لقطات الشاشة
- انقر على علامة تبويب تحليل الذكاء الاصطناعي وا طرح سؤالًا
- إذا حصلت على رد: ✅ مزوّد وكيل الذكاء الاصطناعي يعمل
تحديث مفتاح
لتحديث مفتاح Gemini:
- الإعدادات → AI → مفاتيح API → ملخص الذكاء الاصطناعي → تعديل
- امسح المفتاح القديم والصق الجديد
- انقر حفظ
لتحديث مزوّد الوكيل:
- أعد تشغيل خطوات تثبيت/مصادقة أداة سطر الأوامر إذا انتهت صلاحية مفتاح
- انقر تحديث في SeaMeet لإعادة الكشف
مرجع سريع
┌────────────────────────────────────────────────────────────┐
│ دليل إعداد BYOK │
│ مرجع سريع │
├────────────────────────────────────────────────────────────┤
│ مصدر مفتاح Gemini │ aistudio.google.com/apikey (مجاني) │
│ الطبقة المجانية لـ Gemini │ سخية — كافية للاستخدام النموذجي │
│ إدخال المفتاح │ الإعدادات → AI → مفاتيح API → ملخص الذكاء الاصطناعي │
├────────────────────────────────────────────────────────────┤
│ تثبيت Copilot │ winget / brew / apt (مجاني) │
│ مصادقة Copilot │ gh auth login │
│ حد Copilot │ 50 محادثة/شهر (طبقة مجانية) │
├────────────────────────────────────────────────────────────┤
│ تثبيت Claude │ سكريبت تثبيت curl/irm (مدفوع) │
│ مصادقة Claude │ claude auth │
│ متطلبات Claude │ اشتراك Claude Pro أو Max │
├────────────────────────────────────────────────────────────┤
│ كشف المزوّد │ الإعدادات → AI → مفاتيح API → تحديث 🔄 │
│ التبديل بين المزوّدَين │ زر الانتقاء في قسم وكيل الذكاء الاصطناعي │
│ اختبار ملخص الذكاء الاصطناعي │ افتح تسجيل → "Generate Summary" │
└────────────────────────────────────────────────────────────┘
Last updated: 2026-03-20
← Chapter 30: Subscription & Billing | Chapter 32: GitHub Copilot Provider →
Published: