الكلمة الافتتاحية في مؤتمر Next ‘26: نسيج الذكاء الموحّد

1. مقدمة

مرحبًا بك في برنامج codelab الخاص بـ "Fabric of Unified Intelligence"! هذا الدرس التطبيقي حول الترميز هو جزء من العروض التوضيحية للكلمة الافتتاحية لمؤتمر Google Cloud Next ‘26.

في هذا التمرين العملي، ستتعرّف على كيفية استخدام Gemini Enterprise لتنسيق عدة وكلاء تم نشرهم على Cloud Run، ومشاركة السياق لعمليات تسليم سلسة وسير عمل مبسط.

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

  • وكيل استراتيجية المنتج: يحسّن مفاهيم المنتجات استنادًا إلى بيانات السوق.
  • وكيل أبحاث السوق: يحلّل المؤشرات وآراء العملاء.
  • وكيل التنسيق: ينسّق سير العمل بين الوكلاء الآخرين.
  • Dev Agent: يحوّل الخطط إلى إجراءات من خلال إنشاء تذاكر ورموز برمجية أساسية.

في نهاية هذا التمرين، سيكون لديك نظام متعدد الوكلاء يعمل ومُنتشر على Cloud Run، ومنظَّم باستخدام Gemini Enterprise، ما يوضّح قوة الذكاء الموحّد.

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

  • معرفة أساسية بوحدة تحكّم Google Cloud وgcloud CLI

الإجراءات التي ستنفذّها

  • نشر نظام متعدد الوكلاء على Cloud Run
  • سجِّل الوكلاء باستخدام Gemini Enterprise.
  • من خلال Gemini Enterprise، ستنفّذ سير العمل لإجراء ما يلي:
    • تحليل بياناتك وإنشاء إحصاءات منها
    • يمكنك إنشاء فيديوهات لمنتجاتك باستخدام Veo.
    • إنشاء متطلبات لفريق المطوّرين لتعديل الموقع الإلكتروني استنادًا إلى الإحصاءات

المتطلبات

  • متصفّح ويب، مثل Chrome
  • حساب Google

2. إعداد البيئة

إعداد المشروع

إنشاء مشروع على Google Cloud

  1. في Google Cloud Console، في صفحة اختيار المشروع، اختَر مشروعًا على Google Cloud أو أنشِئ مشروعًا.
  2. تأكَّد من تفعيل الفوترة لمشروعك على السحابة الإلكترونية. كيفية التحقّق مما إذا كانت الفوترة مفعَّلة في مشروع

تفعيل Cloud Shell

Cloud Shell هي بيئة سطر أوامر تعمل في Google Cloud ومحمّلة مسبقًا بالأدوات اللازمة.

  1. انقر على تفعيل Cloud Shell في أعلى "وحدة تحكّم Google Cloud".
  2. بعد الاتصال بـ Cloud Shell، تحقَّق من مصادقتك باتّباع الخطوات التالية:
    gcloud auth list
  3. تأكَّد من إعداد مشروعك باتّباع الخطوات التالية:
    gcloud config get project
  4. إذا لم يتم ضبط مشروعك على النحو المتوقّع، اضبطه باتّباع الخطوات التالية:
    export PROJECT_ID=<YOUR_PROJECT_ID>
gcloud config set project $PROJECT_ID

تهيئة ملف متغيرات البيئة

لضمان الاحتفاظ بمتغيّرات البيئة في حال انقطاع اتصال جلسة Cloud Shell، عليك حفظها في ملف واستخدامه عند الحاجة.

  1. في Cloud Shell، أنشئ الملف وأضِف رقم تعريف مشروعك إليه:
    echo "export PROJECT_ID=$(gcloud config get-value project)" > ~/lab_env.sh
source ~/lab_env.sh

الحصول على مفتاح Gemini API من AI Studio

يغلّف "وكيل أبحاث السوق" واجهة برمجة التطبيقات Gemini Deep Research Interactions API. تستدعي الأداة deep_research واجهة برمجة التطبيقات Gemini Deep Research Interactions API، والتي تتوفّر حاليًا فقط من خلال نقطة النهاية AI Studio. ينشئ genai.Client منفصلاً باستخدام vertexai=False ويصادق باستخدام مفتاح واجهة برمجة تطبيقات مخزّن في متغيّر البيئة GEMINI_API_KEY.

  1. انتقِل إلى Google AI Studio.
  2. سجِّل الدخول باستخدام حسابك على Google.
  3. انقر على إنشاء مفتاح واجهة برمجة تطبيقات.
  4. أدخِل اسمًا للمفتاح Unified Intelligence Agents.
  5. ضمن اختيار مشروع مستورَد، اختَر مشروعك أو استورِده.
  6. انقر على إنشاء مفتاح.
  7. انسخ مفتاح واجهة برمجة التطبيقات الذي تم إنشاؤه من جزء التفاصيل.
  8. في Cloud Shell، احفظ هذا المفتاح في ملف بيئة المختبر (استبدِل YOUR_GEMINI_API_KEY بالمفتاح الفعلي):
    echo "export GEMINI_API_KEY=\"YOUR_GEMINI_API_KEY\"" >> ~/lab_env.sh
source ~/lab_env.sh

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

  1. في Cloud Shell، فعِّل واجهات برمجة التطبيقات المطلوبة لهذا التمرين العملي:
    gcloud services enable \
  cloudresourcemanager.googleapis.com \
  aiplatform.googleapis.com \
  storage.googleapis.com \
  run.googleapis.com \
  bigquery.googleapis.com \
  cloudbuild.googleapis.com \
  iam.googleapis.com \
  discoveryengine.googleapis.com \
  geminidataanalytics.googleapis.com \
  cloudaicompanion.googleapis.com \
  secretmanager.googleapis.com

إنشاء نسخة طبق الأصل من المستودع

قبل إعداد مجموعة البيانات والبرامج، عليك استنساخ المستودع الذي يحتوي على رمز المصدر وبرامج البيانات.

  1. في Cloud Shell، أنشئ نسخة طبق الأصل من مستودع next-26-keynotes:
    cd $HOME
git clone https://github.com/GoogleCloudPlatform/next-26-keynotes.git

3- إعدادات البيانات والموارد

إعداد بيانات BigQuery ووكيلها

في هذه الخطوة، ستنشئ مجموعة بيانات BigQuery وتملأها ببيانات وهمية حول مستودع الأثاث والمبيعات، ثم ستنشئ BigQuery Data Agent لتحليل هذه البيانات.

  1. في Cloud Shell، انتقِل إلى الدليل data:
    cd $HOME/next-26-keynotes/genkey/fabric-unified-intelligence/data
  2. للمصادقة باستخدام بيانات الاعتماد التلقائية للتطبيق، شغِّل هذا الأمر واتّبِع التعليمات:
    gcloud auth application-default login
  3. نفِّذ البرنامج النصي للإعداد لإنشاء مجموعة البيانات والجداول وطريقة العرض:
    chmod +x setup_bigquery.sh
./setup_bigquery.sh
    ينشئ هذا النص البرمجي ما يلي:
    • مجموعة البيانات: unified_intelligence_fabric_demo
    • الجدول: furniture_stock
    • الجدول: furniture_sales
    • الملف الشخصي: dead_stock_view
  4. نفِّذ نص Python البرمجي لتعبئة الجداول ببيانات نموذجية باستخدام uv:
    uv run --with google-cloud-bigquery ./populate_tables.py
  5. إنشاء وكيل بيانات BigQuery:
    • انتقِل إلى مركز BigQuery Agents في Cloud Console.
    • ضمن كتالوج الوكلاء، انقر على وكيل جديد.
    • اضبط اسم الوكيل على Unified Intelligence Data Agent.
    • اضبط مصدر المعرفة على الجداول في مجموعة البيانات التي أنشأتها للتو (furniture_stock، furniture_sales).
      • ابحث عن الجداول من خلال كتابة furniture.
      • اضغط على مفتاح الرجوع.
      • اختَر الجدولَين (furniture_stock وfurniture_sales).
      • انقر على إضافة.
    • انقر على نشر.
    • عندما يُطلب منك مشاركة الوكيل، انقر على "إلغاء". ستضيف أدوارًا إلى حساب خدمة Compute في خطوة لاحقة.
  6. اختبار الوكيل:
    • في محادثة الاختبار على يسار الصفحة، اطرح سؤالاً مثل: What are the furniture items with the highest stock?
    • تأكَّد من أنّها تعرض نتائج استنادًا إلى البيانات النموذجية. من المفترَض أن يظهر جدول في الناتج مشابه لما يلي.agent-output
  7. حفظ رقم تعريف وكيل البيانات:
    • على الجانب الأيسر من الشاشة، من المفترض أن يظهر معرّف الوكيل الذي أنشأته للتو. ستبدو على النحو التالي: agent_ba43c386-ae82-45e0-a2b5-1928440f0926.
    agent-id
    • انسخ رقم التعريف.
    • نفِّذ الأمر التالي في Cloud Shell لحفظه، مع استبدال YOUR_AGENT_ID برقم التعريف الفعلي:
    echo "export BQ_DATA_AGENT_ID=YOUR_AGENT_ID" >> ~/lab_env.sh
source ~/lab_env.sh

إنشاء مجلد مشترك

في هذه الخطوة، ستنشئ مجلدًا في Google Drive وتشاركه مع حساب خدمة Cloud Run. سيستخدم العملاء هذا المجلد لحفظ الملفات ومشاركتها (مثل المتطلبات التي تم إنشاؤها).

  1. انتقِل إلى Google Drive.
  2. انقر على جديد > مجلد جديد، وأدخِل الاسم Unified Intelligence Lab، ثم انقر على إنشاء.
  3. انقر بزر الماوس الأيمن على المجلد الذي تم إنشاؤه حديثًا واختَر مشاركة > مشاركة.
  4. في Cloud Shell، شغِّل الأمر التالي للحصول على عنوان البريد الإلكتروني لحساب الخدمة التلقائي في Compute Engine:
    PROJECT_NUMBER=$(gcloud projects describe $(gcloud config get-value project) --format="value(projectNumber)")
echo "${PROJECT_NUMBER}-compute@developer.gserviceaccount.com"
  5. انسخ عنوان البريد الإلكتروني من الناتج.
  6. في مربّع حوار المشاركة في Google Drive، أضِف عنوان البريد الإلكتروني هذا.
  7. اضبط الدور على محرِّر.
  8. افتح المجلد وانسخ رقم التعريف من عنوان URL. سيبدو عنوان URL على النحو التالي: https://drive.google.com/drive/folders/YOUR_FOLDER_ID. انسخ السلسلة الأبجدية الرقمية في نهاية عنوان URL، والتي تظهر بعد /folders/.
  9. في Cloud Shell، احفظ هذا المعرّف في ملف بيئة المختبر (استبدِل YOUR_FOLDER_ID بالمعرّف الفعلي):
    echo "export GOOGLE_DRIVE_FOLDER_ID=YOUR_FOLDER_ID" >> ~/lab_env.sh
source ~/lab_env.sh

إنشاء حِزم GCS

في Cloud Shell، نفِّذ الأوامر التالية لإنشاء حِزم GCS للعناصر/المهام وفيديوهات الحملات والسجلات:

gcloud storage buckets create gs://$(gcloud config get-value project)-artifacts --location=us-central1
gcloud storage buckets create gs://$(gcloud config get-value project)-videos --location=us-central1
gcloud storage buckets create gs://$(gcloud config get-value project)-logs --location=us-central1

جعل مجموعة الفيديوهات علنية

للسماح للموقع الإلكتروني بالوصول إلى الفيديوهات، يجب ضبط إعدادات خصوصية حزمة الفيديوهات على "علني" باتّباع الخطوات التالية:

gcloud storage buckets add-iam-policy-binding gs://$(gcloud config get-value project)-videos --member=allUsers --role=roles/storage.objectViewer

منح أدوار "إدارة الهوية وإمكانية الوصول"

في هذا القسم، ستمنح أدوار إدارة الهوية وإمكانية الوصول (IAM) للمستخدم والعديد من حسابات الخدمة/الوكلاء.

منح الأدوار للمستخدم

لاستخدام ميزات "محرك الاقتراحات" (البحث والمحادثة)، شغِّل الأوامر التالية في Cloud Shell لمنح دور "مستخدم محرك الاقتراحات" لحسابك:

source ~/lab_env.sh

echo "export USER_ACCOUNT=$(gcloud config get-value account)" >> ~/lab_env.sh
source ~/lab_env.sh

gcloud projects add-iam-policy-binding $PROJECT_ID \
  --member="user:$USER_ACCOUNT" \
  --role="roles/discoveryengine.user"

منح أدوار لحساب خدمة Compute Engine

في Cloud Shell، نفِّذ الأوامر التالية لمنح أدوار لحساب خدمة Compute Engine:

source ~/lab_env.sh

PROJECT_NUMBER=$(gcloud projects describe $PROJECT_ID --format="value(projectNumber)")
echo "export PROJECT_NUMBER=${PROJECT_NUMBER}" >> ~/lab_env.sh
echo "export COMPUTE_SA=\"${PROJECT_NUMBER}-compute@developer.gserviceaccount.com\"" >> ~/lab_env.sh
source ~/lab_env.sh

gcloud projects add-iam-policy-binding $PROJECT_ID \
  --member="serviceAccount:$COMPUTE_SA" \
  --role="roles/storage.objectAdmin"

gcloud projects add-iam-policy-binding $PROJECT_ID \
  --member="serviceAccount:$COMPUTE_SA" \
  --role="roles/aiplatform.user"

gcloud projects add-iam-policy-binding $PROJECT_ID \
  --member="serviceAccount:$COMPUTE_SA" \
  --role="roles/cloudtrace.agent"

gcloud projects add-iam-policy-binding $PROJECT_ID \
  --member="serviceAccount:$COMPUTE_SA" \
  --role="roles/geminidataanalytics.dataAgentUser"

gcloud projects add-iam-policy-binding $PROJECT_ID \
  --member="serviceAccount:$COMPUTE_SA" \
  --role="roles/geminidataanalytics.dataAgentStatelessUser"

gcloud projects add-iam-policy-binding $PROJECT_ID \
  --member="serviceAccount:$COMPUTE_SA" \
  --role="roles/bigquery.dataViewer"

gcloud iam service-accounts add-iam-policy-binding $COMPUTE_SA \
  --member="serviceAccount:$COMPUTE_SA" \
  --role="roles/iam.serviceAccountTokenCreator" \
  --project=$PROJECT_ID

gcloud projects add-iam-policy-binding $PROJECT_ID \
  --member="serviceAccount:$COMPUTE_SA" \
  --role="roles/cloudbuild.builds.builder"

gcloud projects add-iam-policy-binding $PROJECT_ID \
  --member="serviceAccount:$COMPUTE_SA" \
  --role="roles/run.invoker"

gcloud projects add-iam-policy-binding $PROJECT_ID \
  --member="serviceAccount:$COMPUTE_SA" \
  --role="roles/secretmanager.secretAccessor"

منح أدوار لحساب خدمة Discovery Engine

في Cloud Shell، نفِّذ الأوامر التالية لمنح أدوار إلى حساب خدمة Discovery Engine:

source ~/lab_env.sh

echo "export DISCOVERY_ENGINE_SA=\"service-\${PROJECT_NUMBER}@gcp-sa-discoveryengine.iam.gserviceaccount.com\"" >> ~/lab_env.sh
source ~/lab_env.sh

gcloud projects add-iam-policy-binding $PROJECT_ID \
  --member="serviceAccount:$DISCOVERY_ENGINE_SA" \
  --role="roles/run.invoker"

gcloud projects add-iam-policy-binding $PROJECT_ID \
  --member="serviceAccount:$DISCOVERY_ENGINE_SA" \
  --role="roles/aiplatform.user"

منح أدوار إلى حساب خدمة "محرك الاستدلال" في AI Platform

في Cloud Shell، نفِّذ الأوامر التالية لمنح أدوار إلى "وكيل خدمة محرك الاستدلال في AI Platform":

source ~/lab_env.sh

echo "export AI_PLATFORM_RE_SA=\"service-\${PROJECT_NUMBER}@gcp-sa-aiplatform-re.iam.gserviceaccount.com\"" >> ~/lab_env.sh
source ~/lab_env.sh

gcloud projects add-iam-policy-binding $PROJECT_ID \
  --member="serviceAccount:$AI_PLATFORM_RE_SA" \
  --role="roles/storage.objectViewer"

4. ضبط الوكلاء ونشرهم

إعداد جميع الوكلاء المخصّصين اللازمين لهذا الدرس التطبيقي وتفعيلهم

ضبط "وكيل استراتيجية المنتج" ونشره

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

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

ولكن أولاً، عليك ضبط المتغيرات البيئية لـ "وكيل استراتيجية المنتج".

  1. في Cloud Shell، انتقِل إلى دليل Product Strategy Agent:
    cd $HOME/next-26-keynotes/genkey/fabric-unified-intelligence/agents/product-strategy
  2. نفِّذ الأمر التالي لنسخ ملف .env.sample إلى .env:
    cp .env.sample .env
  3. في Cloud Shell، نفِّذ الأوامر التالية لملء ملف .env بتفاصيل مشروعك:
    source ~/lab_env.sh
sed -i "s/YOUR_PROJECT_ID/${PROJECT_ID}/" .env
sed -i "s/YOUR_VEO_GCS_BUCKET/${PROJECT_ID}-videos/" .env
sed -i "s/YOUR_GOOGLE_DRIVE_FOLDER_ID/${GOOGLE_DRIVE_FOLDER_ID}/" .env
sed -i "s/YOUR_LOGS_BUCKET_NAME/${PROJECT_ID}-logs/" .env

نشر أداة Product Strategy Agent

  1. النشر على Cloud Run الآن، في Cloud Shell، انشر الوكيل على Cloud Run. يتضمّن المستودع Makefile يسهّل هذه العملية:
    make deploy
    بعد نشرها، ستحصل على عنوان URL لـ "وكيل استراتيجية المنتج".
  2. في Cloud Shell، نفِّذ الأمر التالي للحصول على عنوان URL للخدمة التي تم نشرها وحفظه في ملف بيئة المختبر:
    source ~/lab_env.sh
PRODUCT_STRATEGY_URL=$(gcloud run services describe product-strategy --region us-central1 --format 'value(status.url)')
echo "export PRODUCT_STRATEGY_URL=\"${PRODUCT_STRATEGY_URL}\"" >> ~/lab_env.sh
source ~/lab_env.sh

ضبط "وكيل أبحاث السوق" ونشره

في هذه الخطوة، ستنشر "وكيل أبحاث السوق" على Cloud Run وتسجّله في تطبيق Gemini Enterprise. يحلّل هذا الوكيل المؤشرات وملاحظات العملاء.

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

ولكن أولاً، عليك ضبط المتغيرات البيئية الخاصة بـ "وكيل أبحاث السوق"، بما في ذلك مفتاح واجهة برمجة التطبيقات لأداة Deep Research.

  1. في Cloud Shell، انتقِل إلى الدليل market-research:
    cd $HOME/next-26-keynotes/genkey/fabric-unified-intelligence/agents/market-research
  2. نفِّذ الأمر التالي لنسخ ملف .env.sample إلى .env:
    cp .env.sample .env
  3. في Cloud Shell، نفِّذ الأوامر التالية لملء ملف .env بتفاصيل مشروعك:
    source ~/lab_env.sh
sed -i "s/YOUR_PROJECT_ID/${PROJECT_ID}/" .env
sed -i "s/YOUR_LOGS_BUCKET_NAME/${PROJECT_ID}-logs/" .env

إنشاء أسرار

يتم تخزين المتغيّر GEMINI_API_KEY في Secret Manager ويتم تحميله في مراجعة Cloud Run في وقت النشر.

  1. في Cloud Shell، أضِف GEMINI_API_KEY إلى ملف .env:
    source ~/lab_env.sh
echo "GEMINI_API_KEY=${GEMINI_API_KEY}" >> .env
  2. نفِّذ الأمر التالي لنقل قيم الأسرار من .env المحلي إلى Secret Manager:
    make create-secrets
  3. نفِّذ الأمر التالي لمنح Cloud Run إذن الوصول إلى كلمة المرور المحفوظة:
    make grant-secret-access

نشر "وكيل أبحاث السوق" على Cloud Run

  1. في Cloud Shell، يمكنك نشر الوكيل باستخدام Makefile:
    make deploy
    بعد نشر "وكيل أبحاث السوق"، ستحصل على عنوان URL له.
  2. في Cloud Shell، نفِّذ الأمر التالي للحصول على عنوان URL للخدمة التي تم نشرها وحفظه في ملف بيئة المختبر:
    source ~/lab_env.sh
MARKET_RESEARCH_URL=$(gcloud run services describe market-research --region us-central1 --format 'value(status.url)')
echo "export MARKET_RESEARCH_URL=\"${MARKET_RESEARCH_URL}\"" >> ~/lab_env.sh
source ~/lab_env.sh

إعداد وكيل Orchestrator ونشره

في هذه الخطوة، ستنشر Orchestrator Agent على Cloud Run وتسجّله في تطبيق Gemini Enterprise. ينسّق هذا الوكيل سير العمل بين الوكلاء الآخرين.

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

ولكن أولاً، عليك ضبط المتغيرات البيئية لـ Orchestrator Agent. يجب أن يعرف عناوين URL الخاصة بوكيلَي "استراتيجية المنتج" و"أبحاث السوق" اللذين نشرتهما في الخطوات السابقة.

  1. في Cloud Shell، انتقِل إلى الدليل orchestrator:
    cd $HOME/next-26-keynotes/genkey/fabric-unified-intelligence/agents/orchestrator
  2. نفِّذ الأمر التالي لنسخ ملف .env.sample إلى .env:
    cp .env.sample .env
  3. في Cloud Shell، نفِّذ الأوامر التالية لتعبئة الملف .env بتفاصيل مشروعك وإعدادات BigQuery Data Agent:
    source ~/lab_env.sh
sed -i "s/YOUR_PROJECT_ID/${PROJECT_ID}/" .env
sed -i "s|http://localhost:8002|${MARKET_RESEARCH_URL}|" .env
sed -i "s|http://localhost:8001|${PRODUCT_STRATEGY_URL}|" .env
sed -i "s/YOUR_BQ_DATA_AGENT_PROJECT/${PROJECT_ID}/" .env
sed -i "s/YOUR_BQ_DATA_AGENT_ID/${BQ_DATA_AGENT_ID}/" .env
sed -i "s/YOUR_LOGS_BUCKET_NAME/${PROJECT_ID}-logs/" .env

نشر وكيل Orchestrator

  1. في Cloud Shell، يمكنك نشر وكيل Orchestrator باستخدام Makefile:
    make deploy

بعد نشرها، ستحصل على عنوان URL لـ Orchestrator Agent.

  1. في Cloud Shell، نفِّذ الأمر التالي للحصول على عنوان URL للخدمة التي تم نشرها وحفظه في ملف بيئة المختبر:
    source ~/lab_env.sh
ORCHESTRATOR_URL=$(gcloud run services describe orchestrator --region us-central1 --format 'value(status.url)')
echo "export ORCHESTRATOR_URL=\"${ORCHESTRATOR_URL}\"" >> ~/lab_env.sh
source ~/lab_env.sh

ضبط وكيل التطوير ونشره

في هذه الخطوة، ستنشر Dev Agent على Cloud Run وتسجّله في تطبيق Gemini Enterprise. يترجم هذا الوكيل الخطط إلى إجراءات من خلال إنشاء مهام وإنشاء بنية أساسية للرمز. يمكن أن يتكامل Dev Agent مع Jira لإنشاء طلبات دعم، وهذا ما يظهر في العرض التوضيحي الرئيسي. ومع ذلك، سنتخطّى في هذا الدرس التطبيقي حول الترميز عملية الدمج مع Jira وسنجعل الوكيل يحفظ المهام في Google Cloud Storage بدلاً من ذلك.

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

ولكن أولاً، عليك ضبط متغيرات البيئة الخاصة بـ Dev Agent.

  1. في Cloud Shell، انتقِل إلى الدليل dev-agent:
    cd $HOME/next-26-keynotes/genkey/fabric-unified-intelligence/agents/dev-agent
  2. نفِّذ الأمر التالي لنسخ ملف .env.sample إلى .env:
    cp .env.sample .env
  3. في Cloud Shell، نفِّذ الأوامر التالية لملء ملف .env بتفاصيل مشروعك:
    source ~/lab_env.sh
sed -i "s/YOUR_PROJECT_ID/${PROJECT_ID}/" .env
sed -i "s/YOUR_ASSET_BUCKET_NAME/${PROJECT_ID}-artifacts/" .env
sed -i "s/YOUR_VEO_GCS_BUCKET/${PROJECT_ID}-videos/" .env
sed -i "s/YOUR_LOGS_BUCKET_NAME/${PROJECT_ID}-logs/" .env

نشر Dev Agent

  1. في Cloud Shell، انشر وكيل Dev باستخدام Makefile:
    make deploy

بعد نشرها، ستحصل على عنوان URL لـ "الأداة المساعدة للمطوّرين".

  1. في Cloud Shell، نفِّذ الأمر التالي للحصول على عنوان URL للخدمة التي تم نشرها وحفظه في ملف بيئة المختبر:
    source ~/lab_env.sh
DEV_AGENT_URL=$(gcloud run services describe dev-agent --region us-central1 --format 'value(status.url)')
echo "export DEV_AGENT_URL=\"${DEV_AGENT_URL}\"" >> ~/lab_env.sh
source ~/lab_env.sh

5- إعداد Gemini Enterprise وتسجيل الوكلاء

في هذا الدرس التطبيقي حول الترميز، سنستخدم Gemini Enterprise لتسجيل الوكلاء وإدارتهم، ما يتيح لهم التفاعل مع Workspace وأنظمة المؤسسة الأخرى وإتاحتهم للمستخدمين للتفاعل معهم.

يجب الاشتراك في فترة تجريبية من Gemini Enterprise Plus لاستخدام هذا الدرس التطبيقي حول الترميز. ستنشئ أيضًا تطبيقًا ستستخدمه لتسجيل "الوكلاء".

الاشتراك في الفترة التجريبية من Gemini Enterprise

بما أنّنا فعّلنا Discovery Engine API، لن تحتاج إلى بدء إصدار تجريبي بشكل صريح. بدلاً من ذلك، سيظهر لك زر مختلف لإنشاء تطبيقك الأول.

  1. انتقِل إلى صفحة Gemini Enterprise في Google Cloud Console.
  2. ستظهر لك شاشة ترحيب. انقر على "إنشاء تطبيقك الأول".gemini-enterprise-app

إنشاء تطبيق

  1. أدخِل n26-unified لاسم التطبيق. لاحظ بانر الفترة التجريبية المجانية المعروض على الشاشة.trial-banner
  2. اترك الحقول الأخرى على الإعدادات التلقائية وانقر على "إنشاء".
  3. ستظهر لك شاشة ترحيب. انقر على الرابط معاينة.gemini-enterprise-app-preview
  4. ستظهر نافذة منبثقة جديدة تتضمّن تطبيق Gemini Enterprise على الويب. دوِّن عنوان URL في أعلى الشاشة في شريط العناوين. ستحتاج إلى عنوان URL هذا في الأقسام المستقبلية للوصول إلى التطبيق. يجب أن يبدو مشابهًا لما يلي: https://vertexaisearch.cloud.google.com/home/cid/ebb52d4a-b33b-4007-a180-91d02fa124e1.gemini-enterprise-web-app

تسجيل وكلاء مخصّصين

لكي يتمكّن Gemini Enterprise من استخدام Agent، عليك تسجيل Agent باستخدام تطبيق Gemini Enterprise. يمكن تسجيل العملاء المخصّصين الذين تم نشرهم في Cloud Run من خلال عملية الدمج بين العملاء (A2A).

  1. في نافذة منفصلة في وحدة التحكّم، انتقِل إلى شاشة "تطبيقات Gemini Enterprise".
  2. انقر على التطبيق الذي يحمل الاسم n26-unified
  3. في شريط التنقّل الأيمن، انقر على "الموظفون".

تسجيل "وكيل استراتيجية المنتج"

  1. للحصول على بطاقة الوكيل، نفِّذ الأمر التالي في Cloud Shell:
    source ~/lab_env.sh
TOKEN=$(gcloud auth print-identity-token)  
curl  -H "Content-Type: application/json" \
  -H "Authorization: Bearer ${TOKEN}" $PRODUCT_STRATEGY_URL/.well-known/agent-card.json  | jq
  2. انقر على + إضافة وكيل
  3. انقر على وكيل مخصّص من خلال A2A.
  4. الصِق رمز JSON الخاص ببطاقة الوكيل من الخطوة السابقة في مربّع النص.
  5. انقر على معاينة تفاصيل الوكيل.
  6. انقر على Next (التالي).
  7. انقر على تخطّي وإنهاء لتفويض الوكيل.
  8. في علامة التبويب أذونات المستخدم، امنح جميع المستخدمين دور مستخدم وكيل.
  9. انقر على "حفظ".

تسجيل "وكيل أبحاث السوق" في تطبيق Gemini Enterprise

  1. للحصول على بطاقة الوكيل، نفِّذ الأمر التالي في Cloud Shell:
    source ~/lab_env.sh
TOKEN=$(gcloud auth print-identity-token)  
curl  -H "Content-Type: application/json" \
  -H "Authorization: Bearer ${TOKEN}" $MARKET_RESEARCH_URL/.well-known/agent-card.json  | jq
  2. انقر على + إضافة وكيل
  3. انقر على وكيل مخصّص من خلال A2A.
  4. الصِق رمز JSON الخاص ببطاقة الوكيل من الخطوة السابقة في مربّع النص.
  5. انقر على معاينة تفاصيل الوكيل.
  6. انقر على Next (التالي).
  7. انقر على تخطّي وإنهاء لتفويض الوكيل.
  8. في علامة التبويب أذونات المستخدم، امنح جميع المستخدمين دور مستخدم وكيل.
  9. انقر على "حفظ".

تسجيل وكيل Orchestrator

  1. للحصول على بطاقة الوكيل، نفِّذ الأمر التالي في Cloud Shell:
    source ~/lab_env.sh
TOKEN=$(gcloud auth print-identity-token)  
curl  -H "Content-Type: application/json" \
  -H "Authorization: Bearer ${TOKEN}" $ORCHESTRATOR_URL/.well-known/agent-card.json  | jq
  2. انقر على + إضافة وكيل
  3. انقر على وكيل مخصّص من خلال A2A.
  4. الصِق رمز JSON الخاص ببطاقة الوكيل من الخطوة السابقة في مربّع النص.
  5. انقر على معاينة تفاصيل الوكيل.
  6. انقر على Next (التالي).
  7. انقر على تخطّي وإنهاء لتفويض الوكيل.
  8. في علامة التبويب أذونات المستخدم، امنح جميع المستخدمين دور مستخدم وكيل.
  9. انقر على "حفظ".

تسجيل Dev Agent

  1. للحصول على بطاقة الوكيل، نفِّذ الأمر التالي في Cloud Shell:
    source ~/lab_env.sh
TOKEN=$(gcloud auth print-identity-token)  
curl  -H "Content-Type: application/json" \
  -H "Authorization: Bearer ${TOKEN}" $DEV_AGENT_URL/.well-known/agent-card.json  | jq
  2. انقر على + إضافة وكيل
  3. انقر على وكيل مخصّص من خلال A2A.
  4. الصِق رمز JSON الخاص ببطاقة الوكيل من الخطوة السابقة في مربّع النص.
  5. انقر على معاينة تفاصيل الوكيل.
  6. انقر على Next (التالي).
  7. انقر على تخطّي وإنهاء لتفويض الوكيل.
  8. في علامة التبويب أذونات المستخدم، امنح جميع المستخدمين دور مستخدم وكيل.
  9. انقر على "حفظ".

6. الجزء 1: الاستراتيجية والتنسيق في Gemini Enterprise

في هذا القسم من الدرس التطبيقي، ستؤدي دور نائب رئيس قسم التسويق في شركة "Organic Living"، وستكون مسؤولاً عن إعادة تنشيط خطوط الإنتاج التي تشهد مبيعات ثابتة أو متراجعة.

لإعادة إحياء بعض خطوط الإنتاج الأقل رواجًا، ستطلب من وكيلك تحليل المؤشرات وتحديد المخزون غير المباع في مستودعك وتنظيم حملة إعادة إطلاق. ستتعرّف على كيفية تنسيق Gemini Enterprise لعدة وكلاء من أجل الردّ على طلب واحد معقّد.

هذا هو عنوان URL الذي دوّنته في الخطوة 4: إعداد Gemini Enterprise وتسجيل الوكلاء. إذا لم يكن لديك عنوان URL، يمكنك الحصول عليه باتّباع الخطوات التالية:

  1. الانتقال إلى شاشة "تطبيقات Gemini Enterprise"
  2. انقر على التطبيق الذي يحمل الاسم n26-unified
  3. انقر على عنوان URL الذي يبدأ بـ https://vertexaisearch.cloud.google.com.

إصدار طلب إلى الوكيل لمساعدتك في إنجاز مهمتك

  1. ابدأ في المحادثة الجديدة من خلال الكتابة في مربّع المحادثة على صفحتك الرئيسية أو انقر على محادثة جديدة في شريط التنقّل على الجانب الأيمن.
  2. أضِف الطلب التالي:
    Analyze current interior design trends and identify dead stock in our warehouse that matches the trend. Orchestrate a relaunch campaign
  3. انقر على إرسال (الرمز الذي يظهر فيه طائرة ورقية) وشاهِد أداة Orchestrator Agent وهي تعمل.

مراقبة الناتج

باستخدام هذا الطلب الواحد، يكمل العديد من الوكلاء سلسلة من المهام في غضون دقائق بدلاً من ساعات.

  • يحلّل "وكيل أبحاث السوق"، المستنِد إلى Deep Research، أحدث المعلومات على "بحث Google" للعثور على أحدث مؤشرات التصميم.
  • يتصل Data Insights Agent ببيانات المنتجات العالمية ويقدّم نتائج البحث إلى الكتالوج الداخلي لتحديد السلع "غير الرائجة" (المستودع المنخفض السرعة) التي تتطابق مع معايير المؤشرات هذه.
  • يجمع "وكيل استراتيجية المنتج" كل المعلومات معًا لإنشاء استراتيجية حملة إعادة إطلاق استنادًا إلى البحث والبيانات من الوكلاء الآخرين.

الموافقة على الخطة ومراقبة الناتج

  1. الردّ بـ "Yes" للموافقة على الخطة
  2. مراقبة الناتج
    • تبدأ هذه الحزمة بإحصاءات من "أداة أبحاث السوق" وتتضمّن خطة شاملة تشمل إعادة تصميم العلامة التجارية للموقع الإلكتروني.
    • تتضمّن هذه السمة البيانات التي تم استردادها من بيانات منتجاتنا باستخدام "برنامج BigQuery Data Agent" الذي أعددناه سابقًا.
    • يُرجى ملاحظة المصادر في أسفل النتائج لتكون على ثقة في التحليل والاقتراحات.

إنشاء فيديوهات استنادًا إلى أسلوب Organic Living الجديد

  1. في المحادثة، اطلب من "وكيل استراتيجية المنتجات" إنشاء فيديوهات. ابدأ بكتابة @Product واختَر وكيل استراتيجية المنتج من القائمة.
  2. أضِف الطلب التالي:
    generate three videos for the landing page
  3. سيستخدم Gemini "وكيل استراتيجية المنتجات" لإنشاء مواد عرض الفيديو وتوفير عناوين URL لها.

التنسيق مع فريق التطوير

في العرض التوضيحي الرئيسي، أرسل "وكيل المطوّر" إشعارًا إلى فريق المطوّرين في Google Chat. ومع ذلك، أزلنا هذه الخطوة من هذا الدرس العملي لأنّ خطافات الويب الواردة غير متاحة لحسابات Gmail الشخصية. بدلاً من ذلك، سيركّز Dev Agent على إنشاء المهمة في Google Cloud Storage.

  1. في المحادثة، اطلب من "وكيل المطوّر" إنشاء مهمة لفريق التطوير. ابدأ بكتابة @Dev واختَر Dev Agent من القائمة.
  2. أضِف الطلب التالي:
    create a task for the dev team to get started on the new product landing page.
  3. راقِب الناتج. سيؤكّد لك Dev Agent أنّه أنشأ مهمة وسيقدّم لك معرّف المهمة (مثل TASK-A3F7B2C1). دوِّن معرّف المهمة هذا لأنّك ستحتاج إليه في "الفصل 2".

7. الجزء 2: الإنشاء في Gemini CLI

في هذا الدور، عليك التبديل إلى دور المطوّر. تم تكليفك بإنشاء الصفحة المقصودة للحملة الجديدة وإطلاقها، ومتابعة المهمة التي تم إنشاؤها في الجزء الأول.

ستستخدم Gemini CLI لإنشاء موقع "Organic Living" الإلكتروني استنادًا إلى مواصفات تصميمية واردة في ملف المهمة. ‫Gemini CLI هو وكيل مفتوح المصدر مستند إلى الذكاء الاصطناعي يتيح لك الاستفادة من إمكانات Gemini مباشرةً في سطر الأوامر. وهي مثبَّتة مسبقًا في بيئة Cloud Shell.

ضبط إعدادات Gemini CLI

  1. في Cloud Shell، أنشئ دليلاً جديدًا لمشروع موقعك الإلكتروني وانتقِل إليه:
    mkdir -p $HOME/website
cd $HOME/website
  2. انسخ تعليمات GEMINI.md وصورة التصميم من المستودع الذي تم استنساخه إلى دليل العمل:
    cp $HOME/next-26-keynotes/genkey/fabric-unified-intelligence/gemini-cli/GEMINI.md .
cp $HOME/next-26-keynotes/genkey/fabric-unified-intelligence/gemini-cli/Organic_Living_Website_Design.png .
  3. أنشئ دليل إعدادات الوكيل وأنشئ الملف dev-agent.md:
    source ~/lab_env.sh
mkdir -p ~/.gemini/agents
cat > ~/.gemini/agents/dev-agent.md <<EOF
---
kind: remote
name: dev-agent
agent_card_url: ${DEV_AGENT_URL}/.well-known/agent-card.json
description: "Task assistant. Use for: creating/looking up/starting APPDEV tasks."
auth:
  type: google-credentials
---
EOF

بدء إرسال الطلبات

  1. نفِّذ الأمر gemini-cli لبدء التفاعل:
    source ~/lab_env.sh
gemini
  2. سيُطلب منك تأكيد ما إذا كنت تثق في الملفات الموجودة في هذا المجلد. حدِّد الخيار 1. مجلد الثقة (الموقع الإلكتروني)
  3. اكتب auth واضغط على مفتاح الرجوع في طلب Gemini CLI.
  4. انقر على استخدام مفتاح Gemini API. سيؤدي ذلك تلقائيًا إلى استخدام متغيّر البيئة GEMINI_API_KEY الذي حمّلته من lab_env.sh.
  1. في طلب gemini>، أخبر الوكيل أنّك تريد العمل على المهمة التي تم إنشاؤها في "الفصل 1" (استبدِل TASK-A3F7B2C1 بمعرّف المهمة الفعلي الذي دوّنته):
    @dev-agent let me work on TASK-A3F7B2C1
    سيبحث الوكيل عن المهمة في GCS ويقدّم لك نظرة عامة وخطة.
  2. الآن، اطلب من الوكيل إنشاء الموقع الإلكتروني:
    Build and deploy it
    سيقرأ Gemini ملف GEMINI.md في الدليل الحالي ويبدأ في إنشاء الموقع الإلكتروني وفقًا للمواصفات.
  3. بعد اكتمال عملية الإنشاء والنشر، سيعرض الوكيل النتائج، بما في ذلك عنوان URL الخاص بخدمة Cloud Run التي تم نشرها.
  4. انقر على عنوان URL المقدَّم لفتح الموقع الإلكتروني الجديد "Organic Living" في علامة تبويب جديدة وتأكَّد من أنّه يتطابق مع مواصفات التصميم.

8. ملخّص

في هذا الدرس التطبيقي حول الترميز، أثبتّ بنجاح فعالية "بنية الذكاء الموحّد" من خلال إكمال سير عمل معقّد ومتعدد الخطوات عبر أدوار وبيئات مختلفة:

  1. تنظيم نظام متعدد الوكلاء: في Gemini Enterprise، استخدمت طلبًا واحدًا لإشراك فريق من الوكلاء (أبحاث السوق، ورؤى البيانات، واستراتيجية المنتج) لتحليل المؤشرات، وتحديد المخزون، ووضع استراتيجية لإعادة الإطلاق. يمكنك إنجاز العديد من المهام من خلال طلب واحد بدون الحاجة إلى إكمال كل مهمة على حدة.
  2. مواد العرض المتعدّدة الوسائط التي تم إنشاؤها: استخدمت "وكيل استراتيجية المنتجات" لإنشاء مواد عرض فيديو لمجموعة المنتجات الجديدة.
  3. عملية تسليم محاكاة بين الأدوار: استخدمت "وكيل المطوّر" لإنشاء مهمة في GCS، ما يحاكي عملية التسليم من فريق العمل التجاري إلى فريق التطوير. احتفظ النظام بالسياق المشترك بدون الحاجة إلى مشاركته مباشرةً.
  4. إنشاء موقع إلكتروني باستخدام Gemini CLI: في Cloud Shell، بدّلت إلى دور المطوّر واستخدمت Gemini CLI لإنشاء صفحة مقصودة ونشرها استنادًا إلى المهمة التي تم إنشاؤها في الخطوة السابقة ومواصفات التصميم في GEMINI.md.

يوضّح سير العمل هذا كيف يمكن لـ Gemini Enterprise ربط أدوات ومصادر بيانات وأدوار مختلفة لتبسيط عمليات المؤسسة المعقّدة.

9- تنظيف

ينشئ هذا المختبر الكثير من الموارد، ولهذا السبب ننصحك بحذف المشروع بأكمله لتجنُّب خطوة تنظيف طويلة.

  1. في Cloud Shell، نفِّذ الأمر التالي لحذف مشروع Google Cloud بالكامل:
source ~/lab_env.sh
gcloud projects delete "${PROJECT_ID}"

10. تهانينا

تهانينا! لقد أكملت بنجاح الدرس التطبيقي حول الترميز "Fabric of Unified Intelligence".