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

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

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

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

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

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

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

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

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

لمزيد من المعلومات حول حسابات الخدمة، يُرجى الاطّلاع على حسابات الخدمة في مستندات 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. انقر على الزر التالي لفتح مشروع ADK AI Agent Quickstart في "برمجة تطبيقات 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. في رقم مشروع GCP، ألصِق رقم مشروع Google Cloud الذي نسخته في الخطوات السابقة.

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

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

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

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

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

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

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

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

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

    1. في حقل اسم التطبيق، أدخِل ADK Quickstart.
    2. في حقل عنوان URL للأفاتار، أدخِل https://developers.google.com/workspace/chat/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 من النتائج. سيتم فتح رسالة مباشرة.

  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، انتقِل إلى صفحة إدارة الموارد. انقر على القائمة > إدارة الهوية وإمكانية الوصول والمشرف > إدارة الموارد.

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

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