כתיבת קוד LookML באמצעות כלי תכנות אג'נטיים

1. מבוא

כלי כתיבת קוד מבוססי-סוכנים שמבוססים על המערכת האקולוגית של VS Code הפכו לפופולריים מאוד. ‫Cursor ו-Antigravity הן רק שתי דוגמאות. ב-Codelab הזה נסביר איך לכתוב LookML באמצעות כלי הקוד האלה.

מה עושים

בשיעור Codelab הזה נשתמש בתוסף VS Code של Looker כדי לשנות מודל LookML, להוסיף מדד חדש, לבדוק את המדד החדש ואז ליצור מרכז שליטה של LookML באמצעות המדד החדש. כל הפעולות האלה יתבצעו באמצעות הנחיה לסוכן תכנות.

מה תצטרכו

  • מכונה של Looker שבה יש לכם הרשאות פיתוח.
  • היכרות בסיסית עם Looker, כולל יצירת פרויקט LookML חדש וצפייה ב-Explores ואינטראקציה איתם ב-Looker.
  • מזהה לקוח (client_id) וסוד לקוח (client_secret) של API עבור המשתמש במופע Looker.
  • סוכן לתכנות שמבוסס על VS Code. במדריך הזה נשתמש ב-Antigravity.
  • חשבון ב-GitHub.
  • פרויקט Google Cloud שבו מופעל BigQuery.

קהל: מפתחי LookML, מהנדסי נתונים ואדריכלים.

2. הגדרת מופע ב-Looker

יצירת פרויקט ב-Google Cloud

  1. במסוף Google Cloud, בדף לבחירת הפרויקט, בוחרים פרויקט ב-Google Cloud או יוצרים פרויקט.
  2. הקפידו לוודא שהחיוב מופעל בפרויקט שלכם ב-Cloud. כך בודקים אם החיוב מופעל בפרויקט

קישור Looker למקור הנתונים

  1. ב-Looker, בקטע ניהול, עוברים לכותרת מסדי נתונים ובוחרים באפשרות חיבורים.
  2. לוחצים על הוספת חיבור בפינה השמאלית העליונה של המסך.
  3. יוצרים מקור נתונים חדש למערך הנתונים Cymbal Gadgets. נותנים לו את השם cymbal_gadgets. בוחרים באפשרות Google BigQuery Standard SQL בשביל SQL Dialect. צילום מסך של הגדרות חיבור כלליות
  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 למאגר משלכם. אי אפשר להוסיף מפתח פריסה לפרויקט שאתם לא הבעלים שלו, ולכן צריך ליצור Fork כדי לקשר את הפרויקט ל-Looker.
  2. מפעילים את מצב פיתוח.
  3. בוחרים באפשרות פיתוח ואז באפשרות פרויקטים.
  4. בדף LookML Projects (פרויקטים של LookML), לוחצים על New Model (מודל חדש).
  5. כדי להשתמש בדף הישן ליצירת מודל LookML, לוחצים על הקישור. צילום מסך של הקישור לתיבת הדו-שיח הישנה ליצירת מודל
  6. יוצרים פרויקט חדש וריק ב-Looker בשם cymbal_gadgets. צילום מסך של תיבת הדו-שיח ליצירת פרויקט חדש
  7. בוחרים באפשרות Configure Git כדי לחבר אותו למאגר המפוצל שיצרתם. צילום מסך של הגדרת git
  8. מוסיפים את Deploy Key למאגר Git. חשוב לסמן את התיבה כדי לאפשר גישת כתיבה באמצעות מפתח הפריסה. צילום מסך של הגדרת מפתח הפריסה של git
  9. לאחר מכן בוחרים באפשרות Test and Finalize Setup (בדיקה והשלמת ההגדרה). צילום מסך של הגדרת הפרויקט שהושלמה
  10. כדי לוודא שהפרויקט ומקור הנתונים פועלים, מריצים שאילתה על נתונים מהניתוח '🛍️ Cymbal Gadgets: Transactions & Sales'.
  11. פותחים את פרויקט cymbal_gadgets בכלי לעריכת LookML ולוחצים על הלחצן Create Developer Copy (יצירת עותק למפתחים) בפינה השמאלית העליונה.
  12. בקטע Git Actions (פעולות Git), לוחצים על Push Changes To Remote (דחיפת שינויים למאגר מרוחק) כדי שהענף dev יהיה זמין מ-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
    מחליפים את שם חשבון המשתמש ב-GitHub ב-YOUR_GITHUB_USER. מחליפים גם את 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 כולל את ההטמעה הרשמית של Looker MCP. בקטע הזה נסביר איך להגדיר את התכונה הזו במכונת Looker.

  1. קודם צריך API client_id ו-client_secret. משתמשים במדריך למפתחות API של Looker כדי ליצור את הערכים client_id ו-client_secret עבור המשתמש. תצטרכו גם את כתובת ה-URL הבסיסית של המכונה של Looker.
  2. עכשיו משתמשים ב-npx כדי להתקין את MCP Toolbox. אתם יכולים לספק את כתובת ה-URL של מופע Looker ואת פרטי הכניסה ל-API כמשתני סביבה מוטבעים, או להגדיר אותם בסביבת המעטפת. מריצים את הפקודה הבאה בסביבת מעטפת ב-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 ולשרת ה-MCP של Looker.

  1. ב-Antigravity, משתמשים בקיצור הדרך CMD-SHIFT-P (ב-Mac) או CTRL+SHIFT+P (ב-Linux/Windows) כדי לפתוח את לוח הפקודות ובוחרים באפשרות Preferences: Open Workspace Settings (JSON).
  2. כדי להגדיר את התוסף באמצעות client_id ו-client_secret, מוסיפים את הפרטים הבאים להגדרות Workspace. לשימוש ב-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 ששונה

התוסף VS Code מסנכרן באופן אוטומטי את קובץ ה-LookML ששונה עם Looker. אפשר לבדוק אותו במצב פיתוח.

בדיקה בסביבת פיתוח משולבת (IDE)

כאן אפשר לכתוב הנחיה ל-Antigravity לגבי query CLV broken down by customer loyalty tier. ‫Antigravity ישתמש בשרת ה-MCP של Looker כדי למצוא את המודלים, לבדוק את השדות הזמינים ולהריץ שאילתה באמצעות Looker. התוצאה תיראה בערך כך:

צילום מסך של נתונים ב-Antigravity

בדיקה ב-Looker

ב-Looker, כשהאפשרות 'מצב פיתוח' מופעלת, פותחים את האפשרות 🛍️ Cymbal Gadgets: Transactions & Sales. בוחרים את מדד ערך הלקוח לטווח הארוך (CLV) ואז יוצרים ציר לפי שנת הרישום של הלקוח. מריצים את השאילתה. הוא אמור להיראות כך.

צילום מסך של הניתוח

5. יצירת לוח בקרה של ערך הלקוח לטווח הארוך (CLV)

עכשיו ננסה דוגמה מורכבת יותר. נבקש מהסוכן ליצור מרכז שליטה חדש לגמרי ב-LookML.

בקשה מסוכן ליצירת מרכז בקרה חדש

חוזרים ל-Antigravity. באותו שיחה, מוודאים שמצב התכנון והמודל העדכני של Gemini נבחרו. לאחר מכן מזינים את ההנחיה Create a dashboard showing customer lifetime value based on customer loyalty tier.

צילום מסך של יצירת לוח בקרה

מאשרים שוב את תוכנית ההטמעה ומאשרים את השינויים בקוד. עכשיו הקובץ החדש הזה של LookML יסונכרן עם Looker באופן אוטומטי.

בדיקה ב-Looker

במצב פיתוח, עוברים לתיקייה LookML Dashboards. בוחרים את מרכז הבקרה החדש שנוצר כדי לראות אותו.

צילום מסך של לוח הבקרה החדש

6. הסרת המשאבים

  1. ב-Antigravity, בחלונית Source Control (בקרת מקור), מחזירים את השינויים ב-LookML אם רוצים. לצד כל קובץ LookML שעבר שינוי יופיע סמל כמו ↶ כדי לשחזר את הקובץ. לוחצים על הלחצן הזה לכל קובץ. צילום מסך של ביטול השינויים
  2. ב-Looker, בוחרים באפשרות Admin (ניהול) ואז באפשרות Database (מסד נתונים) ואז באפשרות Connections (חיבורים). לוחצים על סמל גלגל השיניים של החיבור cymbal_gadgets ובוחרים באפשרות מחיקה. מאשרים שרוצים למחוק את הקישור.
  3. ב-Looker, משתמשים במצב פיתוח. בוחרים באפשרות פיתוח ואז בפרויקט cymbal_gadgets. בקטע Project Settings (הגדרות הפרויקט), בוחרים באפשרות Delete Project (מחיקת הפרויקט). כדי לאשר את מחיקת הפרויקט, מקלידים את שם הפרויקט – cymbal_gadgets – ולוחצים על הלחצן מחיקה סופית של cymbal_gadgets.

7. מזל טוב

כל הכבוד, סיימתם את ה-Codelab.

מה נכלל

  • איך משנים LookML באמצעות סוכן.
  • איך מאמתים תוכניות הטמעה.
  • איך בודקים מ-IDE.
  • איך בודקים בממשק המשתמש של Looker.
  • איך יוצרים מרכז בקרה חדש באמצעות סוכן.

פעולות שכדאי לנסות

עכשיו נסו את ההנחיות הבאות בממשק המשתמש כדי לראות יכולות שונות של סביבת הפיתוח המשולבת (IDE) מבוססת-הסוכן:

  • תיאורים טובים חשובים מאוד למשתמשים ול-AI. מנחים את הסוכן להוסיף תיאורים לכל השדות שאין להם תיאור.
  • מבקשים מהנציג להוסיף עוד מסגרות זמן לאחת מקבוצות המאפיינים.
  • מבקשים מהסוכן לבצע שאילתה כמו 'הכנסות לפי קטגוריית מוצרים, עם ציר זמן של רבעונים'.

מידע נוסף