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

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

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

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

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

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

• ‫Gemini CLI (באמצעות תוסף)
• Gemini Code Assist
• Claude Code
• Claude למחשב
• Codex
• ‫Cline (תוסף ל-VS Code)
• Cursor
• ‫Visual Studio Code (Copilot)
• ‫Windsurf (לשעבר Codeium)

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

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

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

איך פועלים התוספים ל-Gemini CLI?

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

אילו כלים של MCP מספק Knowledge Catalog?

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

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

מידע נוסף על התוסף Knowledge Catalog זמין במאמר תוסף ל-Gemini CLI – Knowledge Catalog.

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

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

• כדי להפעיל ממשקי API: אדמין של שימוש בשירות (roles/serviceusage.serviceUsageAdmin)
• כדי להשתמש במיומנויות של Knowledge Catalog: Dataplex Catalog Viewer (roles/dataplex.catalogViewer)

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

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

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

כדי להתחבר ל-Knowledge Catalog באמצעות MCP Toolbox או התוסף ל-Gemini 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 פרויקט.

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

   • Select a project (בחירת פרויקט): כדי לבחור פרויקט לא צריך תפקיד IAM ספציפי – אפשר לבחור כל פרויקט שהוקצה לכם בו תפקיד.
   • יצירת פרויקט: כדי ליצור פרויקט, צריך את התפקיד Project Creator (יצירת פרויקטים) (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

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

התקנה של MCP Toolbox

אם אתם מתכננים להשתמש רק ב-Gemini Code Assist או בתוסף ל-Gemini CLI, אתם לא צריכים להתקין את MCP Toolbox, כי הוא כולל את היכולות הנדרשות של השרת. כדי להתקין את MCP Toolbox בסביבות פיתוח משולבות (IDE) ובכלים אחרים, צריך לפעול לפי השלבים שבקטע הזה.