GenerateContentResponse

התשובה מהמודל שתומכת במספר מועמדים.

הערה לגבי סיווגי בטיחות וסינון תוכן. הם מדווחים גם להנחיות בGenerateContentResponse.prompt_feedback וגם לכל מועמד בfinishReason ובsafetyRatings. חוזה ה-API הוא: - או שכל המועמדים המבוקשים מוחזרים או שלא מוחזרים אף מועמדים - לא מוחזרים מועמדים רק אם הייתה בעיה בהנחיה (ראו promptFeedback) - משוב על כל מועמד מדווח ב-finishReason וב-safetyRatings.

ייצוג JSON
{
  "candidates": [
    {
      object (Candidate)
    }
  ],
  "promptFeedback": {
    object (PromptFeedback)
  },
  "usageMetadata": {
    object (UsageMetadata)
  }
}
שדות
candidates[]

object (Candidate)

התשובות של המועמדים מהמודל.

promptFeedback

object (PromptFeedback)

מחזירה את המשוב של ההנחיה שקשורה למסנני התוכן.

usageMetadata

object (UsageMetadata)

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

PromptFeedback

קבוצת מטא-נתונים של המשוב שההנחיה שצוינה ב-GenerateContentRequest.content.

ייצוג JSON
{
  "blockReason": enum (BlockReason),
  "safetyRatings": [
    {
      object (SafetyRating)
    }
  ]
}
שדות
blockReason

enum (BlockReason)

זה שינוי אופציונלי. אם היא מוגדרת, ההנחיה נחסמה ולא מוחזרים מועמדים. נסחו מחדש את ההנחיה.

safetyRatings[]

object (SafetyRating)

דירוגים של בטיחות ההצעה. לכל קטגוריה יש דירוג אחד לכל היותר.

BlockReason

מציינת מה הייתה הסיבה לחסימת ההנחיה.

טיפוסים בני מנייה (enum)
BLOCK_REASON_UNSPECIFIED ערך ברירת המחדל. הערך הזה לא בשימוש.
SAFETY ההנחיה נחסמה מטעמי בטיחות. אפשר לבדוק את safetyRatings כדי להבין איזו קטגוריית בטיחות חסמה אותה.
OTHER ההנחיה נחסמה בגלל סיבות לא ידועות.

UsageMetadata

מטא-נתונים לגבי השימוש באסימון של בקשת הגנרציה.

ייצוג JSON
{
  "promptTokenCount": integer,
  "cachedContentTokenCount": integer,
  "candidatesTokenCount": integer,
  "totalTokenCount": integer
}
שדות
promptTokenCount

integer

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

cachedContentTokenCount

integer

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

candidatesTokenCount

integer

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

totalTokenCount

integer

מספר האסימונים הכולל לבקשת היצירה (הנחיה + מועמדים).