إنشاء تطبيق Google Chat باستخدام وكيل الذكاء الاصطناعي في "حزمة تطوير التطبيقات"

توضّح هذه الصفحة كيفية إنشاء إضافة Google Workspace تعمل في Google Chat وتتفاعل مع برنامج Agent Development Kit (ADK) الذي يستضيف وكيل الذكاء الاصطناعي في Vertex AI Agent Engine.

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

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

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

في الرسم التوضيحي السابق، يتفاعل المستخدم مع تطبيق Chat تم تنفيذه باستخدام وكيل الذكاء الاصطناعي في حزمة تطوير التطبيقات (ADK)، ويكون تدفق المعلومات على النحو التالي:

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

الأهداف

• إعداد البيئة
• نشر وكيل الذكاء الاصطناعي في "حزمة تطوير التطبيقات"
• نشر تطبيق Chat
• ضبط إعدادات تطبيق Chat
• اختبِر تطبيق Chat.

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

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

إعداد البيئة

تفعيل واجهات Google Cloud APIs

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

• في Google Cloud Console، فعِّل واجهات برمجة التطبيقات Google Chat وVertex AI وCloud Resource Manager.

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

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

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

1. في "وحدة تحكّم Google Cloud"، انتقِل إلى "القائمة" > Google Auth platform > العلامة التجارية.

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

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

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

أنشِئ حساب خدمة جديدًا بالدور Vertex AI User باتّباع الخطوات التالية:

Google Cloud Console

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

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

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

gcloud CLI

1. أنشئ حساب الخدمة:

   gcloud iam service-accounts create SERVICE_ACCOUNT_NAME \
     --display-name="SERVICE_ACCOUNT_NAME"

2. اختياري: يمكنك إسناد أدوار إلى حساب الخدمة لمنحه إذن الوصول إلى موارد مشروعك على Google Cloud. لمزيد من التفاصيل، يُرجى الرجوع إلى منح إذن الوصول إلى الموارد وتغييره وإبطاله.

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

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

تحذير: يستخدم هذا المثال مفتاح حساب خدمة تم تصديره لتسهيل العملية. لا يُنصح بتصدير مفتاح خاص في بيئة الإنتاج لأنّه لا يجب تخزينه في مكان غير آمن، مثل نظام التحكّم بالمصادر.

لمزيد من المعلومات حول عمليات التنفيذ الآمنة لحسابات الخدمة وأفضل الممارسات، يُرجى الاطّلاع على اختيار الوقت المناسب لاستخدام حسابات الخدمة.

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

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

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

2. اختَر حساب الخدمة.
3. انقر على المفاتيح > إضافة مفتاح > إنشاء مفتاح جديد.
4. اختَر JSON، ثمّ انقر على إنشاء.

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

5. انقر على إغلاق (Close).

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

نشر وكيل الذكاء الاصطناعي في "حزمة تطوير التطبيقات"

1. افتح عيّنة LLM Auditor في Vertex AI Agent Garden:

   فتح العيّنة

2. انقر على نشر.

3. اختَر مشروعك على Google Cloud إذا طُلب منك ذلك.

4. انقر على النشر في Cloud Shell.

5. إذا طُلب منك ذلك، انقر على تفويض واتّبِع خطوات OAuth في Cloud Shell.

6. عند اكتمال تحميل Cloud Shell، اضغط على Enter لتشغيل سطر الأوامر المحمَّل مسبقًا وبدء عملية النشر.

7. إذا طُلب منك إدخال منطقة، اضغط على Enter لاستخدام المنطقة التلقائية.

8. عند اكتمال العملية، انتقِل إلى "محرك وكلاء Vertex AI":

   فتح Vertex AI Agent Engine

9. انقر على لنسخ اسم المورد للوكيل الذي تم نشره حديثًا من الجدول.

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

1. انقر على الزر التالي لفتح مشروع التشغيل السريع لـ "وكيل الذكاء الاصطناعي" في "حزمة تطوير التطبيقات" في "برمجة Google Apps".

   فتح المشروع

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

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

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

4. انقر على حفظ مواقع النص البرمجي

5. في وحدة تحكّم Google Cloud، انتقِل إلى "القائمة" > إدارة الهوية وإمكانية الوصول > الإعدادات.

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

6. في حقل رقم المشروع، انسخ القيمة.

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

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

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

10. انقر على تحديد المشروع. تم الآن ربط مشروع Cloud بمشروع "برمجة التطبيقات".

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

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

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

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

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

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

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

3. انقر على الإعداد وأعِدّ تطبيق Chat على النحو التالي:

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

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

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

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

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

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

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

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

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

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

5. في الرسالة المباشرة الجديدة مع التطبيق، اكتب The Eiffel Tower was completed in 1900 واضغط علىenter.

   يردّ تطبيق Chat باستخدام ردود الوكيلَين الفرعيَين الناقد والمراجع.

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

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

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

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

تَنظيم

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

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

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

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

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

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

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

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

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