בעזרת QueryData אתם יכולים לקיים אינטראקציה עם נתוני תרשים המאפיינים במסד הנתונים של Spanner באמצעות שפה טבעית, וליצור סוכנים לאינטראקציה עם נתונים. הכלי QueryData יוצר שאילתות ב-Graph Query Language (GQL) משאלות בשפה טבעית, על סמך הסכימה של תרשימי המאפיינים. כדי לשפר את הדיוק בתרחישים לדוגמה, אתם יכולים גם לספק קבוצות הקשר – אוסף של תבניות שאילתות, מאפייני שאילתות וחיפושי ערכים שמתעדים את הלוגיקה העסקית הספציפית לדומיין ואת השאלות שהמשתמשים שואלים. מידע נוסף על קבוצות הקשרים זמין במאמר סקירה כללית בנושא קבוצות הקשרים.
מתי להשתמש ב-QueryData
QueryData ל-Spanner Graph מתאים במיוחד לאפליקציות כמו:
- עוזרים אישיים בממשק שיחה על נתוני תרשים: עוזר אישי לתמיכה או האסיסטנט של Analytics עונה על השאלה "האם כסף שנשלח מחשבון 7 חזר אליו תוך 60 יום?" על ידי כך ש-QueryData יוצר ומריץ את שאילתת ה-GQL עם מספר הדילוגים.
- עוזרים דיגיטליים לחקירת הונאות, סיכונים ותאימות: מנתחים בודקים רשתות בעלות והעברה באמצעות שאלות המשך, וקבוצת הקשר שומרת על עקביות של מונחים כמו העברה בסיכון גבוה בכל התשובות.
- סוכני הסקת מסקנות מ-Knowledge Graph: סוכנים שנוצרו באמצעות ADK או לקוח MCP קוראים ל-QueryData ככלי לביסוס הסקת המסקנות שלהם על הקשרים ששמורים בתרשים, כמו החשבונות שאדם מסוים שולט בהם באמצעות מתווכים.
מושגי ליבה
כדי לתרגם באופן מהימן שאלות בשפה טבעית לשאילתות GQL, QueryData מסתמך על המושגים המרכזיים הבאים:
QueryData ו-Conversational Analytics API
נקודת הקצה QueryData ב-Conversational Analytics API היא כלי סוכני שמאפשר ליצור שאילתות פרוגרמטיות בשפה טבעית ל-GQL (NL2GQL) בשביל תרשימי הנכסים במסד הנתונים ב-Spanner. באפליקציה לשיחות או ב-Agentic Workflows, נקודת הקצה QueryData מטפלת בפירוש הסכימה ובסינתזת השאילתות של תרשימי המאפיינים שאתם מפרטים בשדה graph_ids של כל בקשה. מעטפת האג'נטית (כמו Antigravity, ערכת פיתוח הסוכנים (ADK) או LangChain) מנהלת את היסטוריית השיחות, את מצב המשתמש ואת תזמור הכלים כדי להוסיף הקשר לקלט של המשתמש לפני שליחת בקשה בשפה טבעית לנקודת הקצה (endpoint) של QueryData.
קבוצות הקשרים
קבוצת הקשר היא אוסף של ידע ספציפי למסד נתונים, מבני שאילתות שנבחרו בקפידה וכללים עסקיים שמשויכים למסד הנתונים. במקום להסתמך רק על הידע הכללי של ה-LLM או על הסכימה הגולמית של תרשים הנכסים, QueryData משתמש בקבוצות הקשר כדי להבין את הניואנסים של מודל התרשים והטרמינולוגיה הספציפית לארגון, כמו מה שנחשב בעסק שלכם להעברה בסיכון גבוה בתרשים פיננסי בנקאי. הדוגמאות במדריך הזה משתמשות בסכמת תרשים המאפיינים FinGraph ובמערך הנתונים לדוגמה. כדי ליצור את הסכימה של FinGraph ולהוסיף את הנתונים לדוגמה, קראו את המאמר הגדרה ושליחת שאילתות ב-Spanner Graph.
קבוצת הקשרים מכילה שלוש אבני בניין עיקריות:
- תבניות של שאילתות: צמדים של שאלות מייצגות בשפה טבעית ושאילתות GQL תואמות שאומתו מראש. התבניות מספקות דוגמאות קנוניות שמגדירות איך כוונות עסקיות ספציפיות ממופות להצהרות GQL (לדוגמה, איך השאלה "אילו חשבונות קיבלו העברות מהחשבון של דנה?" ממופה לשאילתת
GRAPH FinGraph MATCHשעוברת דרך קצוות שלOwnsו-Transfers). - היבטים של שאילתות: סעיפי GQL שניתן לעשות בהם שימוש חוזר (כמו תבניות גרפים, תנאי סינון, טווחי תאריכים, ספי סכומים או תנאים עסקיים כמו חשבונות חסומים). היבטים מאפשרים ל-QueryData לשלב באופן דינמי כמה קריטריונים של סינון בשאילתה, בלי צורך בתבניות נפרדות לכל שילוב.
- חיפושי ערכים: שאילתות סמנטיות ושאילתות של התאמת מחרוזות, שנכתבות כהצהרות
SELECTמעלGRAPH_TABLE, שמבססות ביטויי ערכים בשאלה של המשתמש על הערכים המדויקים שמאוחסנים במאפייני הצומת והקצה. חיפושי ערכים עוזרים לפתור אי-בהירויות (לדוגמה, מיפוי של "יום גשום" לכינוי החשבוןRainy Day Fund, או של "צ'כיה" לערך המאוחסןCzech_Republic) באמצעות התאמות מדויקות, דמיון בין מחרוזות או הטמעות וקטורים סמנטיות.
איך QueryData פועל
כשהנציג או האפליקציה שולחים בקשה בשפה טבעית (למשל, שאלה של משתמש שהנציג הוסיף לה הקשר באמצעות היסטוריית השיחות או מצב המשתמש), QueryData מבצע את השלבים הבאים:
- רזולוציית ערכים: QueryData מריץ שאילתות חיפוש ערכים במסד הנתונים של Spanner כדי למפות ביטויי ערכים בהנחיה (כמו שם של אדם, כינוי של חשבון או מדינה) לערכי מאפיינים ספציפיים של צמתים וקצוות.
- התאמת כוונה והפגת עמימות: QueryData מתאים את הבקשה לפי ההקשר לתבניות השאילתות ולמאפיינים שהגדרתם בקבוצת ההקשר. אם הבקשה לא מוגדרת מספיק או מעורפלת, QueryData יכול להחזיר שאלה להפגת העמימות כדי שהנציג או האפליקציה יוכלו לבקש מהמשתמש הבהרה.
- סינתזת שאילתות: באמצעות הסכימה של תרשימי המאפיינים שמפורטים ב-
graph_ids, מבנה התבנית התואם, המאפיינים שהוחלו והערכים שנפתרו, QueryData מסנתז שאילתת GQL מלאה. - הרצת השאילתה: שאילתת ה-GQL שנוצרה מורצת במסד הנתונים של Spanner כדי להחזיר תוצאות.
יצירה וניהול של קבוצות הקשרים
כדי ליצור ולנהל קבוצות הקשר:
- הקשר של המחבר: מגדירים את תבניות השאילתות, ההיבטים וחיפושי הערכים של תרשים הנכס. מידע נוסף זמין במאמר סקירה כללית בנושא קבוצות הקשר. אתם יכולים גם להשתמש בסוכן עם מנוע תלוי הקשר כדי ליצור הקשר באופן אוטומטי.
- ניהול ב- Google Cloud Console: אתם יכולים ליצור ולנהל קבוצות הקשר ב-Spanner Studio כדי שיהיו זמינות ליצירת שאילתות.
- שילוב עם האפליקציות שלכם: אתם יכולים לקשר את האפליקציות או את סוכני ה-AI שלכם ל-QueryData באמצעות קריאות ישירות ל-API בארכיטקטורת REST, עם תרשימי המאפיינים של נכסי היעד שמפורטים ב-
graph_ids.
המאמרים הבאים
- מידע על קבוצות הקשר ב-Spanner Graph
- איך בודקים את QueryData ב-Spanner Graph
- פועלים לפי ההוראות במדריך כדי לשלב את QueryData באפליקציה.