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

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

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

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

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

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

في الرسم البياني السابق، يتفاعل المستخدم مع تطبيق 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 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 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.

نشر وكيل الذكاء الاصطناعي في "حزمة تطوير الوكلاء" (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" البدء السريع لوكيل الذكاء الاصطناعي في "حزمة تطوير الوكلاء" (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. انقر على ضبط المشروع. تم الآن ربط مشروع Cloud بمشروع "برمجة تطبيقات 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. في حقل اسم التطبيق ، أدخِل 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، ننصحك بحذف مشروع Cloud.

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

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

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