הגדרת הרישום ביומן של השיחות

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

לפני שמתחילים

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

  1. בפרויקט ב- Google Cloud , מפעילים את ממשקי ה-API הנדרשים ל-Conversational Analytics API ול-BigQuery.
  2. מוודאים שיש לכם את התפקידים הנדרשים בניהול זהויות והרשאות גישה (IAM).
  3. מוודאים שיש לכם סוכן לאינטראקציה עם נתונים שמקורות הנתונים שלו מפנים לטבלאות ב-BigQuery. בקטע מגבלות מפורטות הגדרות של סוכנים שלא נרשמות ביומן.
  4. מתכננים קבוצת נתונים ב-BigQuery בפרויקט של הסוכן לאינטראקציה עם נתונים, שמכילה רק את היומנים. כל הסוכנים לאינטראקציה עם נתונים בפרויקט משתפים סוכן שירות אחד, ומערך נתונים ייעודי מגביל את הרשאת הכתיבה שלו ליומנים.
  5. להחליט מי יכול לקרוא את היומנים. היומנים מכילים את השאלות המלאות של המשתמשים ואת התשובות של הנציג. אם המשתמשים מתכתבים בצ'אט עם הנציג דרך האפליקציה שלכם, אתם אחראים לכל ההודעות, ההודעות לגילוי נאות או ההסכמות שחלות על השיחות המתועדות. מידע נוסף זמין במאמר פרטיות, משילות מידע (data governance) ואבטחה.

התפקידים הנדרשים

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

  • יצירת מערך הנתונים של היומן: משתמש BigQuery (roles/bigquery.user) בפרויקט
  • נותנים לסוכן השירות גישה למערך הנתונים של היומנים: BigQuery Data Owner (roles/bigquery.dataOwner) במערך הנתונים של היומנים
  • שינוי ההגדרות של רישום השיחות ביומן של סוכן לאינטראקציה עם נתונים: Gemini Data Analytics Data Agent Editor (roles/geminidataanalytics.dataAgentEditor) בסוכן לאינטראקציה עם נתונים או בפרויקט
  • שולחים שאילתה ליומנים:

להסבר על מתן תפקידים, ראו איך מנהלים את הגישה ברמת הפרויקט, התיקייה והארגון.

יכול להיות שאפשר לקבל את ההרשאות הנדרשות גם באמצעות תפקידים בהתאמה אישית או תפקידים מוגדרים מראש.

אם אתם יוצרים את מערך הנתונים של היומן, אתם מקבלים באופן אוטומטי את התפקיד "בעלים של נתוני BigQuery" במערך הנתונים. אם אתם יצרתם את הסוכן לאינטראקציה עם נתונים, אתם מקבלים באופן אוטומטי את התפקיד "בעלים של סוכן לאינטראקציה עם נתונים" (roles/geminidataanalytics.dataAgentOwner) ב-Gemini Data Analytics, שכולל הרשאה לשנות את הגדרות תיעוד השיחות שלו.

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

תפקיד של סוכן שירות

סוכן השירות של Conversational Analytics API‏ (service-PROJECT_NUMBER@gcp-sa-geminidataanalytics.iam.gserviceaccount.com) כותב את היומנים. מחליפים את PROJECT_NUMBER במספר הפרויקט שמכיל את הסוכן לאינטראקציה עם נתונים.

כדי לוודא שלסוכן השירות של Conversational Analytics API יש את ההרשאות הנדרשות ליצירת טבלת היומנים ולכתיבת יומני השיחות, צריך לבקש מהאדמין לתת לסוכן השירות של Conversational Analytics API את תפקיד ה-IAM עריכת נתונים ב-BigQuery (roles/bigquery.dataEditor) במערך הנתונים של היומנים.

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

יכול להיות שהאדמין גם יוכל לתת לסוכן השירות של Conversational Analytics API את ההרשאות שנדרשות באמצעות תפקידים בהתאמה אישית או תפקידים מוגדרים מראש אחרים.

הפעלת הרישום ביומן של השיחות

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

יצירת מערך הנתונים של היומן

יוצרים קבוצת נתונים בפרויקט של סוכן לאינטראקציה עם נתונים כדי לשמור את היומנים. סוכן השירות יוצר את טבלת היומן במערך הנתונים הזה בפנייה הראשונה שנרשמת ביומן. כדי ליצור את קבוצת הנתונים, משתמשים בפקודה bq mk --dataset בכלי שורת הפקודה של BigQuery. אתם יכולים להריץ פקודות של הכלי bq ב-Cloud Shell או בטרמינל מקומי שבו מותקן Google Cloud CLI.

bq --location=LOCATION mk --dataset PROJECT_ID:LOG_DATASET

מחליפים את ערכי הדוגמה באופן הבא:

  • ‫LOCATION: המיקום ב-BigQuery של מערך נתוני היומן, למשל US.
  • ‫PROJECT_ID: מזהה הפרויקט שמכיל את הסוכן לאינטראקציה עם נתונים.
  • ‫LOG_DATASET: המזהה של מערך הנתונים שרוצים ליצור.

במאמר יצירת מערכי נתונים מוסבר איך ליצור מערך נתונים בדרכים אחרות.

מתן גישה לסוכן השירות למערך הנתונים

מקצים לסוכן השירות את התפקיד BigQuery Data Editor (roles/bigquery.dataEditor) רק במערך הנתונים של היומן.

בוחרים באחת מהאפשרויות הבאות:

המסוף

  1. נכנסים לדף BigQuery במסוף Google Cloud .

    כניסה ל-BigQuery

  2. בחלונית Explorer, מרחיבים את הפרויקט, לוחצים על Datasets ובוחרים את מערך הנתונים של היומן.

  3. לוחצים על שיתוף > ניהול הרשאות.

  4. לוחצים על Add principal.

  5. בשדה New principals, מזינים את כתובת האימייל של סוכן השירות: service-PROJECT_NUMBER@gcp-sa-geminidataanalytics.iam.gserviceaccount.com.

    מחליפים את PROJECT_NUMBER במספר הפרויקט שמכיל את הסוכן לאינטראקציה עם נתונים.

  6. ברשימה Select a role לוחצים על BigQuery Data Editor.

  7. לוחצים על Save.

SQL

בעורך השאילתות של BigQuery, מגדירים את מיקום השאילתה למיקום של מערך הנתונים של היומן, ואז מריצים את ההצהרה הבאה של GRANT:

GRANT `roles/bigquery.dataEditor`
ON SCHEMA `PROJECT_ID`.LOG_DATASET
TO "serviceAccount:service-PROJECT_NUMBER@gcp-sa-geminidataanalytics.iam.gserviceaccount.com";

מחליפים את ערכי הדוגמה באופן הבא:

  • ‫PROJECT_ID: מזהה הפרויקט שמכיל את הסוכן לאינטראקציה עם נתונים ואת מערך הנתונים של היומן.
  • ‫LOG_DATASET: המזהה של מערך נתוני היומן.
  • ‫PROJECT_NUMBER: מספר הפרויקט שמכיל את הסוכן לאינטראקציה עם נתונים.

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

הפעלת הרישום ביומן של הסוכן לאינטראקציה עם נתונים

כדי להפעיל את הרישום ביומן של סוכן קיים לאינטראקציה עם נתונים, מגדירים את השדות bigquery_agent_analytics_enabled ו-bigquery_agent_analytics_table של הסוכן (bigqueryAgentAnalyticsEnabled ו-bigqueryAgentAnalyticsTable בבקשות HTTP), וכוללים את שני השדות במסכת העדכון. העדכון משנה רק את השדות במסכת העדכון. סוכן השירות כותב שורות ביומן רק כשמפעילים את הרישום ביומן ומגדירים טבלת יומן.

מריצים את הדוגמאות הבאות בסביבת Python שהגדרתם בקטע קביעת הגדרות והפעלת לקוחות (Python SDK) או קביעת הגדרות ראשוניות ואימות (HTTP), כמו notebook של Colaboratory. כדי להשתמש בדוגמאות הקוד של Python SDK שבדף הזה, צריך להתקין את google-cloud-geminidataanalytics בגרסה 0.13.4 ואילך.

Python SDK

from google.protobuf import field_mask_pb2

data_agent_id = "DATA_AGENT_ID"
log_dataset = "LOG_DATASET"
log_table = "LOG_TABLE"

data_agent = geminidataanalytics.DataAgent()
data_agent.name = f"projects/{billing_project}/locations/{location}/dataAgents/{data_agent_id}"
data_agent.bigquery_agent_analytics_enabled = True
data_agent.bigquery_agent_analytics_table = geminidataanalytics.BigQueryTableReference(
    project_id=billing_project,
    dataset_id=log_dataset,
    table_id=log_table,
)

update_mask = field_mask_pb2.FieldMask(
    paths=["bigquery_agent_analytics_enabled", "bigquery_agent_analytics_table"]
)

request = geminidataanalytics.UpdateDataAgentRequest(
    data_agent=data_agent,
    update_mask=update_mask,
)

try:
  response = data_agent_client.update_data_agent_sync(request=request)
  print(response.bigquery_agent_analytics_enabled)
  print(response.bigquery_agent_analytics_table)
except Exception as e:
  print(f"Error updating data agent: {e}")

מחליפים את ערכי הדוגמה באופן הבא:

  • ‫DATA_AGENT_ID: המזהה של הסוכן לאינטראקציה עם נתונים.
  • ‫LOG_DATASET: המזהה של מערך נתוני היומן.
  • ‫LOG_TABLE: המזהה של טבלת היומן, למשל agent_events. אם הטבלה לא קיימת, סוכן השירות יוצר אותה בפנייה הראשונה שנרשמת ביומן.

HTTP

data_agent_id = "DATA_AGENT_ID"
log_dataset = "LOG_DATASET"
log_table = "LOG_TABLE"

data_agent_url = f"{base_url}/v1/projects/{billing_project}/locations/{location}/dataAgents/{data_agent_id}:updateSync"

payload = {
    "bigqueryAgentAnalyticsEnabled": True,
    "bigqueryAgentAnalyticsTable": {
        "projectId": billing_project,
        "datasetId": log_dataset,
        "tableId": log_table,
    },
}

params = {
    "updateMask": "bigqueryAgentAnalyticsEnabled,bigqueryAgentAnalyticsTable"
}

data_agent_response = requests.patch(
    data_agent_url, headers=headers, params=params, json=payload
)

if data_agent_response.status_code == 200:
    body = data_agent_response.json()
    if body.get("bigqueryAgentAnalyticsEnabled") and body.get(
        "bigqueryAgentAnalyticsTable"
    ):
        print("Conversation logging is turned on.")
    else:
        print("Logging isn't turned on. Check the returned data agent.")
    print(json.dumps(body, indent=2))
else:
    print(f"Error updating data agent: {data_agent_response.status_code}")
    print(data_agent_response.text)

מחליפים את ערכי הדוגמה באופן הבא:

  • ‫DATA_AGENT_ID: המזהה של הסוכן לאינטראקציה עם נתונים.
  • ‫LOG_DATASET: המזהה של מערך נתוני היומן.
  • ‫LOG_TABLE: המזהה של טבלת היומן, למשל agent_events. אם הטבלה לא קיימת, סוכן השירות יוצר אותה בפנייה הראשונה שנרשמת ביומן.

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

כדי להפעיל את הרישום ביומן כשיוצרים סוכן לאינטראקציה עם נתונים, צריך לכלול את אותם השדות בבקשת היצירה. כדי ליצור בקשה, קראו את המאמר "יצירת סוכן לאינטראקציה עם נתונים" (Python SDK או HTTP). בגוף של בקשת HTTP, השדות נראים כך:

"bigqueryAgentAnalyticsEnabled": true,
"bigqueryAgentAnalyticsTable": {
  "projectId": "PROJECT_ID",
  "datasetId": "LOG_DATASET",
  "tableId": "LOG_TABLE"
}

מחליפים את ערכי הדוגמה באופן הבא:

  • ‫PROJECT_ID: מזהה הפרויקט שמכיל את הסוכן לאינטראקציה עם נתונים.
  • ‫LOG_DATASET: המזהה של מערך נתוני היומן.
  • ‫LOG_TABLE: המזהה של טבלת היומן.

איך מוודאים שהשיחות מתועדות ביומן

  1. שולחים בקשת צ'אט לסוכן לאינטראקציה עם נתונים. לדוגמה, עיינו במאמר שימוש ב-API כדי לשאול שאלות (Python SDK או HTTP).
  2. מחכים כ-10 שניות אחרי שהנציג עונה. לאחר מכן, ב-Cloud Shell או במסוף, מריצים את הפקודה הבאה של bq query כדי לראות את השאלות והתשובות האחרונות. אפשר גם להריץ את ה-SQL בעורך השאילתות של BigQuery.

    bq query --use_legacy_sql=false '
    SELECT timestamp, event_type, JSON_VALUE(content, "$.text_summary") AS text
    FROM `PROJECT_ID.LOG_DATASET.LOG_TABLE`
    WHERE timestamp >= TIMESTAMP_SUB(CURRENT_TIMESTAMP(), INTERVAL 1 HOUR)
      AND event_type IN ("USER_MESSAGE_RECEIVED", "AGENT_RESPONSE")
    ORDER BY timestamp DESC
    LIMIT 20'
    

    מחליפים את ערכי הדוגמה באופן הבא:

    • ‫PROJECT_ID: מזהה הפרויקט שמכיל את הסוכן לאינטראקציה עם נתונים.
    • ‫LOG_DATASET: המזהה של מערך הנתונים של היומן.
    • ‫LOG_TABLE: המזהה של טבלת היומן.

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

שינוי טבלת היעד

כדי לכתוב יומנים בטבלה אחרת, מעדכנים את השדה bigquery_agent_analytics_table של הסוכן לאינטראקציה עם נתונים (bigqueryAgentAnalyticsTable בבקשות HTTP), וכוללים את השדה במסכת העדכון. הטבלה החדשה צריכה להיות בפרויקט של הסוכן לאינטראקציה עם נתונים, ולסוכן השירות צריך להיות תפקיד של עריכת נתונים ב-BigQuery במערך הנתונים של הטבלה החדשה.

מריצים את הקוד לדוגמה הבא באותה סביבה שבה הפעלתם את הרישום ביומן של הסוכן לאינטראקציה עם נתונים.

Python SDK

from google.protobuf import field_mask_pb2

data_agent_id = "DATA_AGENT_ID"
log_dataset = "NEW_LOG_DATASET"
log_table = "NEW_LOG_TABLE"

data_agent = geminidataanalytics.DataAgent()
data_agent.name = f"projects/{billing_project}/locations/{location}/dataAgents/{data_agent_id}"
data_agent.bigquery_agent_analytics_table = geminidataanalytics.BigQueryTableReference(
    project_id=billing_project,
    dataset_id=log_dataset,
    table_id=log_table,
)

update_mask = field_mask_pb2.FieldMask(paths=["bigquery_agent_analytics_table"])

request = geminidataanalytics.UpdateDataAgentRequest(
    data_agent=data_agent,
    update_mask=update_mask,
)

try:
  response = data_agent_client.update_data_agent_sync(request=request)
  print(response.bigquery_agent_analytics_table)
except Exception as e:
  print(f"Error updating data agent: {e}")

מחליפים את ערכי הדוגמה באופן הבא:

  • ‫DATA_AGENT_ID: המזהה של הסוכן לאינטראקציה עם נתונים.
  • ‫NEW_LOG_DATASET: המזהה של מערך הנתונים החדש של היומנים.
  • ‫NEW_LOG_TABLE: המזהה של טבלת היומנים החדשה.

HTTP

data_agent_id = "DATA_AGENT_ID"
log_dataset = "NEW_LOG_DATASET"
log_table = "NEW_LOG_TABLE"

data_agent_url = f"{base_url}/v1/projects/{billing_project}/locations/{location}/dataAgents/{data_agent_id}:updateSync"

payload = {
    "bigqueryAgentAnalyticsTable": {
        "projectId": billing_project,
        "datasetId": log_dataset,
        "tableId": log_table,
    },
}

params = {"updateMask": "bigqueryAgentAnalyticsTable"}

data_agent_response = requests.patch(
    data_agent_url, headers=headers, params=params, json=payload
)

if data_agent_response.status_code == 200:
    body = data_agent_response.json()
    table = body.get("bigqueryAgentAnalyticsTable", {})
    if table.get("datasetId") == log_dataset and table.get("tableId") == log_table:
        print("Log table updated.")
    else:
        print("The log table didn't change. Check the returned data agent.")
    print(json.dumps(body, indent=2))
else:
    print(f"Error updating data agent: {data_agent_response.status_code}")
    print(data_agent_response.text)

מחליפים את ערכי הדוגמה באופן הבא:

  • ‫DATA_AGENT_ID: המזהה של הסוכן לאינטראקציה עם נתונים.
  • ‫NEW_LOG_DATASET: המזהה של מערך הנתונים החדש של היומנים.
  • ‫NEW_LOG_TABLE: המזהה של טבלת היומנים החדשה.

שורות שכבר תועדו נשארות בטבלה הקודמת. השינוי נכנס לתוקף בתור הבא.

השבתת הרישום ביומן של השיחות

כדי להשבית את תיעוד השיחות של סוכן לאינטראקציה עם נתונים, מגדירים את השדה bigquery_agent_analytics_enabled של הסוכן (bigqueryAgentAnalyticsEnabled בבקשות HTTP) לערך false, וכוללים את השדה במסכת העדכון.

מריצים את הקוד לדוגמה הבא באותה סביבה שבה הפעלתם את הרישום ביומן של הסוכן לאינטראקציה עם נתונים.

Python SDK

from google.protobuf import field_mask_pb2

data_agent_id = "DATA_AGENT_ID"

data_agent = geminidataanalytics.DataAgent()
data_agent.name = f"projects/{billing_project}/locations/{location}/dataAgents/{data_agent_id}"
data_agent.bigquery_agent_analytics_enabled = False

update_mask = field_mask_pb2.FieldMask(paths=["bigquery_agent_analytics_enabled"])

request = geminidataanalytics.UpdateDataAgentRequest(
    data_agent=data_agent,
    update_mask=update_mask,
)

try:
  response = data_agent_client.update_data_agent_sync(request=request)
  print(response.bigquery_agent_analytics_enabled)
except Exception as e:
  print(f"Error updating data agent: {e}")

מחליפים את DATA_AGENT_ID במזהה של הסוכן לאינטראקציה עם נתונים.

HTTP

data_agent_id = "DATA_AGENT_ID"

data_agent_url = f"{base_url}/v1/projects/{billing_project}/locations/{location}/dataAgents/{data_agent_id}:updateSync"

payload = {"bigqueryAgentAnalyticsEnabled": False}
params = {"updateMask": "bigqueryAgentAnalyticsEnabled"}

data_agent_response = requests.patch(
    data_agent_url, headers=headers, params=params, json=payload
)

if data_agent_response.status_code == 200:
    print("Conversation logging is turned off.")
    print(json.dumps(data_agent_response.json(), indent=2))
else:
    print(f"Error updating data agent: {data_agent_response.status_code}")
    print(data_agent_response.text)

מחליפים את DATA_AGENT_ID במזהה של הסוכן לאינטראקציה עם נתונים.

השינוי ייכנס לתוקף בתור הבא. תור שכבר פועל מסתיים עם ההגדרות שהיו קיימות כשהוא התחיל.

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

אם משביתים את הרישום ביומן, השורות שכבר נרשמו נשמרות. כדי להסיר נתונים שנרשמו ביומן, צריך למחוק שורות, מחיצות או את טבלת היומן.

פתרון בעיות ברישום ביומן של השיחות

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

טבלת היומן חסרה או ריקה

אם טבלת היעד לא נוצרת או נשארת ריקה אחרי סבב שיחה, בדקו את הסיבות האפשריות הבאות:

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

  • מערך הנתונים של היעד חסר או נמצא בפרויקט אחר. מוודאים שמערך הנתונים של היעד כבר קיים באותו פרויקט שבו נמצא הסוכן לאינטראקציה עם נתונים. כדי לוודא שמערך הנתונים קיים, אפשר להריץ את הפקודה bq show PROJECT_ID:LOG_DATASET. מחליפים את PROJECT_ID במזהה הפרויקט שמכיל את הסוכן לאינטראקציה עם נתונים, ואת LOG_DATASET במזהה של מערך הנתונים ביעד. סוכן השירות יוצר את טבלת היומן בפנייה הראשונה שנרשמת ביומן, אבל הוא לא יוצר את מערך הנתונים.

  • מערך הנתונים של היעד הוא מערך נתונים לקריאה בלבד, כמו מערך נתונים מקושר. מערך נתונים מקושר ששותף ב-BigQuery או מערך נתונים חיצוני (לדוגמה, מערך נתונים מאוחד של AWS Glue) הם לקריאה בלבד, ואי אפשר לאחסן בהם יומני שיחות. כדי לבדוק את סוג מערך הנתונים, מריצים את הפקודה bq show --format=prettyjson PROJECT_ID:LOG_DATASET ובודקים את השדה "type" ("LINKED" או "EXTERNAL"). בוחרים מערך נתונים רגיל שניתן לכתיבה באותו פרויקט שבו נמצא הסוכן לאינטראקציה עם נתונים.

  • חסר סוכן שירות או חסרות הרשאות CMEK. מוודאים שלסוכן השירות של Conversational Analytics API (service-PROJECT_NUMBER@gcp-sa-geminidataanalytics.iam.gserviceaccount.com, באמצעות מספר הפרויקט של הסוכן במקום מזהה הפרויקט) יש את התפקיד "עריכת נתונים ב-BigQuery" (roles/bigquery.dataEditor) במערך הנתונים של היומן. אם מערך הנתונים משתמש במפתחות Cloud KMS בניהול הלקוח (CMEK), ודאו שלחשבון השירות של הצפנת BigQuery‏ (bq-PROJECT_NUMBER@bigquery-encryption.iam.gserviceaccount.com) יש את התפקיד roles/cloudkms.cryptoKeyEncrypterDecrypter במפתח.

  • היקף ההרשאות של VPC Service Controls חוסם כתיבה. סוכן השירות של Conversational Analytics API כותב לטבלת היומן מתשתית שמנוהלת על ידי Google, ולכן הקצאת roles/bigquery.dataEditor בלבד לא מספיקה כשגבולות הגזרה לשירות מגבילים את bigquery.googleapis.com. בניגוד לסיבות אחרות ברשימה הזו, חסימה של היקף מתעדת יומני ביקורת של Policy Denied ב-Cloud Logging בפרויקט של הנציג. כדי לאשר את החסימה, מסננים לפי log_id("cloudaudit.googleapis.com/policy") בקטע bigquery.googleapis.com (לחיפוש או ליצירה של טבלה) ולפי bigquerystorage.googleapis.com (להוספת שורות). מוודאים שגם geminidataanalytics.googleapis.com וגם bigquery.googleapis.com נמצאים בגבולות הגזרה, ומוסיפים כלל לתעבורת נתונים נכנסת לסוכן השירות ב-bigquery.googleapis.com. במאמר בקרת גישה, הצפנה ואבטחת רשת מופיעה דוגמה לכלל תעבורת נתונים נכנסת. הנחיות כלליות להגדרת היקף אבטחה מופיעות במאמר הגדרת היקף אבטחה באמצעות VPC Service Controls.

  • פלטפורמת שיחה או הגדרת נציג לא נתמכות. שיחות בחלונית Preview ב-BigQuery Studio וקריאות ל-API ללא שמירת מצב (stateless) בלי סוכן לאינטראקציה עם נתונים לא מתועדות ביומן. כדי לבדוק, שולחים בקשת צ'אט לסוכן לאינטראקציה עם נתונים דרך ה-API. נציגים שמשתמשים בהיקף חיפוש במקום בטבלאות ספציפיות ב-BigQuery, שמגדירים רק תרשימי נכסים ב-BigQuery (בלי טבלאות ב-BigQuery) כמקורות ידע, או שלא מצהירים על טבלאות ב-BigQuery, לא מתועדים ביומן. מידע נוסף מופיע בקטע מגבלות.

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

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

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

חלק מהשיחות של המשתמשים לא מתועדות

הסיבה

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

פתרון

מקצים לכל המשתמשים בצ'אט את התפקיד BigQuery Data Viewer (roles/bigquery.dataViewer) בטבלאות של מקורות הידע, ואת התפקיד BigQuery Job User (roles/bigquery.jobUser) בפרויקט שבו מריצים את השאילתות שלהם. לחלופין, מקצים תפקיד בהתאמה אישית עם ההרשאות bigquery.tables.get ו-bigquery.rowAccessPolicies.list בטבלאות של מקורות הידע.

היצירה או העדכון של הנציג נכשלים עם השגיאה INVALID_ARGUMENT

הודעת שגיאה

  • The BigQuery Agent Analytics table must be in the same project as the agent (agent project: ..., table project: ...).

  • BigQuery Agent Analytics can only be enabled on agents whose datasource is BigQuery. Remove bigquery_agent_analytics_enabled and bigquery_agent_analytics_table, or point the agent at a BigQuery datasource.

הסיבה

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

פתרון

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

הענקת הגישה למערך הנתונים נכשלה כי סוכן השירות לא קיים

הודעת שגיאה

  • Service account service-PROJECT_NUMBER@gcp-sa-geminidataanalytics... does not exist

הסיבה

סוכן השירות של Conversational Analytics API עדיין לא הוקצה בפרויקט.

פתרון

מבצעים אחת מהפעולות הבאות:

  • קודם מגדירים את יעד היומן בסוכן, ואז מקצים שוב את התפקיד.

  • מריצים את הפקודה הבאה כדי להקצות את זהות השירות:

    gcloud beta services identity create \
        --service=geminidataanalytics.googleapis.com \
        --project=PROJECT_ID

    מחליפים את PROJECT_ID במזהה הפרויקט שמכיל את הסוכן לאינטראקציה עם נתונים.

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