ה-API של Analytics שיחותי הוא כלי רב עוצמה שמאפשר לכם לשלוח שאילתות לגבי הנתונים שלכם בשפה טבעית. בדף הזה מפורטות הנחיות לגבי פורמט של שאלות יעילות לקבלת הפלט האידיאלי. בדף הזה מפורטות שיטות מומלצות לפעולות הבאות:
- לשאול שאלות כלליות
- שאלות מורכבות עם כמה חלקים לניתוחים מורכבים יותר
- שאלות עם תנאים לנתונים
- בקשה לצבירת נתונים
- שליחת שאלות המשך
- בקשה לקבלת תוצאות בפורמט מסוים
לשאול שאלות כלליות
כששואלים שאלות כלליות, חשוב להיות ספציפיים ולספק הקשר. במקום לשאול שאלות כלליות, כדאי לצמצם את היקף החיפוש על ידי הוספת פרטים רלוונטיים, כמו תאריכים, קטגוריות ספציפיות או מסננים מספריים.
סוכן נתונים שמשתמש במקור נתונים של Looker עשוי לשאול שאלות המשך כדי להבהיר אי-בהירויות בשאילתה המקורית. לדוגמה, אם יש כמה שדות עם שמות דומים, סוכן הנתונים עשוי לבקש ממך להבהיר איזה שדה הכי מתאים לשימוש בעיבוד השאילתה שלך. השאלות האלה יופיעו בתשובה נדרשת הבהרה.
דוגמה
השאלה המקורית: "כמה חשבוניות נוצרות באופן ידני ובאופן שיטתי בכל שנה?"
שאלה מנוסחת מחדש: "תספק ספירה של חשבוניות שנוצרו באופן ידני ושיטתי בכל שנה. בהנחה שלוקח 15 דקות ליצור חשבונית ידנית אחת, חשב גם את הזמן הכולל שלוקח בשעות לעבד את כל החשבוניות הידניות וספק סיכום של הזמן הזה".
למה זה עובד: השאלה המדויקת יותר מוסיפה דרישה ספציפית לחישוב (הזמן שהושקע בהפקת חשבוניות ידניות) ומציינת פורמט פלט, סיכום.
שואלים שאלות מורכבות שמורכבות מכמה חלקים כדי לקבל ניתוחים מורכבים יותר
כדי לעזור ל-API של ניתוח נתונים שיחותיים לעבד כל רכיב בצורה מדויקת, כדאי לפצל שאלות מורכבות לכמה חלקים.
דוגמה
השאלה המקורית: "What is the average turnaround time in days of cash upon delivery and payment clearing for each receivable type (PHA, co-op rebate, credit card, retail media) and what percentage of these are manual clearings? בהנחה שאנחנו משקיעים 15 דקות בכל חשבון לקבלת תשלום שמנוקה באופן ידני, כמה זמן אנחנו משקיעים באפליקציית ניהול התזרים ובניקוי של כל סוג של חשבון לקבלת תשלום בכל שנה?"
שאלה מנוסחת מחדש, חלק 1: "מהו זמן הטיפול הממוצע בימים עבור כל סוג של חשבון לקבל בין 05.05.2025 ל-01.06.2025?"
שאלה מנוסחת מחדש, חלק 2: "What percentage of clearings are manual clearings between 2025-05-05 and 2025-06-01 for each receivable type?"
שאלה מנוסחת מחדש, חלק 3: "בהנחה שאנחנו משקיעים 15 דקות בכל תקבול שמסולק באופן ידני, כמה זמן אנחנו משקיעים באפליקציית התשלומים ובסליקה של כל סוג תקבול בכל שנה?"
למה זה עובד: כששואלים את השאלות בנפרד, Conversational Analytics API יכול להתייחס לכל מדד ספציפי (זמן ממוצע לטיפול, אחוז ההעברות לטיפול ידני, סך הזמן שהוקדש) עם המסננים המתאימים, וכך להשיג תוצאה מדויקת יותר.
שאלות עם תנאי נתונים
כששואלים שאלות עם תנאי נתונים, חשוב לציין בבירור את כל המסננים והתנאים הנדרשים בשאלה, כולל תאריכים מדויקים, מגבלות מספרים וקטגוריות ספציפיות. מוודאים שממשק Conversational Analytics API מחיל את המסננים הנכונים (לדוגמה, טווחי תאריכים, התוצאות המובילות, קטגוריות ספציפיות).
דוגמאות
השאלות הבאות מציינות נכון את קריטריוני הסינון:
"Show me the invoice date from 2025-05-02 until 2025-06-03 along with the respective average age of outstanding invoices only." (הצגת תאריך החשבונית מ-2025-05-02 עד 2025-06-03 יחד עם הגיל הממוצע של חשבוניות פתוחות בלבד). בשאלה הזו מצוין בבירור טווח התאריכים.
"צריך לציין את שם הלקוח, סכום היתרה לתשלום, הגיל הממוצע וסוג החשבון של הרשומות שהגיל שלהן הוא מעל 46 ימים. הגבלת התוצאות ל-5 רשומות לכל היותר לפי יתרת חובה". בשאלה הזו מצוין גיל הרשומה, מוגדרת מגבלה ומפורטות דרישות המיון.
"תציג את התחומים המובילים לפי סכום השונות ביתרות של לקוחות חייבים, יחד עם הסכומים ל-2025FP1 לעומת סוף השנה הקודמת". בשאלה הזו מצוין המונח 'התעשיות המובילות' והתקופות להשוואה.
בקשה לצבירת נתונים
כששואלים שאלות כדי לצבור נתונים, צריך לציין את סוג הצבירה (לדוגמה, 'סכום היתרה לתשלום' או 'גיל ממוצע') ואת המאפיינים שלפיהם רוצים לצבור את הנתונים (לדוגמה, 'שם הלקוח', 'סוג החוב' או 'תחום').
דוגמה
השאלה הבאה מציינת בצורה יעילה דרישות ברורות לצבירת נתונים:
"צריך לציין את שם הלקוח, סכום היתרה לתשלום, הגיל הממוצע וסוג החוב עבור הרשומות שהגיל שלהן מעל 46 ימים".
שליחת שאלות המשך
כששואלים שאלת המשך, כדאי להתייחס להקשר שנוצר קודם, אבל להסביר במפורש על שינויים או תוספות. לדוגמה, אם רוצים לשנות טווח תאריכים או מגבלה, צריך לציין בבירור את הפרמטרים החדשים.
דוגמאות
השאלה המקורית: "תספק את שם הלקוח, סכום היתרה, הגיל הממוצע וסוג החשבון של הרשומות שהגיל שלהן הוא מעל 46 ימים. הגבלת התוצאות ל-5 רשומות לכל היותר לפי יתרת חובה".
שאילתת המשך: "ספק את המדדים הקודמים עבור רשומות בנות למעלה מ-90 יום והגבל עד 10 הרשומות המובילות."
למה זה עובד: שאלת ההמשך מציינת בבירור את השינויים במסנן 'התיישנות מעבר' ואת מגבלת התוצאות, תוך התייחסות לאותם מדדים כמו בשאלה הקודמת כדי לספק הקשר.
בקשה לקבלת תוצאות בפורמט מסוים
כששואלים שאלה שלא מצוין בה פורמט תוצאות, Conversational Analytics API קובע את הפורמט שהכי מתאים לקריטריונים הספציפיים ולמונחי המפתח שמופיעים בשאלה.
כדי לקבל תוצאות בפורמטים הבאים, אפשר לכלול מונחים מרכזיים בשאלה ששולחים ל-Conversational Analytics API:
איך משתמשים ב-Conversational Analytics API כדי לקבל תוצאות בטבלה
השאלה הבאה מרמזת שהתוצאות צריכות להיות מוחזרות בפורמט טבלה, כי היא מציינת שמות של עמודות של מאפיינים וערכים:
"צריך לציין את שם הלקוח, סכום היתרה לתשלום, הגיל הממוצע וסוג החוב עבור הרשומות שהגיל שלהן מעל 46 ימים".
איך מכוונים את Conversational Analytics API להחזרת תוצאות כטקסט
שימוש במונחי מפתח כמו 'סיכום', או שאילת שאלה שדורשת רק תשובה פשוטה, עוזרים לממשק ה-API של ניתוח נתונים שיחותי לספק תוצאות כטקסט.
השאלות הבאות מרמזות שהתוצאות צריכות להיות מוחזרות כפלט טקסט:
"חשב וספק סיכום של הזמן הכולל שלקח לעבד את כל החשבוניות הידניות, בשעות".
"What is the total time taken to process manual invoices in the past week?"
איך מנחים את Conversational Analytics API להחזיר תוצאות כתרשים קו
שימוש במונחי מפתח כמו 'מגמה', 'שינוי' או 'שינוי דלתא' בשאלה עוזר ל-Conversational Analytics API לספק תוצאות כתרשים קו.
השאלות הבאות מרמזות שהתוצאות צריכות להיות מוצגות בתרשים קו:
"מהי המגמה החודשית של יתרות הסיום בכל ענף בשנת 2024".
"מהו השינוי היומי בדלתא של הגיל הממוצע של חשבוניות שלא שולמו ביום בהשוואה ליום הקודם בין התאריכים 2025-05-02 ו-2025-06-03?"
איך מנחים את Conversational Analytics API להחזיר תוצאות כתרשים עמודות או כתרשים השוואה
שימוש במונחי מפתח כמו 'השוואה' ו'שונות' עוזר ל-Conversational Analytics API לספק תוצאות כתרשים עמודות או כתרשים השוואה.
השאלה הבאה מרמזת שהתוצאות צריכות להיות מוצגות בתרשים עמודות או בתרשים השוואה:
"תספק את התעשיות המובילות לפי סכום השונות ביתרות של לקוחות חייבים, יחד עם הסכומים ל-2025FP1, לעומת סוף השנה הקודמת".
התוצאות של השאלה הזו יוצגו בתרשים עמודות שבו מוצג השונות בכל ענף.
מקורות מידע נוספים
טיפים נוספים לפתרון בעיות ותשובות לשאלות נפוצות זמינים בדף שאלות נפוצות על Conversational Analytics API.
מידע נוסף על שגיאות ב-API ופתרונות אפשריים זמין במדריך פתרון בעיות בשגיאות ב-Conversational Analytics API.