פתרון בעיות שקשורות לשגיאות ב-API של ניתוח נתוני השיחות

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

שגיאה הסיבה לשגיאה קוד סטטוס של HTTP קוד סטטוס gRPC פתרון
AlreadyExistsException ALREADY_EXISTS 409 Conflict 6 המשאב כבר קיים (לדוגמה, אתם יוצרים רשומה כפולה). צריך להשתמש במזהה אחר או לוודא שהמשאב לא קיים לפני שיוצרים אותו.
BadRequestException INVALID_ARGUMENT 400 Bad Request 3 הקלט לא תקין או שהפורמט שלו שגוי. לפני ששולחים את הבקשה, צריך לאמת את הקלט או את המטען הייעודי (payload).
BadRequestException (היקף החיפוש) INVALID_ARGUMENT 400 Bad Request 3 היקף החיפוש ב-BigQuery בבקשה לא תקין. כדי לתקן את השגיאה, פועלים לפי ההנחיות שבהודעת השגיאה שקיבלתם:
  • At least one of include_project_ids or include_dataset_references must be provided in search_scope.

    צריך לציין לפחות קבוצת נתונים אחת או פרויקט אחד.

  • search_scope.include_dataset_references must not contain more than 100 elements. או search_scope.include_project_ids must not contain more than 100 elements.

    אפשר לציין עד 100 מערכי נתונים ועד 100 פרויקטים.

  • ‫Elements in search_scope.include_project_ids must not be blank., Elements in search_scope.include_project_ids must be valid BigQuery project IDs., או שגיאה שמתחילה ב- Each dataset reference in search_scope.include_dataset_references must have

    ציינו רק את מזהה הפרויקט ומזהה מערך הנתונים, בלי קידומת, רווחים או מירכאות. לדוגמה, מציינים את my-project במקום את projects/my-project.

  • Search scope is not supported in DataAgent. It is only supported for standalone conversations.

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

מידע נוסף זמין במאמר התחברות למערכי נתונים ולפרויקטים של BigQuery.
ForbiddenException PERMISSION_DENIED 403 Forbidden 7 האימות בוצע, אבל אין לכם הרשאת גישה למשאב. בודקים את תפקיד המשתמש וההרשאות. אם צריך, פנו לאדמין.
‫PermissionDenied (מדיניות הארגון) PERMISSION_DENIED 403 Forbidden 7 הבקשה מפרה אילוץ של מדיניות הארגון, כמו הגבלת מיקום או דרישה ל-CMEK. כדי לזהות איזו מגבלה הופרה, בודקים את הודעת השגיאה בגוף התגובה. מידע נוסף זמין במאמר פתרון בעיות שקשורות להפרות מדיניות.
FailedPreconditionException FAILED_PRECONDITION 400 Bad Request 9 הבקשה מפרה את מצב המערכת (לדוגמה, ניסיון למחוק תיקייה לא ריקה). בודקים את התנאים המוקדמים ומתקנים את הלוגיקה.
NotFoundException NOT_FOUND 404 Not Found 5

המשאב לא נמצא. מאמתים את מזהי המשאבים או כתובות ה-URL. מוודאים שהמשאב קיים לפני שמנסים לגשת אליו.

מידע נוסף על פתרון בעיות זמין במאמר שאלות נפוצות על Conversational Analytics API.

ServiceUnavailableException UNAVAILABLE 503 Service Unavailable 14 יש בעיה זמנית בשרת. צריך להמתין ולנסות שוב עם השהיה מעריכית לפני ניסיון חוזר (exponential backoff) בין הניסיונות. אם השגיאה נמשכת, אפשר לשלוח דוח על באג.
Connection reset by peer (בזמן הסטרימינג) UNAVAILABLE 503 Service Unavailable 14

אם אתם משתמשים בלקוח HTTP או REST רגיל כדי לקרוא לנקודת הקצה (endpoint) של הסטרימינג ב-:chat, יכול להיות שהשרת נתקל בשגיאה חמורה (כמו זמן קצוב לתפוגה או דחיית הרשאה) במהלך הסטרימינג. מכיוון שכותרות HTTP כבר נשלחות, קוד השגיאה האמיתי ממוקם בטריילרים של HTTP/2, שלקוחות REST רגילים לא יכולים לנתח, וכתוצאה מכך יש קריסה של השקע.

מומלץ להשתמש ב Google Cloud ספריות הלקוח הרשמיות של gRPC, כמו Python SDK, כדי לקרוא לנקודות קצה של סטרימינג. הספריות האלה מנתחות את הכותרות הנגררות האלה ומציגות את הסיבה האמיתית לשגיאה.

Internal error encountered (בזמן הסטרימינג) INTERNAL 500 Internal Server Error 13

אם אתם משתמשים בלקוח HTTP או REST רגיל כדי לקרוא לנקודת הקצה (endpoint) של הסטרימינג :chat, יכול להיות שהשרת נתקל בשגיאה חמורה במהלך הסטרימינג. מכיוון שכותרות HTTP כבר נשלחות, קוד השגיאה האמיתי ממוקם בטריילרים של HTTP/2, שלקוחות REST רגילים לא יכולים לנתח, וכתוצאה מכך יש קריסה של השקע.

מומלץ להשתמש ב Google Cloud ספריות הלקוח הרשמיות של gRPC, כמו Python SDK, כדי לקרוא לנקודות קצה של סטרימינג. הספריות האלה מנתחות את הכותרות בסוף התגובה ומציגות את הסיבה האמיתית לשגיאה.

UnauthenticatedException UNAUTHENTICATED 401 Unauthorized 16 נדרש אימות, או שהאימות נכשל. מוודאים שמשתמשים בפרטי הכניסה, במפתח ה-API או בטוקן הנכונים.
UnimplementedException UNIMPLEMENTED 501 Not Implemented 12 התכונה המבוקשת לא זמינה או לא נתמכת. אל תפעילו את ה-API הזה, או המתינו להטמעה.

מקורות מידע נוספים

בדף שאלות נפוצות על Conversational Analytics API מפורטים טיפים נוספים לפתרון בעיות ותשובות לשאלות נפוצות.

כדי לקבל הנחיות לגבי שאלת שאלות יעילות ב-Conversational Analytics API, אפשר לעיין בדף התיעוד שאלת שאלות יעילות.