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

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

ملاحظة: في Google Chat، تظهر الإضافات للمستخدمين كتطبيقات Google Chat. يمكنك أيضًا إنشاء تطبيق Chat باستخدام أحداث التفاعل في Google Chat API. لمزيد من المعلومات، راجِع نظرة عامة على توسيع نطاق Google Chat.

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

يوضّح المخطّط التالي بنية النظام ونمط المراسلة:

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

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

الأهداف

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

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

• حساب Google Workspace تابع للعمل أو لمؤسسة مع إمكانية الوصول إلى Google Chat
• مشروع Google Cloud تم تفعيل الفوترة فيه للتأكّد من تفعيل الفوترة في مشروع حالي، يُرجى الاطّلاع على التأكّد من حالة الفوترة في مشاريعك. لإنشاء مشروع وإعداد الفوترة، يُرجى الاطّلاع على مقالة إنشاء مشروع على Google Cloud.
• تطبيق Gemini Enterprise تم إعداده باستخدام Google Identity كموفِّر للهوية

إعداد البيئة

تفعيل Chat API

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

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

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

إعداد شاشة طلب الموافقة المتعلّقة ببروتوكول OAuth

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

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

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

2. إذا سبق لك إعداد منصة Google Auth، يمكنك ضبط إعدادات "شاشة طلب الموافقة المتعلّقة ببروتوكول OAuth" التالية في العلامة التجارية والجمهور والوصول إلى البيانات. إذا ظهرت لك رسالة تفيد بأنّه لم يتم إعداد منصة Google Auth بعد، انقر على البدء:
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.
   ملاحظة: تنشئ Google تلقائيًا معرّفًا فريدًا لحساب الخدمة استنادًا إلى اسم حساب الخدمة. يمكنك تعديل المعرّف في حقل معرّف حساب الخدمة. لا يمكنك تغيير رقم التعريف لاحقًا.
5. إذا كنت لا تريد ضبط عناصر التحكّم في الوصول الآن، انقر على تم لإنهاء عملية إنشاء حساب الخدمة. لضبط عناصر التحكّم في الوصول الآن، انقر على إنشاء ومتابعة وانتقِل إلى الخطوة التالية.
   ملاحظة: لا يؤثّر منح إذن التحكّم في الوصول هنا إلا في موارد Google Cloud. تتم مشاركة موارد Google Workspace (مثل "جداول بيانات Google" وGoogle Drive) وإعدادها بشكل منفصل.
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 في دليل العمل. هذا الملف هو النسخة الوحيدة من هذا المفتاح. بعد تنزيل ملف المفتاح، لا يمكنك تنزيله مرة أخرى. للحصول على معلومات حول كيفية تخزين المفتاح بشكل آمن، يُرجى الاطّلاع على أفضل الممارسات لإدارة مفاتيح حساب الخدمة.

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

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

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

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

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

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

   فتح Gemini Enterprise

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

5. انقر على الزر التالي لفتح مشروع GE AI Agent Quickstart في "برمجة التطبيقات".

   فتح المشروع

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

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

   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" هذا، حتى تتمكّن من استخدامه في الخطوة التالية.

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

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

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

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

1. في وحدة تحكّم API، ابحث عن 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. ضِمن "إعدادات الربط"، اختَر مشروع برمجة تطبيقات.
   6. في حقل رقم تعريف عملية النشر، ألصِق رقم تعريف عملية نشر Head الذي نسخته سابقًا.
   7. ضمن "إذن الوصول"، اختَر أشخاص ومجموعات معيّنة في نطاقك، وأدخِل عنوان بريدك الإلكتروني.

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

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

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

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

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

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

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

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

   ملاحظة: إذا لم يظهر تطبيق Chat في قائمة النتائج، تأكَّد من تضمين حسابك على Google Workspace في إعدادات إمكانية الوصول في صفحة إعدادات Chat API في "وحدة تحكّم Google API".

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

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

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

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

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

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

تَنظيم

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

تنبيه: يؤدي حذف مشروع إلى ما يلي:

• يتم حذف كل المحتوى في المشروع. إذا كنت قد استخدمت مشروعًا حاليًا لهذا البرنامج التعليمي، سيؤدي حذفه إلى حذف أي عمل آخر أنجزته في المشروع.
• فقدان أرقام تعريف المشاريع المخصّصة: عند إنشاء هذا المشروع، ربما أنشأت رقم تعريف مشروع مخصّصًا تريد استخدامه في المستقبل. للحفاظ على عناوين URL التي تستخدم رقم تعريف المشروع، مثل عنوان URL على appspot.com، احذف الموارد المحدّدة داخل المشروع بدلاً من حذف المشروع بأكمله.

إذا كنت تخطّط لاستكشاف العديد من البرامج التعليمية وأدلة البدء السريع، يمكن أن يساعدك إعادة استخدام المشاريع في تجنُّب تجاوز حدود حصص المشاريع.

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

   الانتقال إلى "إدارة الموارد"

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

مواضيع ذات صلة

• إنشاء وكلاء Gemini Enterprise مدمجين بإحكام مع مساحات تخزين البيانات وواجهات برمجة التطبيقات وتطبيقات Chat في Workspace
• إنشاء وكلاء Vertex AI مدمجين بإحكام مع مخازن بيانات Workspace وواجهات برمجة التطبيقات وتطبيقات Chat
• إنشاء تطبيق Google Chat باستخدام وكيل الذكاء الاصطناعي في "حزمة تطوير التطبيقات"
• إنشاء تطبيق Google Chat باستخدام وكيل الذكاء الاصطناعي في "حزمة تطوير التطبيقات" (ADK) الذي تعرضه ميزة "التطبيق إلى التطبيق" (A2A)
• إنشاء تطبيق Google Chat باستخدام وكيل ذكاء اصطناعي في "حزمة تطوير التطبيقات" (ADK) يتم عرضه من خلال A2UI
• التحقّق من صحة البيانات باستخدام وكيل الذكاء الاصطناعي في حزمة ADK ونموذج Gemini
• تخطيط الرحلات باستخدام وكيل الذكاء الاصطناعي يمكن الوصول إليه في جميع أنحاء Google Workspace
• دمج مفاهيم الذكاء الاصطناعي الأساسية في تطبيقات Chat
• الإجابة عن الأسئلة استنادًا إلى محادثات التحدّث مع الذكاء الاصطناعي باستخدام تطبيق الذكاء الاصطناعي من Gemini
• الاستجابة للحوادث باستخدام Google Chat وVertex AI وApps Script ومصادقة المستخدم
• إدارة المشاريع باستخدام Google Chat وVertex AI وFirestore