שימוש ב-Knowledge Catalog עם MCP,‏ Antigravity CLI וסוכנים אחרים

בדף הזה מוסבר איך לחבר את המכונה של Knowledge Catalog (לשעבר Dataplex Universal Catalog) לכלי למפתחים כמו Antigravity CLI. קישור של Knowledge Catalog לכלים האלה מאפשר לגלות נתונים ולנהל נכסים באמצעות AI ישירות בכלי.

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

כדי ליהנות מחוויית שימוש משולבת בשורת הפקודה, מומלץ להשתמש בפלאגין הייעודי של Knowledge Catalog ל-Antigravity CLI. הפלאגין כולל את המיומנויות הבסיסיות ישירות בתוכו, מה שמפשט את ההגדרה וההתאמה האישית.

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

במדריך הזה מוסבר איך לקשר את הכלים הבאים:

מידע על Antigravity CLI ועל פלאגינים

‫Antigravity CLI הוא סוכן AI בקוד פתוח בממשק שיחה מבית Google, שמאיץ את תהליכי הפיתוח ועוזר בתכנות, בניפוי באגים, בניתוח נתונים וביצירת תוכן. הוא מציע חוויה מבוססת-נציג לאינטראקציה עם שירותי Data Cloud, כמו Knowledge Catalog ומסדי נתונים פופולריים אחרים בקוד פתוח.

מידע נוסף על Antigravity CLI זמין במסמכי התיעוד של Antigravity CLI.

איך פלאגינים של Antigravity CLI פועלים?

הפלאגינים מרחיבים את היכולות של Antigravity CLI, ומאפשרים לו להתחבר לשירותים ספציפיים של Google Cloud ולכלים אחרים ולשלוט בהם. הם מספקים ל-Antigravity CLI הקשר והבנה של ה-API, ומאפשרים אינטראקציה באמצעות שיחה. אפשר לטעון פלאגינים של Antigravity CLI מכתובות URL של GitHub, מספריות מקומיות או ממרשמים. התוספים האלה מציעים מיומנויות חדשות, פקודות דרך שורת הפקודות והנחיות. הם נפרדים מהפלאגינים של סביבת הפיתוח המשולבת (IDE), כמו Antigravity Code Assist, שמשתלבים באמצעות MCP Toolbox.

אילו כלי MCP יש ב-Knowledge Catalog?

הפלאגין Knowledge Catalog ל-Antigravity CLI משלב AI במשימות של משילות מידע וגילוי נתונים. אתם יכולים להשתמש ב-Knowledge Catalog באמצעות הנחיות בשפה טבעית בטרמינל.

כדי לראות את כל המיומנויות הזמינות, עיינו במיומנויות של Knowledge Catalog ב-GitHub.

מידע נוסף על הפלאגין Knowledge Catalog זמין במאמר הפלאגין Antigravity CLI – ‏Knowledge Catalog.

התפקידים הנדרשים

כדי לקבל את ההרשאות שדרושות לחיבור ל-Knowledge Catalog באמצעות MCP Toolbox או הפלאגין של Antigravity CLI, בקשו מהאדמין להקצות לכם את התפקידים הבאים ב-IAM בפרויקט:

להסבר על מתן תפקידים, ראו איך מנהלים את הגישה ברמת הפרויקט, התיקייה והארגון.

התפקידים המוגדרים מראש האלה כוללים את ההרשאות שנדרשות כדי להתחבר ל-Knowledge Catalog באמצעות MCP Toolbox או הפלאגין של Antigravity CLI. כדי לראות בדיוק אילו הרשאות נדרשות, אפשר להרחיב את הקטע ההרשאות הנדרשות:

ההרשאות הנדרשות

כדי להתחבר ל-Knowledge Catalog באמצעות MCP Toolbox או הפלאגין של Antigravity CLI, נדרשות ההרשאות הבאות:

  • כדי להפעיל ממשקי API: serviceusage.services.enable
  • כדי להשתמש במיומנויות של Knowledge Catalog:
    • dataplex.projects.search
    • dataplex.entries.get
    • dataplex.aspectTypes.get
    • dataplex.aspectTypes.list

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

הפעלת Dataplex API

  1. נכנסים לדף לבחירת הפרויקט במסוף Google Cloud .

    כניסה לדף לבחירת הפרויקט

  2. בוחרים או יוצרים פרויקט ב- Google Cloud .

    התפקידים שנדרשים כדי לבחור או ליצור פרויקט

    • בחירת פרויקט: כדי לבחור פרויקט לא נדרש תפקיד IAM ספציפי – אתם יכולים לבחור כל פרויקט שקיבלתם בו תפקיד.
    • יצירת פרויקט: כדי ליצור פרויקט, צריך את התפקיד "יצירת פרויקטים" (roles/resourcemanager.projectCreator), שכולל את ההרשאה resourcemanager.projects.create. איך מקצים תפקידים?

  3. מוודאים שהחיוב מופעל בפרויקט ב- Google Cloud .

  4. מפעילים את Dataplex API, אם הוא עדיין לא מופעל.

    התפקידים שנדרשים כדי להפעיל ממשקי API

    כדי להפעיל ממשקי API, צריך את ההרשאה serviceusage.services.enable. אם יצרתם את הפרויקט, סביר להניח שכבר יש לכם את ההרשאה הזו דרך התפקיד "בעלים" (roles/owner). אחרת, תוכלו לקבל את ההרשאה הזו דרך התפקיד "אדמין בממשק 'שימוש בשירות'" (roles/serviceusage.serviceUsageAdmin). איך מקצים תפקידים

    להפעלת ה-API

  5. אם משתמשים במעטפת מקומית, צריך ליצור פרטי כניסה לאימות מקומי בחשבון המשתמש: 

    gcloud auth application-default login

    אם אתם משתמשים ב-Cloud Shell, אתם לא צריכים לעשות את זה.

    אם מוחזרת שגיאת אימות ואתם משתמשים בספק זהויות חיצוני (IdP), ודאו ש נכנסתם ל-CLI של gcloud באמצעות המאגר המאוחד לניהול זהויות.

התקנת MCP Toolbox

אם אתם מתכננים להשתמש רק ב-Antigravity Code Assist או בפלאגין Antigravity CLI, אתם לא צריכים להתקין את MCP Toolbox כי הם כוללים את יכולות השרת הנדרשות. בסביבות פיתוח משולבות ובכלים אחרים, פועלים לפי השלבים שבקטע הזה כדי להתקין את MCP Toolbox.

  1. מורידים את הגרסה העדכנית של MCP Toolbox כקובץ בינארי. בוחרים את הגרסה הבינארית של MCP Toolbox שמתאימה למערכת ההפעלה ולארכיטקטורת המעבד (CPU). צריך להשתמש ב-MCP Toolbox מגרסה v0.31.0 ואילך.

    Linux/amd64

    curl -O https://storage.googleapis.com/mcp-toolbox-for-databases/VERSION/linux/amd64/toolbox

    מחליפים את VERSION בגרסה של MCP Toolbox, לדוגמה v0.31.0.

    macOS (Darwin)/arm64

    curl -O https://storage.googleapis.com/mcp-toolbox-for-databases/VERSION/darwin/arm64/toolbox

    מחליפים את VERSION בגרסה של MCP Toolbox, לדוגמה v0.31.0.

    macOS (Darwin)/amd64

    curl -O https://storage.googleapis.com/mcp-toolbox-for-databases/VERSION/darwin/amd64/toolbox

    מחליפים את VERSION בגרסה של MCP Toolbox, לדוגמה v0.31.0.

    Windows/amd64

    curl -O https://storage.googleapis.com/mcp-toolbox-for-databases/VERSION/windows/amd64/toolbox

    מחליפים את VERSION בגרסה של MCP Toolbox, לדוגמה v0.31.0.

  2. הופכים את הקובץ הבינארי לקובץ הפעלה:

    chmod +x toolbox

  3. מאמתים את ההתקנה:

    ./toolbox --version

    אם ההתקנה הצליחה, יוחזר מספר הגרסה, לדוגמה, 0.15.0.

הגדרת לקוחות וחיבורים

בקטע הזה מוסבר איך לחבר את Knowledge Catalog לכלים שלכם.

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

פלאגין Antigravity CLI

בשיטה הזו משתמשים בפלאגין knowledge-catalog לכלי העצמאי Antigravity CLI, ולא ב-MCP Toolbox.

  1. מתקינים את Antigravity CLI.

  2. מתקינים את הפלאגין Knowledge Catalog ל-Antigravity CLI מהמאגר ב-GitHub:

    agy plugin install https://github.com/gemini-cli-extensions/knowledge-catalog

  3. מגדירים את משתנה הסביבה כדי להתחבר לפרויקט ב-Knowledge Catalog:

    export DATAPLEX_PROJECT=PROJECT_ID

    מחליפים את PROJECT_ID במזהה הפרויקט ב- Google Cloud.

  4. מפעילים את Antigravity CLI במצב אינטראקטיבי:

    agy

    ה-CLI טוען באופן אוטומטי את הפלאגין של Knowledge Catalog ואת המיומנויות שלו, שבהם אתם יכולים להשתמש כדי לקיים אינטראקציה עם מסד הנתונים.

  5. ב-Antigravity CLI, משתמשים בפקודה /mcp כדי לוודא שהפלאגין מותקן.

Antigravity Code Assist

‫Antigravity Code Assist כולל את יכולות השרת הנדרשות של MCP, כך שלא צריך להתקין את MCP Toolbox בנפרד.

  1. ב-VS Code, מתקינים את התוסף Antigravity Code Assist.
  2. מפעילים את מצב סוכן בצ'אט של Antigravity Code Assist.
  3. בספריית העבודה, יוצרים תיקייה בשם .antigravity. בתיקייה הזו, יוצרים קובץ settings.json.

  4. מוסיפים את ההגדרות הבאות:

    {
  "mcpServers": {
    "knowledgeCatalog": {
      "command": "./PATH/TO/toolbox",
      "args": ["--prebuilt","dataplex","--stdio"],
      "env": {
        "DATAPLEX_PROJECT": "PROJECT_ID"
      }
    }
  }
}

    מחליפים את PROJECT_ID במזהה הפרויקט ב- Google Cloud.

  5. שומרים את ההגדרה.

Claude Code

  1. מתקינים את Claude Code.

  2. מגדירים את משתנה הסביבה כדי להתחבר לפרויקט ב-Knowledge Catalog:

    export DATAPLEX_PROJECT=PROJECT_ID

    מחליפים את PROJECT_ID במזהה הפרויקט ב- Google Cloud.

  3. מפעילים את הסוכן:

    claude

  4. מתקינים את הפלאגין:

    /plugin install knowledge-catalog@claude-plugins-official

Codex

כדי להשתמש ב-Knowledge Catalog ב-Codex, צריך להגדיר חיבור לשרת MCP בהגדרות של Codex כדי להריץ את MCP Toolbox:

  1. מגדירים את משתנה הסביבה כדי להתחבר לפרויקט ב-Knowledge Catalog:

    export DATAPLEX_PROJECT=PROJECT_ID

    מחליפים את PROJECT_ID במזהה הפרויקט ב- Google Cloud.

  2. בהגדרות של Codex MCP, מוסיפים את השרת באמצעות MCP Toolbox:

    {
  "mcpServers": {
    "knowledgeCatalog": {
      "command": "./PATH/TO/toolbox",
      "args": ["--prebuilt","dataplex","--stdio"],
      "env": {
        "DATAPLEX_PROJECT": "PROJECT_ID"
      }
    }
  }
}

    מחליפים את PROJECT_ID במזהה הפרויקט ב- Google Cloud.

Claude במחשב

  1. פותחים את Claude Desktop ועוברים אל הגדרות.
  2. כדי לפתוח את קובץ התצורה, עוברים לכרטיסייה Developer ולוחצים על Edit config.

  3. מוסיפים את ההגדרות הבאות:

    {
  "mcpServers": {
    "knowledgeCatalog": {
      "command": "./PATH/TO/toolbox",
      "args": ["--prebuilt","dataplex","--stdio"],
      "env": {
        "DATAPLEX_PROJECT": "PROJECT_ID"
      }
    }
  }
}

    מחליפים את PROJECT_ID במזהה הפרויקט ב- Google Cloud.

  4. שומרים את ההגדרה.

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

Cline

  1. ב-VS Code, פותחים את התוסף Cline ולוחצים על הסמל שרתי MCP.
  2. כדי לפתוח את קובץ התצורה, לוחצים על הגדרת שרתי MCP.

  3. מוסיפים את ההגדרות הבאות:

    {
  "mcpServers": {
    "knowledgeCatalog": {
      "command": "./PATH/TO/toolbox",
      "args": ["--prebuilt","dataplex","--stdio"],
      "env": {
        "DATAPLEX_PROJECT": "PROJECT_ID"
      }
    }
  }
}

    מחליפים את PROJECT_ID במזהה הפרויקט ב- Google Cloud.

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

סמן

  1. אם הספרייה .cursor לא קיימת בתיקיית הבסיס של הפרויקט, יוצרים אותה.
  2. יוצרים את הקובץ .cursor/mcp.json אם הוא לא קיים, ופותחים אותו.

  3. מוסיפים את ההגדרות הבאות:

    {
  "mcpServers": {
    "knowledgeCatalog": {
      "command": "./PATH/TO/toolbox",
      "args": ["--prebuilt","dataplex","--stdio"],
      "env": {
        "DATAPLEX_PROJECT": "PROJECT_ID"
      }
    }
  }
}

    מחליפים את PROJECT_ID במזהה הפרויקט ב- Google Cloud.

  4. שומרים את ההגדרה.

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

‫VS Code‏ (Copilot)

  1. פותחים את VS Code ויוצרים את הספרייה .vscode ברמה הבסיסית (root) של הפרויקט, אם היא לא קיימת.
  2. יוצרים את הקובץ .vscode/mcp.json אם הוא לא קיים, ופותחים אותו.

  3. מוסיפים את ההגדרות הבאות:

    {
  "servers": {
    "knowledgeCatalog": {
      "command": "./PATH/TO/toolbox",
      "args": ["--prebuilt","dataplex","--stdio"],
      "env": {
        "DATAPLEX_PROJECT": "PROJECT_ID"
      }
    }
  }
}

    מחליפים את PROJECT_ID במזהה הפרויקט ב- Google Cloud.

  4. שומרים את ההגדרה.

גלישת רוח

  1. פותחים את Windsurf ועוברים אל הגדרות Cascade.
  2. כדי לפתוח את קובץ התצורה, לוחצים על סמל ה-MCP ואז על Configure (הגדרה).

  3. מוסיפים את ההגדרות הבאות:

    {
  "mcpServers": {
    "knowledgeCatalog": {
      "command": "./PATH/TO/toolbox",
      "args": ["--prebuilt","dataplex","--stdio"],
      "env": {
        "DATAPLEX_PROJECT": "PROJECT_ID"
      }
    }
  }
}

    מחליפים את PROJECT_ID במזהה הפרויקט ב- Google Cloud.

  4. שומרים את ההגדרה.

שימוש במיומנויות

העוזר האישי מבוסס ה-AI מחובר עכשיו ל-Knowledge Catalog. נסו לבקש מהעוזר האישי מבוסס-AI למצוא נכסי נתונים כמו מערכי נתונים ב-BigQuery, מכונות של Cloud SQL ועוד.

כדי לראות את כל המיומנויות הזמינות, עיינו במיומנויות של Knowledge Catalog ב-GitHub.

אופציונלי: הוספת הוראות למערכת

הוראות למערכת הן דרך לתת הנחיות ספציפיות למודל ה-LLM, כדי לעזור לו להבין את ההקשר ולענות בצורה מדויקת יותר. מגדירים את הוראות המערכת לפי ההנחיה המומלצת למערכת.

לדוגמה, אתם יכולים להוסיף הוראות שמסבירות ל-LLM איך להשתמש במיומנויות של Knowledge Catalog:

  • כשמבקשים ממך למצוא מערכי נתונים או טבלאות, צריך להשתמש במיומנות search_entries.
  • אם אתם צריכים פרטים על סכימת הטבלה או על המטא-נתונים, כמו כללים לאיכות הנתונים או בעלות, השתמשו במיומנות lookup_entry.
  • כששואלים על כללי פיקוח או סיווגים, צריך להתחיל בשימוש ב-search_aspect_types כדי למצוא סוגי היבטים רלוונטיים.
  • אם כדי לענות על שאלות נדרשת קבוצה רחבה של מטא-נתונים, השתמשו במיומנות lookup_context כדי לאחזר אותם.

איך משתמשים בהוראות כדי לקבל עריכות מ-AI שמתאימות לסגנון התכנות שלכם

המאמרים הבאים