إنشاء تطبيق Google Chat باستخدام وكيل ذكاء اصطناعي من Gemini Enterprise

تشرح هذه الصفحة كيفية إنشاء إضافة Google Workspace تعمل في Google Chat وتتفاعل مع وكيل الذكاء الاصطناعي من Gemini Enterprise.

تستشعر وكلاء الذكاء الاصطناعي بيئتهم بشكل مستقل، ويستدلون على المعلومات، وينفّذون إجراءات معقّدة ومتعددة الخطوات لتحقيق هدف محدّد. في هذا البرنامج التعليمي، ستستخدم وكيل "إنشاء الأفكار" الذي توفّره Google تلقائيًا والذي يساعد في الابتكار وحلّ المشاكل لمستخدمي المؤسسات.

وكيل "العثور على أفكار للمحتوى" كتطبيق Chat

يعرض الرسم البياني التالي البنية ونمط المراسلة:

بنية تطبيق محادثة تم تنفيذه باستخدام وكيل ذكاء اصطناعي من Gemini Enterprise

في الرسم البياني السابق، يتفاعل المستخدم مع تطبيق Chat تم تنفيذه باستخدام وكيل الذكاء الاصطناعي من Gemini Enterprise، ويكون تدفق المعلومات على النحو التالي:

  1. يرسل المستخدم رسالة إلى تطبيق Chat، إما في رسالة مباشرة أو في مساحة Chat.
  2. تتلقّى منطق تطبيق Chat الرسالة وتعالجها، سواء تم تنفيذها في "برمجة تطبيقات Google" أو كخادم ويب يتضمّن نقاط نهاية HTTP.
  3. يتلقّى وكيل الذكاء الاصطناعي من Gemini Enterprise التفاعل ويعالجه.
  4. يمكن لتطبيق Chat أو وكيل الذكاء الاصطناعي اختياريًا التكامل مع خدمات Google Workspace، مثل "تقويم Google" أو "جداول بيانات Google"، أو خدمات Google الأخرى، مثل "خرائط Google" أو YouTube.
  5. يرسل تطبيق Chat الردود بشكل غير متزامن باستخدام Google Chat API لإعلام المستخدم بتقدّم وكيل الذكاء الاصطناعي.
  6. يتم تسليم الردود إلى المستخدم.

الأهداف

  • إعداد البيئة
  • نشر تطبيق Chat
  • ضبط إعدادات تطبيق Chat
  • اختبار تطبيق Chat

المتطلبات الأساسية

إعداد البيئة

تفعيل Chat API

قبل استخدام واجهات برمجة تطبيقات Google، عليك تفعيلها في مشروع على Google Cloud. يمكنك تفعيل واجهة برمجة تطبيقات واحدة أو أكثر في مشروع واحد على Google Cloud.

في Google Cloud Console، فعِّل Google Chat API.

تفعيل واجهة برمجة التطبيقات

ضبط شاشة موافقة OAuth

تتطلب جميع التطبيقات التي تستخدم OAuth 2.0 ضبط شاشة موافقة. يؤدي ضبط شاشة موافقة OAuth لتطبيقك إلى تحديد ما يتم عرضه للمستخدمين ومراجعي التطبيقات، وتسجيل تطبيقك لتتمكّن من نشره لاحقًا.

  1. في Google API Console، انتقِل إلى "القائمة" > منصة Google للمصادقة > العلامة التجارية.

    الانتقال إلى العلامة التجارية

  2. إذا سبق لك ضبط منصة Google للمصادقة، يمكنك ضبط إعدادات شاشة موافقة OAuth التالية في العلامة التجارية والجمهور والوصول إلى البيانات. إذا ظهرت لك رسالة لم يتم ضبط منصة Google للمصادقة بعد، انقر على البدء:
    1. ضمن معلومات التطبيق، في اسم التطبيق، أدخِل اسمًا للتطبيق.
    2. في البريد الإلكتروني لدعم المستخدمين، اختَر عنوان بريد إلكتروني للدعم يمكن للمستخدمين التواصل معك من خلاله إذا كانت لديهم أسئلة حول موافقتهم.
    3. انقر على التالي.
    4. ضمن الجمهور، اختَر داخلي.
    5. انقر على التالي.
    6. ضمن معلومات الاتصال ، أدخِل عنوان بريد إلكتروني يمكن إعلامك من خلاله بأي تغييرات تطرأ على مشروعك.
    7. انقر على التالي.
    8. ضمن إنهاء، راجِع سياسة بيانات المستخدمين في خدمات Google API، وإذا كنت موافقًا، ضَع علامة في المربّع أوافق على "سياسة بيانات المستخدمين في خدمات Google API".
    9. انقر على متابعة.
    10. انقر على إنشاء.
  3. يمكنك الآن تخطّي إضافة النطاقات. في المستقبل، عند إنشاء تطبيق لاستخدامه خارج مؤسسة Google Workspace، عليك تغيير نوع المستخدم إلى خارجي. بعد ذلك، أضِف نطاقات التفويض التي يتطلبها تطبيقك. لمزيد من المعلومات، يُرجى الاطّلاع على دليل ضبط موافقة OAuth الكامل .

إنشاء حساب خدمة في Google Cloud Console

اتّبِع الخطوات التالية لإنشاء حساب خدمة جديد بدور Discovery Engine User:

Google Cloud Console

  1. في Google Cloud Console، انتقِل إلى "القائمة" > المشرف وإدارة الهوية وإمكانية الوصول > حسابات الخدمة.

    الانتقال إلى حسابات الخدمة

    تظهر الخطوات المتبقية في Google Cloud Console.

  2. اختَر مشروعًا على Google Cloud.
  3. انقر على إنشاء حساب خدمة.
  4. أدخِل اسم حساب خدمة ليظهر في Google Cloud Console.
  5. إذا كنت لا تريد ضبط عناصر التحكّم في الوصول الآن، انقر على تم لإنهاء إنشاء حساب الخدمة. لضبط عناصر التحكّم في الوصول الآن، انقر على إنشاء ومتابعة وانتقِل إلى الخطوة التالية.
  6. اختياري: يمكنك إسناد أدوار إلى حساب الخدمة لمنحه إذن الوصول إلى موارد مشروعك على Google Cloud بالإضافة إلى موارد Google Workspace. لمزيد من التفاصيل، يُرجى الرجوع إلى إدارة الوصول إلى المشاريع والمجلدات والمؤسسات.
  7. انقر على متابعة.
  8. اختياري: أدخِل المستخدمين أو المجموعات الذين يمكنهم إدارة حساب الخدمة هذا وتنفيذ إجراءات من خلاله. لمزيد من التفاصيل، يُرجى الرجوع إلى انتحال صفة حساب خدمة.
  9. انقر على تم لإنهاء إنشاء حساب الخدمة.

    دوِّن عنوان البريد الإلكتروني لحساب الخدمة.

gcloud CLI

  1. أنشئ حساب الخدمة: 
    gcloud iam service-accounts create SERVICE_ACCOUNT_NAME \
  --display-name="SERVICE_ACCOUNT_NAME"
  2. اختياري: يمكنك إسناد أدوار إلى حساب الخدمة لمنحه إذن الوصول إلى موارد مشروعك على Google Cloud بالإضافة إلى موارد Google Workspace. لمزيد من التفاصيل، يُرجى الرجوع إلى إدارة الوصول إلى المشاريع والمجلدات والمؤسسات.

يظهر حساب الخدمة في صفحة حساب الخدمة.

إنشاء مفتاح خاص

لإنشاء مفتاح خاص لحساب الخدمة وتنزيله، اتّبِع الخطوات التالية:

  1. في Google Cloud Console، انتقِل إلى "القائمة" > المشرف وإدارة الهوية وإمكانية الوصول > حسابات الخدمة.

    الانتقال إلى حسابات الخدمة

    تظهر الخطوات المتبقية في Google Cloud Console.

  2. اختَر مشروعًا على Google Cloud.
  3. انقر على عنوان البريد الإلكتروني لحساب الخدمة الذي تريد إنشاء مفتاح له.
  4. انقر على علامة التبويب المفاتيح.
  5. انقر على القائمة المنسدلة إضافة مفتاح ، ثم اختَر إنشاء مفتاح جديد.
  6. اختَر JSON كـ نوع المفتاح وانقر على إنشاء.

    يتم إنشاء زوج مفتاح عام/خاص جديد وتنزيله على جهازك كملف مفتاح حساب الخدمة. احفظ ملف JSON الذي تم تنزيله باسم credentials.json في دليل العمل. هذا الملف هو النسخة الوحيدة من هذا المفتاح. بعد تنزيل ملف المفتاح، لا يمكنك تنزيله مرة أخرى. للحصول على معلومات عن كيفية تخزين مفتاحك بشكل آمن، يُرجى الاطّلاع على أفضل الممارسات لإدارة مفاتيح حسابات الخدمة.

لمزيد من المعلومات عن حسابات الخدمة، يُرجى الاطّلاع على حسابات الخدمة في مستندات Google Cloud IAM.

إنشاء مشروع تطبيق Chat وضبط إعداداته

  1. في Google API Console، انتقِل إلى "القائمة" > المشرف وإدارة الهوية وإمكانية الوصول > الإعدادات.

    الانتقال إلى إعدادات "المشرف وإدارة الهوية وإمكانية الوصول"

  2. دوِّن حقلَي رقم المشروع ورقم تعريف المشروع.

  3. انتقِل إلى Gemini Enterprise:

    فتح Gemini Enterprise

  4. دوِّن الموقع الجغرافي ورقم التعريف للتطبيق.

  5. انقر على الزر التالي لفتح مشروع "برمجة تطبيقات Google" البدء السريع لوكيل الذكاء الاصطناعي من Gemini Enterprise.

    فتح المشروع

  6. انقر على نظرة عامة > رمز إنشاء نسخة إنشاء نسخة.

  7. في مشروع "برمجة تطبيقات Google"، انقر على رمز إعدادات المشروع إعدادات المشروع > تعديل خصائص النص البرمجي > إضافة خاصية للنص البرمجي لإضافة خصائص النص البرمجي التالية:

    1. REASONING_ENGINE_RESOURCE_NAME مع مورد تطبيق Gemini Enterprise الذي تم إنشاؤه باستخدام المعلومات التي تم تدوينها في الخطوات السابقة

      projects/PROJECT_ID/locations/APP_LOCATION/collections/default_collection/engines/APP_ID

    2. SERVICE_ACCOUNT_KEY مع مفتاح JSON من حساب الخدمة الذي تم تنزيله في الخطوات السابقة، مثل { ... }

  8. انقر على حفظ خصائص النص البرمجي

  9. في مشروع "برمجة تطبيقات Google"، انقر على رمز إعدادات المشروع إعدادات المشروع.

  10. ضمن مشروع Google Cloud Platform (GCP) ، انقر على تغيير المشروع.

  11. في رقم مشروع Google Cloud Platform، ألصِق رقم مشروع Google Cloud الذي تم تدوينه في الخطوات السابقة.

  12. انقر على ضبط المشروع. تم الآن ربط مشروع السحابة الإلكترونية بمشروع "برمجة تطبيقات Google".

إنشاء عملية نشر تجريبية

تحتاج إلى رقم تعريف عملية نشر لمشروع "برمجة تطبيقات Google" هذا، لتتمكّن من استخدامه في الخطوة التالية.

للحصول على رقم تعريف عملية نشر الإصدار الرئيسي، اتّبِع الخطوات التالية:

  1. في مشروع "برمجة تطبيقات Google" لتطبيق Chat، انقر على نشر > عمليات النشر التجريبية.
  2. ضمن رقم تعريف عملية نشر الإصدار الرئيسي، انقر على رمز إنشاء نسخة نسخ.
  3. انقر على تم.

ضبط إعدادات تطبيق Chat

باستخدام عملية نشر "برمجة تطبيقات Google"، اتّبِع الخطوات التالية لنشر تطبيق Google Chat لأغراض الاختبار:

  1. في Google API Console، ابحث عن Google Chat API، وانقر على Google Chat API.
  2. انقر على إدارة.

  3. انقر على الإعدادات واضبط إعدادات تطبيق Chat:

    1. في حقل اسم التطبيق ، أدخِل GE Quickstart.
    2. في حقل عنوان URL للصورة الرمزية ، أدخِل https://developers.google.com/workspace/add-ons/images/quickstart-app-avatar.png.
    3. في حقل الوصف ، أدخِل GE Quickstart.
    4. ضمن الوظائف ، اختَر الانضمام إلى المساحات والمحادثات الجماعية.
    5. ضمن "إعدادات الاتصال"، اختَر مشروع "برمجة تطبيقات Google".
    6. في حقل رقم تعريف عملية النشر ، ألصِق رقم تعريف عملية نشر الإصدار الرئيسي الذي سبق لك نسخه.
    7. ضمن "مدى الظهور"، اختَر مستخدمون ومجموعات معيّنون في نطاقك، وأدخِل عنوان بريدك الإلكتروني.

  4. انقر على حفظ.

تطبيق Chat جاهز للرد على الرسائل.

اختبار تطبيق Chat

لاختبار تطبيق Chat، افتح مساحة رسالة مباشرة مع تطبيق Chat وأرسِل رسالة:

  1. افتح Google Chat باستخدام حساب Google Workspace الذي قدّمته عند إضافتك كمختبِر موثوق به.

    الانتقال إلى Google Chat

  2. انقر على محادثة جديدة.
  3. في حقل إضافة مستخدم واحد أو أكثر ، اكتب اسم تطبيق Chat.

  4. اختَر تطبيق Chat من النتائج. تُفتح رسالة مباشرة.

  5. في الرسالة المباشرة الجديدة مع التطبيق، اكتب I need to find ideas! واضغط علىenter.

    يردّ تطبيق Chat باستخدام الردّ التلقائي لوكيل إنشاء الأفكار.

لإضافة مختبِرين موثوق بهم والتعرّف أكثر على اختبار الميزات التفاعلية، يُرجى الاطّلاع على اختبار الميزات التفاعلية لتطبيقات Google Chat.

تحديد المشاكل وحلّها

عندما يعرض تطبيق أو بطاقة في Google Chat خطأً، تعرض واجهة Chat رسالة "حدث خطأ ما". أو "يتعذّر معالجة طلبك". في بعض الأحيان، لا تعرض واجهة مستخدم Chat أي رسالة خطأ، ولكن ينتج عن تطبيق Chat أو البطاقة نتيجة غير متوقّعة، على سبيل المثال، قد لا تظهر رسالة بطاقة.

على الرغم من أنّه قد لا يتم عرض رسالة خطأ في واجهة مستخدم Chat، تتوفّر رسائل خطأ وصفية وبيانات السجلّ لمساعدتك في حلّ الأخطاء عند تفعيل تسجيل الأخطاء لتطبيقات Chat. للحصول على مساعدة في عرض الأخطاء وتصحيحها وحلّها، يُرجى الاطّلاع على تحديد أخطاء Google Chat وحلّها.

تَنظيم

لتجنُّب تحصيل رسوم من حسابك على Google Cloud مقابل الـ موارد المستخدَمة في هذا البرنامج التعليمي، ننصحك بحذف الـ مشروع السحابة الإلكترونية.

  1. في Google API Console، انتقِل إلى صفحة إدارة الموارد. انقر على القائمة > المشرف وإدارة الهوية وإمكانية الوصول > إدارة الموارد.

    الانتقال إلى Resource Manager

  2. في قائمة المشاريع، اختَر المشروع الذي تريد حذفه، ثم انقر على حذف .
  3. في مربّع الحوار، اكتب رقم تعريف المشروع، ثم انقر على إيقاف لحذف المشروع.