كيفية إعداد مفاتيح واجهة برمجة تطبيقات Gemini لـ Discourse AI
المقدمة
يغطي هذا الموضوع كيفية إعداد مفتاح واجهة برمجة تطبيقات Google Gemini الخاص بك باستخدام مشروع حساب Google Cloud موجود. Gemini ليست خدمة مجانية، وبالتالي، ستحتاج إلى التأكد من تكوين الفوترة في مسؤول Google Cloud الخاص بك.
هناك بعض المعلومات المهمة مع روابط في صفحة إنشاء المفتاح على استوديو مطوري Gemini حول هذا الموضوع:
حسناً، لنبدأ!
ملاحظة: يلزم توفر وصول على مستوى المسؤول إلى Google Cloud ومنتدى Discourse الخاص بك.
الخطوة 1: إعداد مشروع Google Cloud
يتطلب إعداد مفتاح واجهة برمجة تطبيقات Gemini بشكل صحيح أن يكون لديك وصول إداري إلى حسابك على Google Cloud، وإنشاء مشروع فوترة يمكنك استخدامه لاستخدام مفتاح واجهة برمجة تطبيقات Gemini الخاص بك.
قد تقوم بإنشاء المفتاح الخاص بك في استوديو Gemini والاتصال بـ Google Cloud الخاص بك، ولكن من الأسهل نوعاً ما القيام بكل شيء من وحدة تحكم Google Cloud حتى لا تضطر إلى التبديل ذهاباً وإياباً.
توجه إلى مسؤول Google Cloud لواجهة برمجة التطبيقات للمؤسسة التي تتبع لها، وتأكد من أنك في المؤسسة الأم (يمكنك رؤيتها في الحقل الموجود في الأعلى بجوار شعار Google Cloud).
سيتعين عليك إنشاء مشروع لمفتاح Gemini الخاص بك إذا لم يكن لديك واحد بالفعل تود استخدامه (لاحظ أن رابط تحديد أو إنشاء مشروع جديد موجود في أعلى اليسار من الصفحة).
لإنشاء مشروع جديد، أكمل صفحة إنشاء مشروع جديد (تأكد من تحديد مؤسستك في حقل القائمة المنسدلة المناسب).
لإدارة الفوترة لمشروعك، ستحتاج إلى إعداد حساب فوترة للمشروع في فوترة Google Cloud، بافتراض أن لديك فواتير مُعدة للمؤسسة التي تتبع لها. يمكنك (أو مدير حساب الفوترة الخاص بك) القيام بذلك لاحقاً بعد إنشاء المفتاح. لاحظ أن هناك حدوداً للمشاريع ومشاريع الفوترة اعتماداً على حساب Google Cloud للمؤسسة التي تتبع لها. لتمكين الفوترة على مشروعك، انتقل إلى علامة تبويب “الفوترة” (Billing) في قائمة التنقل في Google Cloud وقم بربط حساب فوترة (راجع رابط “إدارة حسابات الفوترة”) وقم بتمكين الفوترة للمشروع من صفحة مشاريع الفوترة.
الخطوة 2: إنشاء مفتاح واجهة برمجة تطبيقات Gemini
هام! تذكر استخدام مفاتيح واجهة برمجة التطبيقات الخاصة بك بأمان. يرجى قراءة الحفاظ على مفتاح واجهة برمجة التطبيقات الخاص بك آمناً و أفضل الممارسات لاستخدام مفاتيح واجهة برمجة التطبيقات بأمان بعناية قبل المتابعة.
أنت الآن جاهز لإنشاء مفتاح واجهة برمجة تطبيقات في المشروع. انتقل إلى بيانات الاعتماد لهذا المشروع، وانقر على رابط “+ إنشاء بيانات اعتماد” في الأعلى، واختر “مفتاح واجهة برمجة تطبيقات” (API key) من الخيارات المنسدلة.
سيتم إنشاء مفتاح واجهة برمجة تطبيقات جديد لك. انسخه وقم بتأمينه في مكان آمن مثل تطبيق تخزين كلمات المرور. لا تشارك المفاتيح. هذا هو المفتاح الذي ستحتاج إلى إدخاله في إعدادات Discourse AI الخاصة بك.
يجب أن يكون المفتاح مدرجاً الآن في مفاتيح واجهة برمجة التطبيقات الخاصة بك. انقر عليه لتحرير مفتاح واجهة برمجة التطبيقات.
أعط المفتاح اسماً مناسباً، ثم انتقل إلى قسم قيود واجهة برمجة التطبيقات (API Restrictions) وحدد “تقييد المفتاح” (Restrict key)، ثم اختر “واجهة برمجة تطبيقات اللغة التوليدية” (Generative Language API).
احفظ المفتاح المحدث. انقر على رابط “إظهار المفتاح” (Show key) لمفتاحك الجديد وانسخه.
الخطوة 3: تكوين Gemini في إعدادات Discourse AI
يستخدم Discourse AI الآن نظام بيانات الاعتماد (Credentials) مركزي لإدارة مفاتيح واجهة برمجة التطبيقات. بدلاً من لصق المفتاح الخاص بك مباشرة في كل تكوين لنموذج اللغة الكبير (LLM)، تقوم أولاً بإنشاء بيانات اعتماد ثم تحددها عند تكوين نموذج Gemini الخاص بك.
الخطوة 3 أ: إنشاء بيانات اعتماد
انتقل إلى مسؤول > المكونات الإضافية > الذكاء الاصطناعي > بيانات الاعتماد (Admin > Plugins > AI > Credentials) وانقر على بيانات اعتماد جديدة (New Credential). امنحه اسماً وصفياً (على سبيل المثال، “مفتاح واجهة برمجة تطبيقات Gemini”) والصق مفتاح واجهة برمجة التطبيقات الذي نسخته من Google Cloud. احفظ بيانات الاعتماد.
نصيحة: يمكنك أيضاً إنشاء بيانات اعتماد في السياق — عند إضافة نموذج لغة كبير جديد في الخطوة التالية، انقر على زر + بجوار محدد بيانات الاعتماد لإنشاء واحد أثناء التنقل.
الخطوة 3 ب: إضافة نموذج لغة كبير Gemini
الآن انتقل إلى مسؤول > المكونات الإضافية > الذكاء الاصطناعي > نماذج اللغة الكبيرة (Admin > Plugins > AI > LLMs). انقر على إضافة (Add) وحدد أحد نماذج Gemini المُعدة مسبقاً (على سبيل المثال، Gemini 3 Flash أو Gemini 3 Pro). سيتم ملء اسم النموذج وعنوان URL للطرفية والإعدادات الأخرى مسبقاً لك. استخدم القائمة المنسدلة بيانات الاعتماد (Credential) لتحديد بيانات الاعتماد التي أنشأتها في الخطوة السابقة، ثم احفظ.
ملاحظة: يمكن إعادة استخدام نفس بيانات الاعتماد عبر تكوينات نماذج لغة كبيرة متعددة، لذلك تحتاج فقط إلى إدخال مفتاح واجهة برمجة تطبيقات Gemini الخاص بك مرة واحدة.
الخطوة 4: تتبع استخدام مفتاح واجهة برمجة تطبيقات Gemini
يمكنك تتبع استخدام مفتاح واجهة برمجة تطبيقات Gemini الخاص بك من لوحة معلومات Google Cloud في الفوترة ضمن “إدارة حساب الفوترة”.
ثم حدد مشروعك المحدد من قائمة مشاريع الفوترة، وسيعرض تقرير الفوترة حيث يمكنك تحديد المشروع (المشاريع) والتفاصيل الأخرى المختلفة التي تريد استخدامها لتتبع مشاريع مفتاح واجهة برمجة التطبيقات الخاص بك (يمكنك تتبع مفاتيح واجهة برمجة تطبيقات Google الأخرى المرتبطة بحساب Google Cloud الخاص بك هنا أيضاً، على سبيل المثال، إذا كان لديك واجهة برمجة تطبيقات بحث Google المخصص ومحرك البحث القابل للبرمجة مُعدة).
