GenerateContentResponse

پاسخ از مدلی که از چندین نامزد پشتیبانی می کند.

توجه به رتبه بندی ایمنی و فیلتر محتوا. آنها هم برای prompt در GenerateContentResponse.prompt_feedback و هم برای هر کاندید در finishReason و در safetyRatings گزارش می شوند. قرارداد API به این صورت است که: - یا همه کاندیداهای درخواست شده برگردانده می شوند یا اصلاً هیچ نامزدی وجود ندارد - هیچ نامزدی فقط در صورتی بازگردانده نمی شود که مشکلی در دستور وجود داشته باشد (به promptFeedback مراجعه کنید) - بازخورد هر نامزد در finishReason و safetyRatings گزارش می شود.

نمایندگی JSON
{
  "candidates": [
    {
      object (Candidate)
    }
  ],
  "promptFeedback": {
    object (PromptFeedback)
  }
}
زمینه های
candidates[]

object ( Candidate )

پاسخ های کاندیدا از مدل.

promptFeedback

object ( PromptFeedback )

بازخورد درخواست مربوط به فیلترهای محتوا را برمی‌گرداند.

نامزد

یک کاندید پاسخ تولید شده از مدل.

نمایندگی JSON
{
  "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 پر شود. این‌ها قسمت‌هایی هستند که از مطالب دارای حق چاپ در داده‌های آموزشی بنیادی LLM «خوانده می‌شوند».

tokenCount

integer

فقط خروجی شمارش رمز برای این نامزد.

index

integer

فقط خروجی فهرست نامزد در فهرست نامزدها.

FinishReason

دلیل توقف تولید توکن ها توسط مدل را مشخص می کند.

Enums
FINISH_REASON_UNSPECIFIED مقدار پیش فرض. این مقدار استفاده نشده است.
STOP نقطه توقف طبیعی مدل یا توالی توقف ارائه شده.
MAX_TOKENS حداکثر تعداد توکن‌هایی که در درخواست مشخص شده بود به دست آمد.
SAFETY محتوای نامزد به دلایل ایمنی پرچم گذاری شد.
RECITATION محتوای نامزد به دلایل تلاوت علامت گذاری شد.
OTHER دلیل نامعلوم.

رتبه ایمنی

رتبه بندی ایمنی برای یک قطعه محتوا.

رتبه بندی ایمنی شامل دسته آسیب و سطح احتمال آسیب در آن دسته برای یک قطعه محتوا است. محتوا برای ایمنی در تعدادی از دسته‌های آسیب طبقه‌بندی شده است و احتمال طبقه‌بندی آسیب در اینجا گنجانده شده است.

نمایندگی JSON
{
  "category": enum (HarmCategory),
  "probability": enum (HarmProbability),
  "blocked": boolean
}
زمینه های
category

enum ( HarmCategory )

ضروری. دسته بندی برای این رتبه بندی

probability

enum ( HarmProbability )

ضروری. احتمال آسیب برای این محتوا.

blocked

boolean

آیا این محتوا به دلیل این رتبه بندی مسدود شده است؟

احتمال آسیب

احتمال مضر بودن یک قطعه محتوا.

سیستم طبقه بندی احتمال ناامن بودن محتوا را می دهد. این نشان دهنده شدت آسیب برای یک قطعه محتوا نیست.

Enums
HARM_PROBABILITY_UNSPECIFIED احتمال نامشخص است.
NEGLIGIBLE احتمال ناامن بودن محتوا ناچیز است.
LOW احتمال ناامن بودن محتوا کم است.
MEDIUM محتوا شانس متوسطی برای ناایمن بودن دارد.
HIGH محتوا شانس بالایی برای ناامن بودن دارد.

CitationMetadata

مجموعه ای از منابع منبع برای یک قطعه محتوا.

نمایندگی JSON
{
  "citationSources": [
    {
      object (CitationSource)
    }
  ]
}
زمینه های
citationSources[]

object ( CitationSource )

استناد به منابع برای پاسخ خاص.

منبع استناد

استناد به یک منبع برای بخشی از یک پاسخ خاص.

نمایندگی JSON
{
  "startIndex": integer,
  "endIndex": integer,
  "uri": string,
  "license": string
}
زمینه های
startIndex

integer

اختیاری. شروع بخش پاسخی که به این منبع نسبت داده می شود.

شاخص شروع بخش را نشان می دهد که در بایت اندازه گیری می شود.

endIndex

integer

اختیاری. انتهای بخش منتسب، انحصاری.

uri

string

اختیاری. URI که به عنوان منبع بخشی از متن نسبت داده می شود.

license

string

اختیاری. مجوز برای پروژه GitHub که به عنوان منبعی برای بخش نسبت داده می شود.

اطلاعات مجوز برای استناد کد مورد نیاز است.

PromptFeedback

مجموعه ای از فراداده های بازخوردی که در GenerateContentRequest.content مشخص شده است.

نمایندگی JSON
{
  "blockReason": enum (BlockReason),
  "safetyRatings": [
    {
      object (SafetyRating)
    }
  ]
}
زمینه های
blockReason

enum ( BlockReason )

اختیاری. در صورت تنظیم، درخواست مسدود شده است و هیچ نامزدی برگردانده نمی شود. درخواست خود را دوباره بیان کنید.

safetyRatings[]

object ( SafetyRating )

رتبه بندی برای ایمنی سریع. حداکثر یک رتبه برای هر دسته وجود دارد.

BlockReason

مشخص می کند که دلیل مسدود شدن درخواست چه بوده است.

Enums
BLOCK_REASON_UNSPECIFIED مقدار پیش فرض. این مقدار استفاده نشده است.
SAFETY درخواست به دلایل ایمنی مسدود شد. می‌توانید safetyRatings بررسی کنید تا متوجه شوید کدام دسته ایمنی آن را مسدود کرده است.
OTHER درخواست به دلایل نامعلوم مسدود شد.