GenerateContentResponse

رد من النموذج يدعم عدة مرشحين.

ملاحظة بشأن تقييمات الأمان وفلترة المحتوى. ويتم الإبلاغ عنها لكل من الطلب في GenerateContentResponse.prompt_feedback ولكل مرشّح في finishReason وفي safetyRatings. ينص عقد واجهة برمجة التطبيقات على ما يلي: - إما أن يتم إرجاع جميع المرشحين المطلوبين أو عدم تقديم أي مرشحين على الإطلاق - لا يتم إرجاع مرشحين فقط في حال وجود خطأ في الطلب (يُرجى الاطّلاع على 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. يشمل ذلك الفقرات التي "يُقرأ" من مواد محمية بحقوق الطبع والنشر في بيانات التدريب الأساسية الخاصة بالنموذج اللغوي الكبير.
tokenCount

integer

النتائج فقط. عدد الرموز المميّزة لهذا العنصر المحفّز لعرض الإعلان
index

integer

النتائج فقط. فهرس المرشح في قائمة المرشّحين

FinishReason

تحدد سبب توقف النموذج عن إنشاء الرموز المميّزة.

عمليات التعداد
FINISH_REASON_UNSPECIFIED القيمة التلقائية. هذه القيمة غير مستخدَمة.
STOP نقطة توقف طبيعية للنموذج أو تسلسل التوقف المقدم.
MAX_TOKENS تم بلوغ الحد الأقصى لعدد الرموز المميّزة كما هو محدّد في الطلب.
SAFETY تم الإبلاغ عن المحتوى المرشح لأسباب تتعلق بالسلامة.
RECITATION تم الإبلاغ عن المحتوى المرشح لأسباب تتعلق بالقراءة.
OTHER السبب غير معروف.

SafetyRating

تقييم الأمان لأحد المحتوى.

يتضمّن تصنيف الأمان فئة الضرر ومستوى احتمالية الضرر في تلك الفئة لجزء من المحتوى. يتم تصنيف المحتوى لأغراض السلامة وفقًا لعدد من فئات الضرر، ويتم تضمين تصنيف احتمال الضرر هنا.

تمثيل JSON 
{
  "category": enum (HarmCategory),
  "probability": enum (HarmProbability),
  "blocked": boolean
}
الحقول
category

enum (HarmCategory)

مطلوبة. فئة هذا التقييم.
probability

enum (HarmProbability)

مطلوبة. احتمالية إلحاق الضرر بهذا المحتوى
blocked

boolean

هل تم حظر هذا المحتوى بسبب هذا التقييم؟

HarmProbability

احتمالية أن يكون جزء من المحتوى ضارًا.

يمنح نظام التصنيف احتمالية أن يكون المحتوى غير آمن. ولا يشير ذلك إلى مدى شدة الضرر الذي يمكن أن يلحق بجزء من المحتوى.

عمليات التعداد
HARM_PROBABILITY_UNSPECIFIED لم يتم تحديد الاحتمال.
NEGLIGIBLE هناك احتمال ضئيل أن يكون المحتوى غير آمن.
LOW من المحتمل أن يكون المحتوى غير آمن بنسبة منخفضة.
MEDIUM من المُحتمل أن يكون المحتوى غير آمن بنسبة متوسطة.
HIGH هناك احتمال كبير بأن يكون المحتوى غير آمن.

CitationMetadata

مجموعة من إحالات المصدر لجزء من المحتوى.

تمثيل JSON 
{
  "citationSources": [
    {
      object (CitationSource)
    }
  ]
}
الحقول
citationSources[]

object (CitationSource)

اقتباسات من مصادر لرد محدد

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

يحدّد سبب حظر الطلب.

عمليات التعداد
BLOCK_REASON_UNSPECIFIED القيمة التلقائية. هذه القيمة غير مستخدَمة.
SAFETY تم حظر رسالة المطالبة لأسباب تتعلق بالسلامة. يمكنك فحص "safetyRatings" لمعرفة فئة الأمان التي حظرتها.
OTHER تم حظر الطلب بسبب أسباب غير معروفة.