ייצוא היסטוריית השיחות ל-BigQuery

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

מגבלות

המגבלות הבאות חלות:

  • אפשר לייצא עד 500 פניות בכל שיחה.

הרשאות בפרויקטים שונים

אם הנציג שלכם ב-Dialogflow והנתונים ב-BigQuery לא נמצאים באותו פרויקט, חשבון השירות שמשויך לפרויקט Google Cloud ב-Dialogflow צריך גם את הרשאת ה-IAM‏ roles/bigquery.dataEditor למערך הנתונים ב-BigQuery בפרויקט Google Cloud ב-BigQuery.

פורמט חשבון השירות: service-<dialogflow-project-number>@gcp-sa-dialogflow.iam.gserviceaccount.com

למשתמש שמגדיר את הייצוא ב-Dialogflow צריכות להיות הרשאות בפרויקט ב-BigQuery. אם לא, הפרויקט ב-BigQuery לא יופיע כאפשרות במסוף Dialogflow.

ההרשאה המינימלית שנדרשת בפרויקט BigQuery כדי שהמשתמש יוכל לראות אותו ב-Dialogflow היא resourcemanager.projects.get. לחלופין, אתם יכולים להקצות אחד מה Google Cloud תפקידים המוגדרים מראש שכוללים את ההרשאה הזו, אבל לא דורשים שלמשתמש תהיה גישה למערך הנתונים ב-BigQuery: roles/browser או roles/bigquery.metadataViewer.

תיאור הטבלה

כל שורה בטבלה מכילה חלק אחד בשיחה, עם העמודות הבאות:

עמודה סוג תיאור
project_id מחרוזת מזהה הפרויקט.
agent_id מחרוזת המזהה של הסוכן.
conversation_name מחרוזת שם המשאב המלא של הסשן.
turn_position מספר שלם מספר התור בשיחה.
request_time TIMESTAMP השעה של החלק בשיחה.
language_code מחרוזת תג השפה.
בקשה JSON הבקשה לזיהוי כוונה.
תשובה JSON התגובה לזיהוי הכוונה.
partial_responses JSON מילוי חלקי, אם רלוונטי.
derived_data JSON מטא-נתונים נוספים על החלק הזה בשיחה.
conversation_signals JSON נתוני ניתוח שקשורים ל-NLU. סכימת ה-JSON מפורטת במאמר ConversationSignals.
bot_answer_feedback JSON משוב על התשובה, אם יש כזה.

הגדרות אישיות

כדי להגדיר ייצוא של היסטוריית השיחות:

  1. מוודאים שהיסטוריית השיחות מופעלת.
  2. פועלים לפי המדריך ליצירת קבוצת נתונים ב-BigQuery כדי ליצור קבוצת נתונים. שימו לב לשם של מערך הנתונים, כי תצטרכו אותו בשלב הבא.
  3. כדי ליצור טבלה עם הגדרת סכימה של SQL, פועלים לפי המדריך ליצירת טבלה ב-BigQuery. כדי ליצור את הטבלה, משתמשים בהצהרת ה-SQL הבאה:

    CREATE TABLE <your_dataset_name>.dialogflow_bigquery_export_data(
      project_id STRING,
      agent_id STRING,
      conversation_name STRING,
      turn_position INTEGER,
      request_time TIMESTAMP,
      language_code STRING,
      request JSON,
      response JSON,
      partial_responses JSON,
      derived_data JSON,
      conversation_signals JSON,
      bot_answer_feedback JSON
    );
    
  4. מגדירים את הגדרות הנציג כדי להפעיל את BigQuery Export, ומספקים את השמות של קבוצת הנתונים והטבלה שיצרתם למעלה.