התשובה מהמודל שתומכת במספר מועמדים.
הערה לגבי סיווגי בטיחות וסינון תוכן. הם מדווחים גם להנחיות בGenerateContentResponse.prompt_feedback
וגם לכל מועמד בfinishReason
ובsafetyRatings
. חוזה ה-API הוא: - או שכל המועמדים המבוקשים מוחזרים או שלא מוחזרים אף מועמדים - לא מוחזרים מועמדים רק אם הייתה בעיה בהנחיה (ראו promptFeedback
) - משוב על כל מועמד מדווח ב-finishReason
וב-safetyRatings
.
ייצוג JSON |
---|
{ "candidates": [ { object ( |
שדות | |
---|---|
candidates[] |
התשובות של המועמדים מהמודל. |
promptFeedback |
מחזירה את המשוב של ההנחיה שקשורה למסנני התוכן. |
usageMetadata |
פלט בלבד. מטא-נתונים על השימוש באסימון של בקשות הגנרציה. |
PromptFeedback
קבוצת מטא-נתונים של המשוב שההנחיה שצוינה ב-GenerateContentRequest.content
.
ייצוג JSON |
---|
{ "blockReason": enum ( |
שדות | |
---|---|
blockReason |
זה שינוי אופציונלי. אם היא מוגדרת, ההנחיה נחסמה ולא מוחזרים מועמדים. נסחו מחדש את ההנחיה. |
safetyRatings[] |
דירוגים של בטיחות ההצעה. לכל קטגוריה יש דירוג אחד לכל היותר. |
BlockReason
מציינת מה הייתה הסיבה לחסימת ההנחיה.
טיפוסים בני מנייה (enum) | |
---|---|
BLOCK_REASON_UNSPECIFIED |
ערך ברירת המחדל. הערך הזה לא בשימוש. |
SAFETY |
ההנחיה נחסמה מטעמי בטיחות. אפשר לבדוק את safetyRatings כדי להבין איזו קטגוריית בטיחות חסמה אותה. |
OTHER |
ההנחיה נחסמה בגלל סיבות לא ידועות. |
UsageMetadata
מטא-נתונים לגבי השימוש באסימון של בקשת הגנרציה.
ייצוג JSON |
---|
{ "promptTokenCount": integer, "cachedContentTokenCount": integer, "candidatesTokenCount": integer, "totalTokenCount": integer } |
שדות | |
---|---|
promptTokenCount |
מספר האסימונים בהודעה. כשמוגדר תוכן שנשמר במטמון, זה עדיין הגודל הכולל של ההנחיות האפקטיביות. כלומר, זה כולל את מספר האסימונים בתוכן ששמור במטמון. |
cachedContentTokenCount |
מספר האסימונים בחלק שנשמר במטמון של ההנחיה, כלומר בתוכן ששמור במטמון. |
candidatesTokenCount |
המספר הכולל של האסימונים האפשריים בכל המועמדים שנוצרו. |
totalTokenCount |
מספר האסימונים הכולל לבקשת היצירה (הנחיה + מועמדים). |