GenerateContentResponse

एक से ज़्यादा उम्मीदवारों का समर्थन करने वाले मॉडल से मिला जवाब.

सुरक्षा रेटिंग और कॉन्टेंट फ़िल्टर करने के बारे में ध्यान दें. इन प्रॉम्प्ट को GenerateContentResponse.prompt_feedback में प्रॉम्प्ट के साथ-साथ, finishReason और safetyRatings में हर उम्मीदवार के लिए रिपोर्ट किया जाता है. एपीआई के समझौते के मुताबिक: - अनुरोध किए गए सभी उम्मीदवार दिखाए जाते हैं या कोई भी उम्मीदवार नहीं भेजा जाता - कोई भी उम्मीदवार सिर्फ़ तब वापस किया जाता है, जब प्रॉम्प्ट में कुछ गलत हो (promptFeedback देखें). - हर उम्मीदवार के बारे में सुझाव, finishReason और safetyRatings को रिपोर्ट किए जाते हैं.

जेएसओएन के काेड में दिखाना
{
  "candidates": [
    {
      object (Candidate)
    }
  ],
  "promptFeedback": {
    object (PromptFeedback)
  },
  "usageMetadata": {
    object (UsageMetadata)
  }
}
फ़ील्ड
candidates[]

object (Candidate)

मॉडल से उम्मीदवार के जवाब.

promptFeedback

object (PromptFeedback)

कॉन्टेंट के फ़िल्टर से जुड़े प्रॉम्प्ट के सुझाव, शिकायत या राय को दिखाता है.

usageMetadata

object (UsageMetadata)

सिर्फ़ आउटपुट के लिए. जनरेट किए गए अनुरोधों के टोकन के इस्तेमाल का मेटाडेटा.

उम्मीदवार

मॉडल से जनरेट किया गया रिस्पॉन्स कैंडिडेट.

जेएसओएन के काेड में दिखाना
{
  "content": {
    object (Content)
  },
  "finishReason": enum (FinishReason),
  "safetyRatings": [
    {
      object (SafetyRating)
    }
  ],
  "citationMetadata": {
    object (CitationMetadata)
  },
  "tokenCount": integer,
  "index": integer
}
फ़ील्ड
content

object (Content)

सिर्फ़ आउटपुट के लिए. जनरेट किया गया कॉन्टेंट, मॉडल से मिला है.

finishReason

enum (FinishReason)

ज़रूरी नहीं. सिर्फ़ आउटपुट के लिए. मॉडल ने टोकन जनरेट करना क्यों बंद किया.

अगर खाली है, तो मॉडल ने टोकन जनरेट करना बंद नहीं किया है.

safetyRatings[]

object (SafetyRating)

जवाब देने वाले कैंडिडेट की सुरक्षा के लिए रेटिंग की सूची.

हर कैटगरी के लिए ज़्यादा से ज़्यादा एक रेटिंग है.

citationMetadata

object (CitationMetadata)

सिर्फ़ आउटपुट के लिए. मॉडल से जनरेट किए गए कैंडिडेट के लिए उद्धरण की जानकारी.

इस फ़ील्ड में, content में शामिल किसी भी टेक्स्ट को पढ़कर सुनाने की जानकारी अपने-आप भरी जा सकती है. ये ऐसे पैसेज हैं जिन्हें बुनियादी एलएलएम की ट्रेनिंग के डेटा में, कॉपीराइट वाले कॉन्टेंट में से "पढ़ा गया" है.

tokenCount

integer

सिर्फ़ आउटपुट के लिए. इस उम्मीदवार के लिए टोकन की संख्या.

index

integer

सिर्फ़ आउटपुट के लिए. उम्मीदवारों की सूची में उम्मीदवार का इंडेक्स.

FinishReason

इससे पता चलता है कि मॉडल ने टोकन जनरेट करना क्यों बंद किया.

Enums
FINISH_REASON_UNSPECIFIED डिफ़ॉल्ट मान. इस वैल्यू का इस्तेमाल नहीं किया गया है.
STOP मॉडल या दिए गए स्टॉप के क्रम का नैचुरल स्टॉप पॉइंट.
MAX_TOKENS अनुरोध में ज़्यादा से ज़्यादा टोकन इस्तेमाल नहीं किए जा सकते.
SAFETY सुरक्षा के लिहाज़ से उम्मीदवार के कॉन्टेंट को फ़्लैग किया गया है.
RECITATION उम्मीदवार के कॉन्टेंट को पढ़ने की वजह बताने के लिए फ़्लैग किया गया था.
OTHER पुष्टि न होने की वजह पता नहीं है.

SafetyRating

कॉन्टेंट के किसी हिस्से के लिए सुरक्षा रेटिंग.

सुरक्षा रेटिंग में, किसी कॉन्टेंट के लिए नुकसान की कैटगरी और उस कैटगरी में नुकसान की संभावना का लेवल शामिल होता है. कॉन्टेंट को सुरक्षा के लिहाज़ से, नुकसान की कई कैटगरी में बांटा जाता है. साथ ही, नुकसान की संभावना के बारे में यहां बताया गया है.

जेएसओएन के काेड में दिखाना
{
  "category": enum (HarmCategory),
  "probability": enum (HarmProbability),
  "blocked": boolean
}
फ़ील्ड
category

enum (HarmCategory)

ज़रूरी है. इस रेटिंग की कैटगरी.

probability

enum (HarmProbability)

ज़रूरी है. इससे पता चलता है कि इस कॉन्टेंट से नुकसान पहुंचने की कितनी संभावना है.

blocked

boolean

क्या इस रेटिंग की वजह से यह कॉन्टेंट ब्लॉक किया गया था?

HarmProbability

इस बात की संभावना कि कॉन्टेंट का कोई हिस्सा नुकसान पहुंचा सकता है.

डेटा की कैटगरी तय करने वाला सिस्टम, कॉन्टेंट के असुरक्षित होने की संभावना बताता है. इससे, यह पता नहीं चलता है कि कॉन्टेंट के किसी हिस्से को कितना नुकसान हुआ है.

Enums
HARM_PROBABILITY_UNSPECIFIED प्रायिकता की जानकारी नहीं है.
NEGLIGIBLE कॉन्टेंट के असुरक्षित होने की संभावना बहुत कम होती है.
LOW कॉन्टेंट के असुरक्षित होने की संभावना बहुत कम होती है.
MEDIUM कॉन्टेंट के असुरक्षित होने की संभावना काफ़ी कम है.
HIGH कॉन्टेंट के असुरक्षित होने की संभावना ज़्यादा है.

CitationMetadata

कॉन्टेंट के किसी हिस्से के लिए सोर्स एट्रिब्यूशन का कलेक्शन.

जेएसओएन के काेड में दिखाना
{
  "citationSources": [
    {
      object (CitationSource)
    }
  ]
}
फ़ील्ड
citationSources[]

object (CitationSource)

किसी खास जवाब के लिए, स्रोतों को उद्धरण देना.

CitationSource

किसी खास जवाब के किसी हिस्से के लिए, सोर्स से जुड़ा उद्धरण.

जेएसओएन के काेड में दिखाना
{
  "startIndex": integer,
  "endIndex": integer,
  "uri": string,
  "license": string
}
फ़ील्ड
startIndex

integer

ज़रूरी नहीं. इस सोर्स को एट्रिब्यूट किए गए रिस्पॉन्स का शुरुआती हिस्सा.

इंडेक्स से पता चलता है कि सेगमेंट की शुरुआत हुई है या नहीं. इसे बाइट में मापा जाता है.

endIndex

integer

ज़रूरी नहीं. एट्रिब्यूट किए गए सेगमेंट का आखिरी हिस्सा, खास.

uri

string

ज़रूरी नहीं. ऐसा यूआरआई जिसे टेक्स्ट के किसी हिस्से के सोर्स के तौर पर एट्रिब्यूट किया जाता है.

license

string

ज़रूरी नहीं. GitHub प्रोजेक्ट के लिए लाइसेंस, जिसे सेगमेंट के सोर्स के तौर पर एट्रिब्यूट किया गया है.

कोड उद्धरण के लिए लाइसेंस की जानकारी ज़रूरी है.

PromptFeedback

GenerateContentRequest.content में दिए गए प्रॉम्प्ट से जुड़े सुझाव, राय या शिकायत के मेटाडेटा का सेट.

जेएसओएन के काेड में दिखाना
{
  "blockReason": enum (BlockReason),
  "safetyRatings": [
    {
      object (SafetyRating)
    }
  ]
}
फ़ील्ड
blockReason

enum (BlockReason)

ज़रूरी नहीं. इस नीति को सेट करने पर, प्रॉम्प्ट को ब्लॉक कर दिया जाता है और कोई उम्मीदवार नहीं दिखाया जाता. अपने प्रॉम्प्ट को नए तरीके से लिखें.

safetyRatings[]

object (SafetyRating)

प्रॉम्प्ट की सुरक्षा के लिए रेटिंग. हर कैटगरी के लिए ज़्यादा से ज़्यादा एक रेटिंग है.

BlockReason

इससे पता चलता है कि प्रॉम्प्ट को ब्लॉक किए जाने की वजह क्या थी.

Enums
BLOCK_REASON_UNSPECIFIED डिफ़ॉल्ट मान. इस वैल्यू का इस्तेमाल नहीं किया गया है.
SAFETY सुरक्षा की वजह से, प्रॉम्प्ट को ब्लॉक किया गया. safetyRatings की जांच करके, यह पता लगाया जा सकता है कि सुरक्षा की किस कैटगरी ने इसे ब्लॉक किया है.
OTHER इस प्रॉम्प्ट को ब्लॉक कर दिया गया है, क्योंकि इसकी वजह पता नहीं है.

UsageMetadata

जनरेट करने के अनुरोध के टोकन के इस्तेमाल का मेटाडेटा.

जेएसओएन के काेड में दिखाना
{
  "promptTokenCount": integer,
  "candidatesTokenCount": integer,
  "totalTokenCount": integer
}
फ़ील्ड
promptTokenCount

integer

प्रॉम्प्ट में टोकन की संख्या.

candidatesTokenCount

integer

जनरेट किए गए सभी कैंडिडेट के लिए टोकन की कुल संख्या.

totalTokenCount

integer

जनरेट करने के अनुरोध के लिए कुल टोकन की संख्या (प्रॉम्प्ट + कैंडिडेट).