استجابة من النموذج الذي يدعم عدة مرشحين.
ملاحظة حول تقييمات الأمان وفلترة المحتوى ويتم الإبلاغ عنها لكل من الطلب في GenerateContentResponse.prompt_feedback
ولكل مرشّح في finishReason
وفي safetyRatings
. بموجب عقد واجهة برمجة التطبيقات: إما أنّه يتم إرجاع جميع المرشحين المطلوبين أو عدم إرجاع أي مرشحين على الإطلاق، لا يتم إرجاع أي مرشحين فقط في حال حدوث خطأ في الطلب (راجِع promptFeedback
) - يتم الإبلاغ عن الملاحظات حول كل مرشح في finishReason
وsafetyRatings
.
تمثيل JSON |
---|
{ "candidates": [ { object ( |
الحقول | |
---|---|
candidates[] |
ردود المرشحين من النموذج |
promptFeedback |
عرض ملاحظات الطلب ذات الصلة بفلاتر المحتوى |
usageMetadata |
النتائج فقط. البيانات الوصفية حول استخدام الرمز المميّز لطلبات الإنشاء |
PromptFeedback
مجموعة من البيانات الوصفية للملاحظات للطلب المحدّد في GenerateContentRequest.content
.
تمثيل JSON |
---|
{ "blockReason": enum ( |
الحقول | |
---|---|
blockReason |
اختياريّ. وفي حال ضبطها، تم حظر الطلب ولن يتم عرض أي اقتراحات. أعِد صياغة طلبك. |
safetyRatings[] |
التقييمات للتأكّد من أمان الطلب يتوفّر تقييم واحد كحدّ أقصى لكل فئة. |
BlockReason
تحدّد هذه السياسة سبب حظر الطلب.
عمليات التعداد | |
---|---|
BLOCK_REASON_UNSPECIFIED |
القيمة التلقائية. هذه القيمة غير مستخدمة. |
SAFETY |
تم حظر الطلب لأسباب تتعلق بالسلامة. يمكنك فحص "safetyRatings " لمعرفة فئة الأمان التي حظرته. |
OTHER |
تم حظر الطلب لأسباب غير معروفة. |
UsageMetadata
البيانات الوصفية المتعلقة باستخدام الرمز المميّز لطلب الإنشاء
تمثيل JSON |
---|
{ "promptTokenCount": integer, "cachedContentTokenCount": integer, "candidatesTokenCount": integer, "totalTokenCount": integer } |
الحقول | |
---|---|
promptTokenCount |
عدد الرموز المميّزة في الطلب عند ضبط cacheContent، يبقى هذا هو إجمالي حجم الطلب الفعال. بمعنى أن يشمل ذلك عدد الرموز المميّزة في المحتوى المخزّن مؤقتًا. |
cachedContentTokenCount |
عدد الرموز المميّزة في الجزء المخزن مؤقتًا من الطلب، أي في المحتوى المخزن مؤقتًا |
candidatesTokenCount |
إجمالي عدد الرموز المميّزة على مستوى العناصر المحفّزة لعرض الإعلان |
totalTokenCount |
إجمالي عدد الرموز المميّزة لطلب الإنشاء (الطلب + الطلبات المرشحة) |