משאבי עזר

בדף הזה מוסבר איך להפנות Google Cloud למשאבי נתונים כשעובדים עם Google Cloud Data Agent Kit. אתם יכולים להפנות למשאבים בסביבת הפיתוח או בסוכן התכנות הנתמך באמצעות הפניה מפורשת או משתמעת, בהתאם לסביבה ולסוכן שבהם אתם משתמשים.

  • הפניה מפורשת. אתם מזהים משאב באופן מפורש בצ'אט או בממשק המשתמש, למשל על ידי הקלדת @RESOURCE_NAME, בחירת משאב מתפריט המשאבים של Model Context Protocol‏ (MCP) או שימוש בגרירה ושחרור.
  • הפניה משתמעת. אתם מפנים למשאב באמצעות הקשר בשפה טבעית בשיחה, למשל על ידי הקלדה של "this table" או "this dataset", בהתייחס למשאב הפתוח או הנבחר.

שיטות הפניה

אם סביבת הפיתוח וסוכן התכנות שלכם תומכים בהפניה, אתם יכולים להפנות למקורות נתונים בדרכים הבאות:

  • תיוגים ב-Chat: בממשקי צ'אט נתמכים, מקלידים @ ואחריו את שם המשאב או המזהה שלו (לדוגמה, @DATASET_NAME) כדי לצרף באופן מפורש את הקשר של המשאב לפרומפט.
  • תפריט משאבים של MCP: בוחרים משאב ישירות מבורר המשאבים של Model Context Protocol‏ (MCP) בסביבת הפיתוח המשולבת (IDE).
  • גרירה ושחרור: גוררים נכס נתונים מעץ הסייר ישירות לחלון הצ'אט או לחלון העריכה.
  • הפניה בשפה טבעית: בסביבות שתומכות בהפניה מרומזת, אפשר להשתמש בביטויים הקשריים כמו "this table" או "this dataset" כדי שהסוכן יסיק באופן אוטומטי את המשאב הפעיל.

בטבלה הבאה מתוארות שיטות ההפניה הנתמכות לכל סביבת פיתוח ולכל סוכן קידוד.

סביבת פיתוח או סוכן תיוג ב-Chat ‏ (@) תפריט המשאבים של MCP גרירה ושחרור שפה טבעית
VS Code (GitHub Copilot), ‏ Cursor, ‏ Antigravity IDE נתמך נתמך נתמך נתמך
‫Claude Code CLI (עצמאי) נתמך לא נתמך לא נתמך נתמך
‫Antigravity 2.0, ‏ Antigravity CLI, ‏ Claude Code (תוסף ל-VS Code) לא נתמך לא נתמך לא נתמך נתמך

משאבים נתמכים

בטבלה הבאה מפורט התחביר של ההפניות וביטויי השפה הטבעית למשאבים נתמכים Google Cloud בשירותים שונים.

  1. אפשר להשתמש גם בשם חלקי של הטבלה.
  2. ב-Claude Code CLI, משתמשים ב-@SESSION_ID.
  3. ב-Claude Code CLI, משתמשים ב-@BATCH_ID. אין תמיכה בהפניה משתמעת.
שירות משאב תחביר לתיוג בצ'אט (@) הפניה לשפה טבעית
BigQuery מערך נתונים1 @DATASET_NAME "this dataset"
  טבלה @TABLE_NAME "this table"
  הצגה @VIEW_NAME "this view"
‫AlloyDB ל-PostgreSQL, ‏ Cloud SQL, ‏ Spanner טבלה @TABLE_NAME "this table"
  הצגה @VIEW_NAME "this view"
Spark אשכול @CLUSTER_NAME "this cluster"
  זמן ריצה ללא שרת @RUNTIME_NAME "this runtime"
  משימה @JOB_NAME "this job"
  סשן אינטראקטיבי2 @SESSION_NAME "this session"
  Batch3 @BATCH_NAME לא נתמך

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