- Biểu diễn dưới dạng JSON
- Ứng viên
- FinishReason
- SafetyRating
- HarmProbability
- CitationMetadata
- CitationSource
- PromptFeedback
- BlockReason
- UsageMetadata (Siêu dữ liệu sử dụng)
Câu trả lời của mô hình hỗ trợ nhiều ứng viên.
Lưu ý về mức xếp hạng an toàn và tính năng lọc nội dung. Các thành phần này được báo cáo cho cả câu lệnh trong GenerateContentResponse.prompt_feedback
và cho mỗi ứng cử viên trong finishReason
và safetyRatings
. Hợp đồng API có nghĩa là: – tất cả ứng cử viên được yêu cầu đều được trả về hoặc hoàn toàn không có ứng viên nào – không có ứng viên nào được trả về chỉ khi có vấn đề với câu lệnh (xem promptFeedback
). Phản hồi về từng ứng cử viên được báo cáo trên finishReason
và safetyRatings
.
Biểu diễn dưới dạng JSON |
---|
{ "candidates": [ { object ( |
Trường | |
---|---|
candidates[] |
Các câu trả lời của ứng viên trong mô hình. |
promptFeedback |
Trả về phản hồi của câu lệnh liên quan đến bộ lọc nội dung. |
usageMetadata |
Chỉ có đầu ra. Siêu dữ liệu về việc sử dụng mã thông báo của các yêu cầu tạo. |
Ứng viên
Một đề xuất phản hồi được tạo từ mô hình.
Biểu diễn dưới dạng JSON |
---|
{ "content": { object ( |
Trường | |
---|---|
content |
Chỉ có đầu ra. Nội dung đã tạo được trả về từ mô hình. |
finishReason |
Không bắt buộc. Chỉ có đầu ra. Lý do khiến mô hình ngừng tạo mã thông báo. Nếu trống thì mô hình chưa ngừng tạo mã thông báo. |
safetyRatings[] |
Danh sách điểm xếp hạng về sự an toàn của một ứng viên trả lời. Mỗi danh mục có tối đa một điểm xếp hạng. |
citationMetadata |
Chỉ có đầu ra. Thông tin trích dẫn cho đề xuất do mô hình tạo. Trường này có thể điền thông tin trích dẫn cho bất kỳ văn bản nào có trong |
tokenCount |
Chỉ có đầu ra. Số lượng mã thông báo cho từ khóa này. |
index |
Chỉ có đầu ra. Chỉ mục của ứng viên trong danh sách ứng viên. |
FinishReason
Xác định lý do khiến mô hình ngừng tạo mã thông báo.
Enum | |
---|---|
FINISH_REASON_UNSPECIFIED |
Giá trị mặc định. Giá trị này chưa được sử dụng. |
STOP |
Điểm dừng tự nhiên của mô hình hoặc trình tự dừng được cung cấp. |
MAX_TOKENS |
Đã đạt đến số lượng mã thông báo tối đa được chỉ định trong yêu cầu. |
SAFETY |
Nội dung ứng cử viên đã bị gắn cờ vì lý do an toàn. |
RECITATION |
Nội dung đề xuất đã bị gắn cờ vì lý do trích dẫn. |
OTHER |
Không rõ lý do. |
SafetyRating
Xếp hạng an toàn cho một nội dung.
Mức phân loại an toàn cho biết nội dung có mức độ an toàn theo danh mục nguy hại và khả năng gây hại thuộc danh mục đó. Nội dung được phân loại là an toàn trong một số danh mục mối nguy hại và xác suất phân loại tác hại được đưa vào phần này.
Biểu diễn dưới dạng JSON |
---|
{ "category": enum ( |
Trường | |
---|---|
category |
Bắt buộc. Danh mục cho điểm xếp hạng này. |
probability |
Bắt buộc. Khả năng gây hại của nội dung này. |
blocked |
Nội dung này có bị chặn do mức phân loại này không? |
HarmProbability
Xác suất mà một nội dung gây hại.
Hệ thống phân loại đưa ra xác suất nội dung không an toàn. Điều này không cho biết mức độ nghiêm trọng của tác hại đối với một nội dung.
Enum | |
---|---|
HARM_PROBABILITY_UNSPECIFIED |
Xác suất chưa được xác định. |
NEGLIGIBLE |
Nội dung có ít khả năng không an toàn. |
LOW |
Nội dung có ít khả năng không an toàn. |
MEDIUM |
Nội dung có nguy cơ không an toàn ở mức trung bình. |
HIGH |
Nội dung có nhiều nguy cơ không an toàn. |
CitationMetadata
Tập hợp thông tin ghi nhận nguồn cho một nội dung.
Biểu diễn dưới dạng JSON |
---|
{
"citationSources": [
{
object ( |
Trường | |
---|---|
citationSources[] |
Câu trích dẫn đến các nguồn cho một câu trả lời cụ thể. |
CitationSource
Câu trích dẫn đến nguồn cho một phần của một câu trả lời cụ thể.
Biểu diễn dưới dạng JSON |
---|
{ "startIndex": integer, "endIndex": integer, "uri": string, "license": string } |
Trường | |
---|---|
startIndex |
Không bắt buộc. Bắt đầu phân đoạn của câu trả lời được ghi nhận cho nguồn này. Chỉ mục cho biết điểm bắt đầu của phân đoạn, được đo bằng byte. |
endIndex |
Không bắt buộc. Kết thúc phân đoạn được phân bổ, không bao gồm. |
uri |
Không bắt buộc. URI được phân bổ làm nguồn cho một phần văn bản. |
license |
Không bắt buộc. Giấy phép cho dự án GitHub được phân bổ dưới dạng nguồn cho phân khúc. Bạn phải cung cấp thông tin giấy phép để trích dẫn mã. |
PromptFeedback
Tập hợp siêu dữ liệu phản hồi về lời nhắc được chỉ định trong GenerateContentRequest.content
.
Biểu diễn dưới dạng JSON |
---|
{ "blockReason": enum ( |
Trường | |
---|---|
blockReason |
Không bắt buộc. Nếu bạn đặt chính sách này, lời nhắc sẽ bị chặn và không có đề xuất nào được trả về. Diễn đạt lại câu lệnh của bạn. |
safetyRatings[] |
Điểm xếp hạng về độ an toàn của câu lệnh. Mỗi danh mục có tối đa một điểm xếp hạng. |
BlockReason
Nêu rõ lý do chặn lời nhắc.
Enum | |
---|---|
BLOCK_REASON_UNSPECIFIED |
Giá trị mặc định. Giá trị này chưa được sử dụng. |
SAFETY |
Lời nhắc đã bị chặn vì lý do an toàn. Bạn có thể kiểm tra safetyRatings để nắm được danh mục an toàn nào đã chặn nó. |
OTHER |
Lời nhắc đã bị chặn vì lý do không xác định. |
UsageMetadata
Siêu dữ liệu về việc sử dụng mã thông báo của yêu cầu tạo.
Biểu diễn dưới dạng JSON |
---|
{ "promptTokenCount": integer, "candidatesTokenCount": integer, "totalTokenCount": integer } |
Trường | |
---|---|
promptTokenCount |
Số mã thông báo trong câu lệnh. Khi đặt cacheContent, đây vẫn là tổng kích thước có hiệu lực của lời nhắc. Tức là số liệu này bao gồm cả số lượng mã thông báo có trong nội dung được lưu vào bộ nhớ đệm. |
candidatesTokenCount |
Tổng số mã thông báo trên các đề xuất đã tạo. |
totalTokenCount |
Tổng số mã thông báo cho yêu cầu tạo (câu lệnh + đề xuất). |