‫Google משתמשת בטכנולוגיית AI כדי לתרגם תוכן לשפה המועדפת עליך. בתרגומים כאלו עשויות להיות שגיאות.

שימוש ב-Looker עם MCP, ‏Gemini CLI וסוכנים אחרים

בדף הזה מוסבר איך לקשר את מופע Looker לכלים שונים למפתחים.

כדי ליהנות מהחוויה הכי עוצמתית ומשולבת, מומלץ להשתמש בתוסף הייעודי של Looker ל-Gemini CLI. אפשר להשתמש בשכבה הסמנטית של Looker כדי לספק ל-Gemini CLI גישה מאובטחת, מבוקרת ועל פי דרישה לנתונים מהימנים, ולזרז את תהליכי העבודה על ידי אוטומציה של יצירת דוחות, תרשימים ולוחות בקרה מהנחיות בשפה טבעית. ממשק Gemini CLI הוא ממשק שורת הפקודה מהדור הבא של Google Cloud, והוא הכלי המומלץ לאינטראקציה עם מופעי Looker משורת הפקודה.

אפשר גם לחבר סביבות פיתוח משולבות (IDE) אחרות וכלים למפתחים שתומכים ב-Model Context Protocol‏ (MCP) באמצעות MCP Toolbox for Databases לשימוש כללי. ‫MCP Toolbox הוא שרת MCP בקוד פתוח שמפשט את החיבור של סוכני AI לנתונים שלכם. הוא מטפל במורכבויות כמו אימות ואיגום חיבורים, ומאפשר לכם ליצור אינטראקציה עם הנתונים באמצעות שפה טבעית ישירות מסביבת הפיתוח המשולבת (IDE). השיטה הזו מספקת יכולות ליבה של אינטראקציה עם מסד נתונים עבור הכלים האלה.

מידע על Gemini CLI ותוספים

‫Gemini CLI הוא סוכן AI בקוד פתוח שנועד להאיץ את תהליכי הפיתוח באמצעות סיוע בכתיבת קוד, באיתור באגים, בחיפוש נתונים וביצירת תוכן. המטרה שלו היא לספק חוויה אלגנטית של סוכן לביצוע אינטראקציות עם שירותי ענן של נתונים ומסדי נתונים פופולריים בקוד פתוח.

איך תוספים פועלים

‫Gemini CLI הוא כלי שניתן להרחבה בקלות, ואפשר להוסיף לו כלים ויכולות חדשים באמצעות תוספים. ההתקנה של התוספים האלה פשוטה. אפשר לטעון אותם מכתובת URL ב-GitHub, מספרייה מקומית או ממאגר שניתן להגדרה. התוספים האלה מספקים מגוון רחב של יכולות, כולל כלים חדשים, פקודות סלאש והנחיות לייעול תהליך העבודה.

הגדרת Looker

מקבלים מזהה לקוח וסוד לקוח של Looker. פועלים לפי ההוראות בדף התיעוד בנושא אימות Looker API.
צריכה להיות לכם גישה לכתובת ה-URL הבסיסית של המופע ב-Looker. הוא כנראה ייראה כך: https://looker.example.com. במקרים מסוימים, ה-API מאזין ביציאה אחרת, ותצטרכו להשתמש ב-https://looker.example.com:19999 במקום זאת.

התקנת MCP Toolbox

מורידים את הגרסה האחרונה של MCP Toolbox כקובץ בינארי. בוחרים את הקובץ הבינארי שמתאים למערכת ההפעלה ולארכיטקטורת המעבד שלכם. חובה להשתמש ב-MCP Toolbox בגרסה V0.14.0 ואילך.

‫linux/amd64

curl -O https://storage.googleapis.com/genai-toolbox/v0.14.0/linux/amd64/toolbox

darwin/arm64

curl -O https://storage.googleapis.com/genai-toolbox/v0.14.0/darwin/arm64/toolbox

darwin/amd64

curl -O https://storage.googleapis.com/genai-toolbox/v0.14.0/darwin/amd64/toolbox

windows/amd64

curl -O https://storage.googleapis.com/genai-toolbox/v0.14.0/windows/amd64/toolbox.exe

הופכים את הקובץ הבינארי לקובץ הפעלה.
```
chmod +x toolbox
```
מאמתים את ההתקנה.
```
./toolbox --version
```

הגדרת לקוח ה-MCP

בקטע הזה מוסבר איך להגדיר כלי פיתוח שונים כדי להתחבר למופע Looker באמצעות MCP Toolbox for Databases. ערכת הכלים פועלת כשרת Model Context Protocol‏ (MCP) בקוד פתוח, שנמצא בין סביבת הפיתוח המשולבת (IDE) לבין מסד הנתונים, ומספק מישור בקרה מאובטח ויעיל לכלי ה-AI. בוחרים את הכרטיסייה של הכלי הספציפי כדי לראות את הוראות ההגדרה.

Gemini CLI
Gemini Code Assist
Claude code
Claude למחשב
‫Cline (תוסף ל-VS Code)
Cursor
קוד Visual Studio (Copilot)
‫Windsurf (Codium)

Gemini CLI

מתקינים את Gemini CLI.
מתקינים את התוסף Looker ל-Gemini CLI ממאגר GitHub באמצעות הפקודה הבאה:
```
gemini extensions install https://github.com/gemini-cli-extensions/looker
```
מגדירים משתני סביבה כדי להתחבר למופע Looker, ומחליפים את משתני הסביבה הבאים בערכים שלכם:
- ‫LOOKER_URL: כתובת ה-URL של מופע Looker.
- ‫CLIENT_ID ו-CLIENT_SECRET: מפתח ה-API שמשמש לגישה אל Looker API.
- ‫VERIFY_SSL: ‏true או false, בהתאם לשאלה אם משתמשים בהצפנת SSL כדי לחבר את מסד הנתונים למופע Looker.
```
export LOOKER_BASE_URL="LOOKER_URL"
export LOOKER_CLIENT_ID="CLIENT_ID"
export LOOKER_CLIENT_SECRET="CLIENT_SECRET"
export LOOKER_VERIFY_SSL="VERIFY_SSL"
```
מפעילים את Gemini CLI במצב אינטראקטיבי:
‫
```
gemini
```
ממשק ה-CLI טוען באופן אוטומטי את התוסף Looker ל-Gemini CLI ואת הכלים שלו, שבהם אפשר להשתמש כדי ליצור אינטראקציה עם מופע Looker.

Gemini Code Assist

מומלץ להגדיר את Gemini Code Assist לשימוש ב-Gemini CLI. הגישה הזו מייתרת את הצורך להגדיר שרת MCP באופן ידני.

מוודאים שהתקנתם והגדרתם את Gemini CLI ואת התוסף looker.
איך מגדירים את Gemini Code Assist לשימוש ב-Gemini CLI
מתחילים אינטראקציה עם מופע Looker באמצעות שפה טבעית ישירות בצ'אט של Gemini Code Assist.

Claude code

מתקינים את Claude Code.
יוצרים את הקובץ .mcp.json בתיקיית הבסיס של הפרויקט, אם הוא לא קיים.
מוסיפים את ההגדרה הבאה, מחליפים את משתני הסביבה הבאים בערכים שלכם ושומרים.
- ‫LOOKER_URL: כתובת ה-URL של מופע Looker.
- ‫CLIENT_ID ו-CLIENT_SECRET: מפתח ה-API שמשמש לגישה אל Looker API.
- ‫VERIFY_SSL: ‏true או false, בהתאם לשאלה אם משתמשים בהצפנת SSL כדי לחבר את מסד הנתונים למופע Looker.

      {
        "mcpServers": {
          "looker-toolbox": {
            "command": "./PATH/TO/toolbox",
            "args": ["--stdio", "--prebuilt", "looker"],
            "env": {
                "LOOKER_BASE_URL": "LOOKER_URL",
                "LOOKER_CLIENT_ID": "CLIENT_ID",
                "LOOKER_CLIENT_SECRET": "CLIENT_SECRET",
                "LOOKER_VERIFY_SSL": "VERIFY_SSL",
          }
          }
        }
      }

‫Claude למחשב

פותחים את Claude Desktop ועוברים אל הגדרות.
בכרטיסייה Developer (פיתוח), לוחצים על Edit Config (עריכת ההגדרות) כדי לפתוח את קובץ ההגדרות.
מוסיפים את ההגדרה הבאה, מחליפים את משתני הסביבה הבאים בערכים שלכם ושומרים.
- ‫LOOKER_URL: כתובת ה-URL של מופע Looker.
- ‫CLIENT_ID ו-CLIENT_SECRET: מפתח ה-API שמשמש לגישה אל Looker API.
- ‫VERIFY_SSL: ‏true או false, בהתאם לשאלה אם משתמשים בהצפנת SSL כדי לחבר את מסד הנתונים למופע Looker.

      {
        "mcpServers": {
          "looker-toolbox": {
            "command": "./PATH/TO/toolbox",
            "args": ["--stdio", "--prebuilt", "looker"],
            "env": {
                "LOOKER_BASE_URL": "LOOKER_URL",
                "LOOKER_CLIENT_ID": "CLIENT_ID",
                "LOOKER_CLIENT_SECRET": "CLIENT_SECRET",
                "LOOKER_VERIFY_SSL": "VERIFY_SSL",
          }
          }
        }
      }

מפעילים מחדש את Claude Desktop.
במסך הצ'אט החדש מוצג סמל של פטיש (MCP) עם שרת ה-MCP החדש.

קלין

פותחים את התוסף Cline ב-VS Code ולוחצים על הסמל MCP Servers.
לוחצים על Configure MCP Servers (הגדרת שרתי MCP) כדי לפתוח את קובץ ההגדרות.
מוסיפים את ההגדרה הבאה, מחליפים את משתני הסביבה הבאים בערכים שלכם ושומרים.
- ‫LOOKER_URL: כתובת ה-URL של מופע Looker.
- ‫CLIENT_ID ו-CLIENT_SECRET: מפתח ה-API שמשמש לגישה אל Looker API.
- ‫VERIFY_SSL: ‏true או false, בהתאם לשאלה אם משתמשים בהצפנת SSL כדי לחבר את מסד הנתונים למופע Looker.

      {
        "mcpServers": {
          "looker-toolbox": {
            "command": "./PATH/TO/toolbox",
            "args": ["--stdio", "--prebuilt", "looker"],
            "env": {
                "LOOKER_BASE_URL": "LOOKER_URL",
                "LOOKER_CLIENT_ID": "CLIENT_ID",
                "LOOKER_CLIENT_SECRET": "CLIENT_SECRET",
                "LOOKER_VERIFY_SSL": "VERIFY_SSL",
          }
          }
        }
      }

אחרי שהשרת מתחבר בהצלחה, מופיע סטטוס פעיל בצבע ירוק.

סמן

אם התיקייה .cursor לא קיימת, יוצרים אותה בתיקיית הבסיס של הפרויקט.
יוצרים את הקובץ .cursor/mcp.json אם הוא לא קיים, ופותחים אותו.
מוסיפים את ההגדרה הבאה, מחליפים את משתני הסביבה הבאים בערכים שלכם ושומרים.
- ‫LOOKER_URL: כתובת ה-URL של מופע Looker.
- ‫CLIENT_ID ו-CLIENT_SECRET: מפתח ה-API שמשמש לגישה אל Looker API.
- ‫VERIFY_SSL: ‏true או false, בהתאם לשאלה אם משתמשים בהצפנת SSL כדי לחבר את מסד הנתונים למופע Looker.

      {
        "mcpServers": {
          "looker-toolbox": {
            "command": "./PATH/TO/toolbox",
            "args": ["--stdio", "--prebuilt", "looker"],
            "env": {
                "LOOKER_BASE_URL": "LOOKER_URL",
                "LOOKER_CLIENT_ID": "CLIENT_ID",
                "LOOKER_CLIENT_SECRET": "CLIENT_SECRET",
                "LOOKER_VERIFY_SSL": "VERIFY_SSL",
          }
          }
        }
      }

פותחים את Cursor ועוברים אל Settings > Cursor Settings > MCP. כשמתבצע חיבור לשרת, מופיע סטטוס פעיל בצבע ירוק.

קוד Visual Studio ‏ (Copilot)

פותחים את VS Code ויוצרים את הספרייה .vscode ברמה הבסיסית של הפרויקט, אם היא לא קיימת.
יוצרים את הקובץ .vscode/mcp.json אם הוא לא קיים, ופותחים אותו.
מוסיפים את ההגדרה הבאה, מחליפים את משתני הסביבה הבאים בערכים שלכם ושומרים.
- ‫LOOKER_URL: כתובת ה-URL של מופע Looker.
- ‫CLIENT_ID ו-CLIENT_SECRET: מפתח ה-API שמשמש לגישה אל Looker API.
- ‫VERIFY_SSL: ‏true או false, בהתאם לשאלה אם משתמשים בהצפנת SSL כדי לחבר את מסד הנתונים למופע Looker.

      {
        "mcpServers": {
          "looker-toolbox": {
            "command": "./PATH/TO/toolbox",
            "args": ["--stdio", "--prebuilt", "looker"],
            "env": {
                "LOOKER_BASE_URL": "LOOKER_URL",
                "LOOKER_CLIENT_ID": "CLIENT_ID",
                "LOOKER_CLIENT_SECRET": "CLIENT_SECRET",
                "LOOKER_VERIFY_SSL": "VERIFY_SSL",
          }
          }
        }
      }

גלישת רוח

פותחים את Windsurf ועוברים אל Cascade assistant.
לוחצים על סמל ה-MCP ואז על Configure (הגדרה) כדי לפתוח את קובץ ההגדרות.
מוסיפים את ההגדרה הבאה, מחליפים את משתני הסביבה הבאים בערכים שלכם ושומרים.
- ‫LOOKER_URL: כתובת ה-URL של מופע Looker.
- ‫CLIENT_ID ו-CLIENT_SECRET: מפתח ה-API שמשמש לגישה אל Looker API.
- ‫VERIFY_SSL: ‏true או false, בהתאם לשאלה אם משתמשים בהצפנת SSL כדי לחבר את מסד הנתונים למופע Looker.

      {
        "mcpServers": {
          "looker-toolbox": {
            "command": "./PATH/TO/toolbox",
            "args": ["--stdio", "--prebuilt", "looker"],
            "env": {
                "LOOKER_BASE_URL": "LOOKER_URL",
                "LOOKER_CLIENT_ID": "CLIENT_ID",
                "LOOKER_CLIENT_SECRET": "CLIENT_SECRET",
                "LOOKER_VERIFY_SSL": "VERIFY_SSL",
          }
          }
        }
      }

שימוש בכלים מבוססי-AI

כלי ה-AI שלכם מחובר עכשיו ל-Looker באמצעות MCP. אפשר לבקש מהעוזר הדיגיטלי מבוסס ה-AI לפרט את המודלים, הניתוחים, המאפיינים והמדדים. אפשר גם להריץ שאילתה על ידי אחזור ה-SQL של שאילתה או על ידי הפעלת Look שנשמר.

הכלים הבאים זמינים ל-LLM:

כלי שאילתות ומודל Looker

הכלים האלה משמשים לקבלת מידע על מודל Looker ולהרצת שאילתות על המודל הזה.

‫get_models: רשימה של כל מודלי LookML במופע Looker.
‫get_explores: רשימת הניתוחים במודל נתון.
‫get_dimensions: הצגת המאפיינים ב'ניתוח נתונים' נתון.
‫get_measures: רשימת המדדים ב-Explore נתון.
‫get_filters: הצגת המסננים ב-Explore נתון.
‫get_parameters: רשימת הפרמטרים ב-Explore נתון.
‫query: מריצים שאילתה ומחזירים את הנתונים.
‫query_sql: מחזירה את ה-SQL שנוצר על ידי Looker עבור שאילתה.
‫query_url: מחזירה קישור לשאילתה ב-Looker כדי להמשיך בניתוח.

כלים לניהול תוכן ב-Looker

הכלים האלה שומרים תוכן (תצוגות ולוחות בקרה) ממופע Looker ויוצרים תוכן שמור חדש.

‫get_looks: החזרת המראה השמור שתואם לשם או לתיאור.
‫run_look: מריצים Look שמור ומחזירים את הנתונים.
‫make_look: יצירת Look שמור ב-Looker והחזרת כתובת ה-URL.
‫get_dashboards: החזרת לוחות הבקרה השמורים שתואמים לשם או לתיאור.
‫make_dashboard: יצירת מרכז בקרה שמור ב-Looker והחזרת כתובת ה-URL.
add_dashboard_element: הוספת אריח למרכז הבקרה.

כלי בדיקת תקינות של מכונת Looker

הכלים האלה מציעים את אותם אלגוריתמים לבדיקת תקינות שמוצעים בכלי הפופולרי Henry של CLI.

‫health_pulse: בדיקת תקינות של מופע Looker.
‫health_analyze: ניתוח השימוש באובייקט Looker.
‫health_vacuum: חיפוש רכיבי LookML שאולי לא נעשה בהם שימוש.

כלים לעריכה ב-LookML

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

‫dev_mode: הפעלה והשבתה של מצב פיתוח בסשן. כתיבת LookML חייבת להתבצע במצב פיתוח. שאילתות שמופעלות במצב פיתוח משתמשות ב-LookML ששונה, כך שאפשר לבדוק את ההשפעה של השינויים.
‫get_projects: קבלת רשימה של פרויקטים זמינים של LookML.
‫get_project_files: קבלת רשימת קובצי LookML בפרויקט.
‫get_project_file: קבלת התוכן של קובץ LookML.
‫create_project_file: יצירת קובץ LookML חדש.
‫update_project_file: שינוי קובץ LookML קיים.
‫delete_project_file: מחיקת קובץ LookML.
‫get_connections: קבלת רשימת החיבורים.
‫get_connection_schemas: קבלת רשימת הסכימות של חיבור.
‫get_connection_databases: קבלת רשימת מסדי הנתונים לחיבור.
‫get_connection_tables: קבלת רשימת הטבלאות של חיבור.
‫get_connection_table_columns: קבלת רשימת העמודות של טבלה בחיבור.