Method: answerQuery

עונה על שאילתה באמצעות יצירה מבוססת-הקשר.

בקשת HTTP

POST https://developerknowledge.googleapis.com/v1alpha:answerQuery

כתובת ה-URL כתובה בתחביר של gRPC Transcoding.

גוף הבקשה

גוף הבקשה מכיל נתונים במבנה הבא:

ייצוג JSON 
{
  "query": string,
  "filter": string
}
שדות
query

string

חובה. השאילתה שעליה רוצים לענות.
filter

string

אופציונלי. החלת מסנן מחמיר על תוצאות החיפוש שמשמשות כבסיס לתשובה. הביטוי תומך בחלק מהתחביר שמתואר בכתובת https://google.aip.dev/160.

שדות נתמכים לסינון:

  • ‫content_length_bytes (INTEGER): האורך של השדה Document.content בבייטים.
  • ‫data_source (STRING): המקור של המסמך, לדוגמה: docs.cloud.google.com. הרשימה המלאה של מקורות הנתונים בקורפוס זמינה בכתובת https://developers.google.com/knowledge/reference/corpus-reference.
  • ‫update_time (TIMESTAMP): חותמת הזמן של העדכון המשמעותי האחרון במסמך. עדכון משמעותי הוא עדכון שמשנה את תוכן ה-Markdown או את המטא-נתונים של המסמך.
  • ‫uri (מחרוזת): ה-URI של המסמך, לדוגמה: https://docs.cloud.google.com/bigquery/docs/tables.

השדות INTEGER תומכים באופרטורים =,‏ <,‏ <=,‏ > ו->=.

שדות STRING תומכים באופרטורים = (שווה) ו-!= (לא שווה) להתאמה מדויקת של המחרוזת כולה. אין תמיכה בהתאמה חלקית, בהתאמה של קידומת ובהתאמה לביטוי רגולרי.

השדות TIMESTAMP תומכים באופרטורים =,‏ <,‏ <=,‏ > ו->=. חותמות הזמן צריכות להיות בפורמט RFC-3339, לדוגמה: "2025-01-01T00:00:00Z".

אפשר לשלב בין ביטויים באמצעות האופרטורים הלוגיים AND, OR ו-NOT (או -). ל-OR יש עדיפות גבוהה יותר מאשר ל-AND. משתמשים בסוגריים כדי לקבץ ביטויים לפי סדר עדיפות.

דוגמאות:

  • סינון לפי Document.content_length_bytes: content_length_bytes < 50000
  • data_source = "docs.cloud.google.com" OR data_source = "firebase.google.com"
  • data_source != "firebase.google.com"
  • update_time < "2024-01-01T00:00:00Z"
  • update_time >= "2025-01-22T00:00:00Z" AND (data_source = "developer.chrome.com" OR data_source = "web.dev")
  • uri = "https://docs.cloud.google.com/release-notes"

המחרוזת filter לא יכולה להיות ארוכה מ-500 תווים. אם הערכים ארוכים מ-500 תווים, תוצג שגיאה INVALID_ARGUMENT.

גוף התשובה

הודעת תגובה ל-DeveloperKnowledge.AnswerQuery.

אם הפעולה בוצעה ללא שגיאות, גוף התגובה יכיל נתונים במבנה הבא:

ייצוג JSON 
{
  "answer": {
    object (Answer)
  }
}
שדות
answer

object (Answer)

התשובה לשאילתה.

היקפי הרשאות

נדרש אחד מהיקפי ההרשאות הבאים של OAuth:

  • https://www.googleapis.com/auth/devprofiles.full_control
  • https://www.googleapis.com/auth/developerprofiles.readonly
  • https://www.googleapis.com/auth/cloud-platform

ניתן למצוא מידע נוסף כאן: OAuth 2.0 Overview.

תשובה

תשובה לשאילתה.

ייצוג JSON 
{
  "answerText": string,
  "citations": [
    {
      object (AnswerCitation)
    }
  ],
  "references": [
    {
      object (AnswerReference)
    }
  ]
}
שדות
answerText

string

מכיל את הטקסט של התשובה.
citations[]

object (AnswerCitation)

פלט בלבד. כוללת ציטוטים של התשובה.
references[]

object (AnswerReference)

פלט בלבד. התשובה מכילה הפניות.

AnswerCitation

פרטי ציטוט של פלח.

ייצוג JSON 
{
  "startIndex": integer,
  "endIndex": integer,
  "sources": [
    {
      object (CitationSource)
    }
  ]
}
שדות
startIndex

integer

פלט בלבד. מציין את תחילת הקטע, שנמדדת בבייטים (Unicode בקידוד UTF-8), כולל. אם יש תווים מרובי-בייט, כמו תווים שאינם ASCII, המדידה של האינדקס ארוכה יותר מאורך המחרוזת.
endIndex

integer

פלט בלבד. מציין את סוף הפלח, שנמדד בבייטים (Unicode בקידוד UTF-8), לא כולל. אם יש תווים מרובי-בייטים, כמו תווים שאינם ASCII, מדידת האינדקס ארוכה יותר מאורך המחרוזת.
sources[]

object (CitationSource)

פלט בלבד. מכיל מקורות ציטוטים לפלח המשויך.

CitationSource

מקור הציטוט.

ייצוג JSON 
{
  "referenceIndex": integer
}
שדות
referenceIndex

integer

פלט בלבד. מכיל את האינדקס של Answer.AnswerReference בשדה החוזר references.

AnswerReference

מייצג הפניה למקור.

ייצוג JSON 
{

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "documentReference": {
    object (DocumentReference)
  }
  // End of mutually exclusive fields.
}
שדות
מכיל את התוכן של קובץ העזר. בהמשך מפורטת רשימה של שדות שאי אפשר להשתמש בהם בו-זמנית. בכל תשובה יוגדר לכל היותר אחד מהשדות הבאים:
documentReference

object (DocumentReference)

פלט בלבד. מסמך העזר.
סוף השדות הבלעדיים.

DocumentReference

מייצג הפניה למסמך.

ייצוג JSON 
{
  "documentChunk": {
    object (DocumentChunk)
  }
}
שדות
documentChunk

object (DocumentChunk)

פלט בלבד. מכיל את נתח המסמך. השדה documentChunk.id לא מוגדר ויהיה ריק.