إنشاء تطبيق 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 الذي يتم تنفيذه إما في برمجة تطبيقات أو كخادم ويب مع نقاط نهاية HTTP الرسالة وتعالجها.
3. يتلقّى وكيل الذكاء الاصطناعي الذي تم تنفيذه باستخدام حزمة تطوير الوكلاء (ADK) واستضافته باستخدام Vertex AI Agent Engine التفاعل ويعالجه.
4. يمكنك ربط تطبيق Chat أو وكيل الذكاء الاصطناعي بخدمات Google Workspace، مثل "تقويم Google" أو "جداول بيانات Google"، أو خدمات Google الأخرى، مثل "خرائط Google" أو YouTube.
5. يرسل تطبيق Chat الردود بشكل غير متزامن باستخدام Google Chat API لإعلامك بمدى تقدّم وكيل الذكاء الاصطناعي.
6. يتم تسليم الردود إلى المستخدم.

الأهداف

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

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

• حساب Google Workspace تابع للعمل أو لمؤسسة مع إمكانية الوصول إلى 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 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

أنشِئ حساب خدمة جديدًا بالدور Vertex AI 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.

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

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 Agent Engine:

   فتح Vertex AI Agent Engine

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

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

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

   فتح المشروع

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

1. في وحدة تحكّم API، ابحث عن 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. في حقل رقم تعريف عملية النشر، ألصِق رقم تعريف عملية نشر 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. في الرسالة المباشرة الجديدة مع التطبيق، اكتب The Eiffel Tower was completed in 1900 واضغط على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. في مربّع الحوار، اكتب رقم تعريف المشروع، ثم انقر على إيقاف لحذف المشروع.

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

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