GenerateContentResponse

คำตอบจากโมเดลที่รองรับผู้สมัครหลายราย

หมายเหตุเกี่ยวกับการให้คะแนนความปลอดภัยและการกรองเนื้อหา มีการรายงานสําหรับทั้งข้อความแจ้งในGenerateContentResponse.prompt_feedbackและสําหรับผู้สมัครแต่ละคนในfinishReasonและsafetyRatings สัญญา API ระบุไว้ว่า: - ระบบจะแสดงผลผู้สมัครทั้งหมดที่ขอทั้งหมดหรือไม่แสดงผู้สมัครเลย - ระบบจะไม่แสดงผู้สมัครก็ต่อเมื่อมีข้อผิดพลาดกับข้อความแจ้ง (ดู promptFeedback) เท่านั้น ระบบจะรายงานความคิดเห็นเกี่ยวกับผู้สมัครแต่ละคนในวันที่ finishReason และ safetyRatings

การแสดง JSON 
{
  "candidates": [
    {
      object (Candidate)
    }
  ],
  "promptFeedback": {
    object (PromptFeedback)
  },
  "usageMetadata": {
    object (UsageMetadata)
  }
}
ช่อง
candidates[]

object (Candidate)

คำตอบสำหรับผู้สมัครจากโมเดล
promptFeedback

object (PromptFeedback)

แสดงความคิดเห็นของข้อความแจ้งที่เกี่ยวข้องกับตัวกรองเนื้อหา
usageMetadata

object (UsageMetadata)

เอาต์พุตเท่านั้น ข้อมูลเมตาเกี่ยวกับการใช้โทเค็นของคำขอการสร้าง

ผู้สมัคร

ตัวเลือกการตอบกลับที่สร้างขึ้นจากโมเดล

การแสดง 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)

รายการการให้คะแนนความปลอดภัยของตัวเลือกคำตอบ

แต่ละหมวดหมู่มีการจัดประเภทได้ไม่เกิน 1 ประเภท
citationMetadata

object (CitationMetadata)

เอาต์พุตเท่านั้น ข้อมูลการอ้างอิงสำหรับผู้สมัครที่โมเดลสร้างขึ้น

ช่องนี้อาจมีข้อมูลการบรรยายสำหรับข้อความที่อยู่ใน content ข้อความเหล่านี้เป็นข้อความที่ "ท่องจำ" จากเนื้อหาที่มีลิขสิทธิ์ในข้อมูลการฝึกของ LLM พื้นฐาน
tokenCount

integer

เอาต์พุตเท่านั้น จำนวนโทเค็นสำหรับผู้สมัครนี้
index

integer

เอาต์พุตเท่านั้น ดัชนีของผู้สมัครในรายชื่อผู้สมัคร

FinishReason

กำหนดเหตุผลที่โมเดลหยุดสร้างโทเค็น

Enum
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

ความเป็นไปได้ที่เนื้อหาหนึ่งๆ จะเป็นอันตราย

ระบบการแยกประเภทจะให้ความน่าจะเป็นที่เนื้อหาจะไม่ปลอดภัย ซึ่งไม่ได้บ่งชี้ถึงความรุนแรงของอันตรายต่อเนื้อหาส่วนหนึ่งๆ

Enum
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)

คะแนนเพื่อความปลอดภัยของข้อความแจ้ง แต่ละหมวดหมู่มีการจัดประเภทได้ไม่เกิน 1 ประเภท

BlockReason

ระบุเหตุผลที่บล็อกพรอมต์

Enum
BLOCK_REASON_UNSPECIFIED ค่าเริ่มต้น ค่านี้ไม่ได้ใช้
SAFETY ข้อความแจ้งถูกบล็อกเนื่องจากเหตุผลด้านความปลอดภัย คุณสามารถตรวจสอบ safetyRatings เพื่อดูว่าหมวดหมู่ความปลอดภัยใดบล็อกหมวดหมู่นั้น
OTHER ข้อความแจ้งถูกบล็อกโดยไม่ทราบสาเหตุ

UsageMetadata

ข้อมูลเมตาเกี่ยวกับการใช้โทเค็นของคำขอการสร้าง

การแสดง JSON 
{
  "promptTokenCount": integer,
  "candidatesTokenCount": integer,
  "totalTokenCount": integer
}
ช่อง
promptTokenCount

integer

จำนวนโทเค็นในข้อความแจ้ง เมื่อตั้งค่าแคชเนื้อหา นี่จะยังเป็นขนาดพรอมต์ที่มีประสิทธิภาพโดยรวม เช่น จำนวนโทเค็นในเนื้อหาที่แคชไว้
candidatesTokenCount

integer

จํานวนโทเค็นทั้งหมดจากตัวเลือกที่สร้างขึ้น
totalTokenCount

integer

จำนวนโทเค็นทั้งหมดสำหรับคำขอสร้าง (ข้อความแจ้ง + ผู้สมัคร)