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

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

מגבלות

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

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

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

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

פורמט של חשבון שירות: 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 ולספק את השמות של מערך הנתונים והטבלה שנוצרו למעלה.

הקודם
רישום ביומן Cloud
הבא
היסטוריית שינויים