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

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

تستشعر وكلاء الذكاء الاصطناعي البيئة المحيطة بهم بشكل مستقل، ويستدلون ويتخذون إجراءات معقّدة ومتعددة الخطوات لتحقيق هدف محدّد. في هذا البرنامج التعليمي، يمكنك نشر الـ نموذج الوكلاء المتعدّدين LLM Auditor من حزمة تطوير الوكلاء (ADK) الذي ينتقد الحقائق ويعدّلها باستخدام Gemini وأسلوب تحديد المصدر من خلال "بحث Google".

نموذج تطبيق LLM Auditor متعدد الوكلاء كتطبيق Chat

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

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

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

  1. يرسل المستخدم رسالة إلى تطبيق Chat، إما في رسالة مباشرة أو في مساحة Chat.
  2. تتلقّى منطق تطبيق Chat الرسالة وتعالجها، سواء تم تنفيذه في "برمجة تطبيقات Google" أو كخادم ويب يتضمّن نقاط نهاية 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 Business أو Enterprise مع إمكانية الوصول إلى Google Chat
  • مشروع على Google Cloud تم تفعيل الفوترة له للتأكّد من تفعيل الفوترة لمشروع حالي، يُرجى الاطّلاع على التحقّق من حالة الفوترة لمشاريعك. لإنشاء مشروع على السحابة الإلكترونية وإعداد الفوترة، يُرجى الاطّلاع على إنشاء مشروع على Google Cloud.

إعداد البيئة

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

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

إعداد شاشة طلب الموافقة المتعلّقة ببروتوكول 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

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

وحدة تحكّم Google API

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

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

  2. انقر على إنشاء حساب خدمة.
  3. املأ تفاصيل حساب الخدمة، ثم انقر على إنشاء ومتابعة.
  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 IAM.

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

  1. افتح نموذج LLM Auditor في Vertex AI Agent Garden:

    فتح النموذج

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

  3. إذا طُلب منك ذلك، اختَر مشروعك على السحابة الإلكترونية.

  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" البدء السريع لوكيل الذكاء الاصطناعي من حزمة تطوير الوكلاء (ADK).

    فتح المشروع

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

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

    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. في رقم مشروع GCP، ألصِق رقم مشروع Google Cloud الذي تم نسخه في الخطوات السابقة.

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

    يردّ تطبيق Chat بعرض ردود الوكيلَين الفرعيَين الناقد والمعدِّل.

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

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

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

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

تَنظيم

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

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

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

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