إنشاء رمز LookML باستخدام أدوات الترميز المستنِدة إلى الذكاء الاصطناعي الوكيل

1. مقدمة

أصبحت أدوات إنشاء الرموز البرمجية المستندة إلى الذكاء الاصطناعي الوكيل والتي تستند إلى نظام VS Code الأساسي شائعة جدًا. يُعدّ المؤشر وAntigravity مثالَين فقط. سيوضّح هذا الدرس التطبيقي حول الترميز كيفية كتابة LookML باستخدام أدوات الترميز هذه.

المهام التي ستنفذها

في هذا الدرس التطبيقي حول الترميز، ستستخدم إضافة VS Code في Looker لتعديل نموذج LookML من أجل إضافة مقياس جديد، ثم اختبار المقياس الجديد، ثم إنشاء لوحة بيانات LookML باستخدام هذا المقياس الجديد. سيتم تنفيذ كل ذلك من خلال مطالبة Coding Agent.

المتطلبات

الجمهور: مطوّرو LookML ومهندسو البيانات ومهندسو البنية الأساسية

2. إعداد نسخة Looker

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

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

ربط Looker بمصدر البيانات

  1. في Looker، ضِمن المشرف، انتقِل إلى العنوان قواعد البيانات واختَر عمليات الربط.
  2. انقر على إضافة حساب في أعلى يسار الشاشة.
  3. أنشئ مصدر بيانات جديدًا لمجموعة بيانات Cymbal Gadgets. أطلِق عليها الاسم cymbal_gadgets. اختَر Google BigQuery Standard SQL من أجل "إصدار لغة الاستعلامات البنيوية (SQL)". لقطة شاشة لإعدادات الربط العامة
  4. في الصفحة التالية، أدخِل اسم مشروع على السحابة الإلكترونية من Google ومشروع التخزين looker-private-demo واسم مجموعة البيانات cymbal_gadgets. لقطة شاشة لإعدادات قاعدة البيانات
  5. اقبل القيم التلقائية لجميع الحقول المتبقية وأكمِل عملية إنشاء مصدر البيانات الجديد.
  6. في SQL Runner، تأكَّد من إمكانية الاستعلام عن مجموعة البيانات من خلال تنفيذ
    SELECT count(*)
FROM looker-private-demo.cymbal_gadgets.transactions

استيراد المشروع من GitHub

  1. تفرّع من المشروع https://github.com/looker-open-source/cymbal_gadgets من GitHub إلى المستودع الخاص بك. لا يمكنك إضافة مفتاح نشر إلى مشروع لا تملكه، لذا يجب إنشاء نسخة من المشروع لربطه بـ Looker.
  2. فعِّل وضع التطوير.
  3. اختَر تطوير ثم المشاريع.
  4. من صفحة "مشاريع LookML"، انقر على نموذج جديد.
  5. انقر على الرابط لاستخدام صفحة إنشاء نموذج LookML القديمة. لقطة شاشة لرابط مربّع الحوار القديم الخاص بإنشاء النماذج
  6. أنشئ مشروعًا فارغًا جديدًا في Looker باسم cymbal_gadgets. لقطة شاشة لمربّع الحوار الخاص بالمشروع الجديد
  7. اختَر ضبط Git لربطه بالمستودع المتفرّع الذي أنشأته. لقطة شاشة لإعداد git
  8. أضِف Deploy Key إلى مستودع Git. احرص على وضع علامة في المربّع للسماح بالوصول للكتابة باستخدام مفتاح النشر. لقطة شاشة لعملية إعداد مفتاح نشر git
  9. بعد ذلك، اختَر الاختبار وإكمال عملية الإعداد. لقطة شاشة لعملية إعداد المشروع المكتملة
  10. تأكَّد من أنّ المشروع ومصدر البيانات يعملان من خلال طلب بيانات من الاستكشاف "🛍️ أدوات Cymbal: المعاملات والمبيعات".
  11. افتح مشروع cymbal_gadgets في "محرّر LookML" وانقر على الزر إنشاء نسخة مطوّر في أعلى يسار الصفحة.
  12. ضمن إجراءات Git، انقر على إرسال التغييرات إلى الخادم البعيد لكي يتوفّر فرع التطوير من GitHub. لقطة شاشة من Git Actions
  13. من جلسة وحدة طرفية على الكمبيوتر، شغِّل ما يلي:
    cd $HOME
git clone git@github.com:YOUR_GITHUB_USER/cymbal_gadgets.git
cd cymbal_gadgets
git checkout YOUR_DEV_BRANCH
    استبدِل YOUR_GITHUB_USER باسم حساب المستخدم الخاص بك على GitHub. استبدِل YOUR_DEV_BRANCH أيضًا باسم فرع التطوير. سيتم تسمية فرع التطوير الخاص بك باسم مشابه لما يلي: dev-john-doe-jhgr، أي الكلمة dev متبوعة باسمك الأول واسم عائلتك، ثم سلسلة عشوائية قصيرة. يمكنك العثور على فرع التطوير الشخصي في أعلى "محرّر LookML" في واجهة مستخدم Looker.

3- إعداد بيئة تطوير متكاملة (IDE) مستندة إلى وكيل

تثبيت إضافة VS Code

في بيئة التطوير المتكاملة (IDE)، انقر على رمز "الإضافات" في اللوحة اليمنى. بعد ذلك، ابحث عن "Looker" وثبِّت الإضافة الرسمية من Google بالنقر على زر التثبيت.

تثبيت خادم MCP Toolbox for Databases

لتوفير إذن وصول Antigravity إلى Looker API (تنفيذ طلبات البحث وفحص SQL وفحص نموذج LookML وفحص معلومات مخطط الاتصال)، تحتاج إلى خادم MCP Toolbox for Databases محلي قيد التشغيل. تتضمّن MCP Toolbox عملية التنفيذ الرسمية لـ MCP في Looker. في هذا القسم، يمكنك إعداد هذه الميزة وضبطها لمثيل Looker.

  1. أولاً، تحتاج إلى client_id وclient_secret. استخدِم دليل مفاتيح Looker API لإنشاء client_id وclient_secret للمستخدم. ستحتاج أيضًا إلى عنوان URL الأساسي لنسخة Looker.
  2. ستستخدم الآن npx لتثبيت MCP Toolbox. يمكنك تقديم عنوان URL لمثيل Looker وبيانات اعتماد واجهة برمجة التطبيقات كمتغيرات بيئة مضمّنة، أو يمكنك ضبطها في بيئة shell. نفِّذ ما يلي في بيئة shell على أجهزة Mac وLinux:
    LOOKER_BASE_URL="https://your-instance.looker.com" \
LOOKER_CLIENT_ID="YOUR_CLIENT_ID" \
LOOKER_CLIENT_SECRET="YOUR_CLIENT_SECRET" \
npx @toolbox-sdk/server --prebuilt=looker,looker-dev
    في نظام التشغيل Windows، نفِّذ ما يلي في Powershell:
    $env:LOOKER_BASE_URL="https://your-instance.looker.com"
$env:LOOKER_CLIENT_ID="YOUR_CLIENT_ID"
$env:LOOKER_CLIENT_SECRET="YOUR_CLIENT_SECRET"
npx @toolbox-sdk/server --prebuilt=looker,looker-dev

ضبط إضافة VS Code

في هذه الخطوة، عليك ضبط إعدادات إضافة VS Code للربط بخادم Looker وLooker MCP.

  1. في Antigravity، استخدِم CMD-SHIFT-P (على جهاز Mac) أو CTRL+SHIFT+P (على جهاز Linux أو Windows) لفتح لوحة الأوامر واختَر Preferences: Open Workspace Settings (JSON).
  2. أضِف ما يلي إلى "إعدادات Workspace" لضبط الإضافة باستخدام client_id وclient_secret. بالنسبة إلى استخدام looker.projectId، استخدِم cymbal_gadgets:
    {
   "looker.instanceURL": "https://your-instance.looker.com",
   "looker.clientId": "YOUR_API_KEY_CLIENT_ID",
   "looker.clientSecret": "YOUR_API_KEY_CLIENT_SECRET",
   "looker.projectId": "cymbal_gadgets"
}

فتح المحرِّر

  1. افتح Antigravity.
  2. انقر على ملف > فتح مجلد....
  3. انتقِل إلى المجلد cymbal_gadgets واختَره.

4. إنشاء مقياس القيمة الدائمة للعميل

أولاً، عليك إنشاء مقياس جديد في نموذج LookML الحالي باستخدام "الوكيل". سيكون مقياس Customer Lifetime Value مفيدًا في حالة الاستخدام هذه في مجال البيع بالتجزئة. ستستخدم "الوكيل" لتحديد المنهجية وLookML لهذا المقياس.

إرسال طلب إلى الوكيل

في cymbal_gadgets المشروع في مساحة عمل Antigravity، من المفترض أن تظهر لك واجهة محادثة جديدة على اليسار. ابدأ المحادثة في وضع التخطيط باستخدام أحدث نموذج من Gemini مع الطلب: Create a Customer Lifetime Value measure.

لقطة شاشة لطلب في Antigravity

الاطّلاع على خطة التنفيذ

سيضع "الوكيل" أولاً خطة تنفيذ. افتح خطة التنفيذ لمراجعتها، ثم انقر على الزر متابعة.

لقطة شاشة لخطة التنفيذ

مراجعة LookML

راجِع رمز LookML الذي تم تغييره. تأكَّد من أنّ التغييرات منطقية وصالحة.

لقطة شاشة لرمز LookML الذي تم تغييره

تتم مزامنة LookML المعدَّلة تلقائيًا مع Looker من خلال إضافة VS Code. يمكن اختباره في وضع التطوير.

الاختبار في بيئة التطوير المتكاملة

أرسِل طلبًا إلى Antigravity بخصوص query CLV broken down by customer loyalty tier. سيستخدم Antigravity خادم Looker MCP للعثور على النماذج وفحص الحقول المتاحة وتنفيذ طلب بحث باستخدام Looker. ستكون النتيجة على النحو التالي:

لقطة شاشة للبيانات في Antigravity

الاختبار في Looker

في Looker، بعد تفعيل "وضع التطوير"، افتح استكشاف 🛍️ أدوات Cymbal: المعاملات والمبيعات. اختَر مقياس "القيمة الدائمة للعميل"، ثمّ استخدِم "جدولاً محوريًا" حسب "سنة تسجيل العميل". نفِّذ الاستعلام. من المفترض أن يبدو بالشكل التالي.

لقطة شاشة لصفحة "استكشاف"

5- إنشاء لوحة بيانات "القيمة الدائمة للعميل"

سنحاول الآن تقديم مثال أكثر تعقيدًا. سنطلب من الوكيل إنشاء لوحة بيانات LookML جديدة تمامًا.

طلب لوحة بيانات جديدة من "الوكيل"

العودة إلى Antigravity في المحادثة نفسها، تأكَّد من اختيار وضع التخطيط وأحدث نموذج Gemini. بعد ذلك، وجِّه الطلب Create a dashboard showing customer lifetime value based on customer loyalty tier.

لقطة شاشة لعملية إنشاء لوحة البيانات

كرِّر الموافقة على خطة التنفيذ وقبول تغييرات الرمز. سيتم الآن تلقائيًا مزامنة ملف LookML الجديد هذا مع Looker.

الاختبار في Looker

في "وضع التطوير"، انتقِل إلى المجلد LookML Dashboards. اختَر لوحة البيانات التي تم إنشاؤها حديثًا لعرضها.

لقطة شاشة للوحة البيانات الجديدة

6. تَنظيم

  1. في Antigravity، ضمن لوحة "التحكّم بالمصدر"، يمكنك التراجع عن تغييرات LookML إذا أردت ذلك. بجانب كل ملف LookML معدَّل، سيظهر رمز مثل ↶ لإرجاع الملف. انقر على هذا الزر لكل ملف. لقطة شاشة لعملية إلغاء التغييرات
  2. في Looker، اختَر المشرف ثمّ قاعدة البيانات ثمّ عمليات الربط. انقر على رمز الترس الخاص بربط حساب cymbal_gadgets واختَر حذف. أكِّد أنّك تريد إلغاء الربط.
  3. في Looker، استخدِم وضع التطوير. اختَر تطوير ثم مشروع cymbal_gadgets. ضمن إعدادات المشروع، اختَر حذف المشروع. أكِّد أنّك تريد حذف المشروع من خلال كتابة اسم المشروع - cymbal_gadgets - ثم النقر على الزرّ حذف cymbal_gadgets نهائيًا.

7. تهانينا

تهانينا على إكمال هذا الدرس العملي.

المواضيع التي تناولناها

  • كيفية تعديل LookML باستخدام أحد الوكلاء
  • كيفية التحقّق من خطط التنفيذ
  • كيفية إجراء الاختبار من بيئة التطوير المتكاملة
  • كيفية إجراء الاختبار في واجهة مستخدم Looker
  • كيفية إنشاء لوحة بيانات جديدة باستخدام "الوكيل"

إجراءات مُقترَحة

جرِّب الآن الطلبات التالية في واجهة المستخدم للاطّلاع على الإمكانات المختلفة لبيئة التطوير المتكاملة المستندة إلى الوكلاء:

  • تُعدّ الأوصاف الجيدة ضرورية لكل من المستخدمين والذكاء الاصطناعي. اطلب من "الوكيل" إضافة أوصاف إلى جميع الحقول التي لا تتضمّن وصفًا.
  • اطلب من "الوكيل" إضافة المزيد من الأُطر الزمنية إلى إحدى "مجموعات السمات".
  • اطلب من "الوكيل" تنفيذ طلب بحث مثل "الأرباح مصنّفة حسب فئة المنتج ومقسّمة حسب الربع السنوي".

مزيد من المعلومات