GenerateContentResponse

Phản hồi từ mô hình hỗ trợ nhiều đề xuất.

Lưu ý về mức phân loại độ an toàn và việc lọc nội dung. Các câu lệnh này được báo cáo cho cả lời nhắc trong GenerateContentResponse.prompt_feedback và cho từng ứng viên trong finishReason và safetyRatings. Hợp đồng API là: – tất cả ứng viên được yêu cầu đều được trả về hoặc không có ứng viên nào được trả về – chỉ có ứng viên nào được trả về nếu có lỗi với câu lệnh (xem promptFeedback) – phản hồi về từng ứng viên được báo cáo vào finishReason và safetyRatings.

Biểu diễn dưới dạng JSON 
{
  "candidates": [
    {
      object (Candidate)
    }
  ],
  "promptFeedback": {
    object (PromptFeedback)
  }
}
Các trường
candidates[]

object (Candidate)

Câu trả lời của ứng viên từ mô hình.
promptFeedback

object (PromptFeedback)

Trả về phản hồi của lời nhắc liên quan đến bộ lọc nội dung.

Ứng viên

Đề xuất phản hồi được tạo từ mô hình.

Biểu diễn dưới dạng JSON 
{
  "content": {
    object (Content)
  },
  "finishReason": enum (FinishReason),
  "safetyRatings": [
    {
      object (SafetyRating)
    }
  ],
  "citationMetadata": {
    object (CitationMetadata)
  },
  "tokenCount": integer,
  "index": integer
}
Các trường
content

object (Content)

Chỉ có đầu ra. Nội dung được tạo ra do mô hình trả về.
finishReason

enum (FinishReason)

Không bắt buộc. Chỉ có đầu ra. Lý do mô hình này ngừng tạo mã thông báo.

Nếu trống, mô hình vẫn chưa ngừng tạo mã thông báo.
safetyRatings[]

object (SafetyRating)

Danh sách điểm xếp hạng về mức độ an toàn của ứng viên trả lời.

Có tối đa một điểm xếp hạng cho mỗi danh mục.
citationMetadata

object (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ể được điền sẵn thông tin về bài học nhớ cho bất kỳ văn bản nào có trong content. Đây là những đoạn văn được "đọc" từ tài liệu có bản quyền trong dữ liệu đào tạo của mô hình ngôn ngữ lớn (LLM cơ bản).
tokenCount

integer

Chỉ có đầu ra. Số lượng mã thông báo của đề xuất này.
index

integer

Chỉ có đầu ra. Chỉ mục của ứng cử 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 không được sử dụng.
STOP Điểm dừng tự nhiên của mô hình hoặc chuỗi dừng đã cho.
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 đề xuất đã bị gắn cờ vì lý do an toàn.
RECITATION Nội dung của ứng cử viên đã bị gắn cờ vì lý do liên quan đến việc trích dẫn nội dung.
OTHER Lý do không xác định.

SafetyRating

Mức xếp hạng an toàn cho một nội dung.

Mức phân loại an toàn chứa danh mục thiệt hại và mức độ xác suất gây hại thuộc danh mục đó của một nội dung. Nội dung được phân loại là an toàn theo một số loại mối nguy hại và xác suất phân loại mối nguy hại cũng được thêm vào đây.

Biểu diễn dưới dạng JSON 
{
  "category": enum (HarmCategory),
  "probability": enum (HarmProbability),
  "blocked": boolean
}
Các trường
category

enum (HarmCategory)

Bắt buộc. Danh mục của điểm xếp hạng này.
probability

enum (HarmProbability)

Bắt buộc. Xác suất nội dung này bị tổn hại.
blocked

boolean

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 có 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ổn hại đối với một nội dung.

Enum
HARM_PROBABILITY_UNSPECIFIED Chưa xác định được xác suất.
NEGLIGIBLE Nội dung có nguy cơ không an toàn là không đáng kể.
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ó nguy cơ cao không an toàn.

CitationMetadata

Tập hợp các thông tin ghi nhận tác giả nguồn cho một nội dung.

Biểu diễn dưới dạng JSON 
{
  "citationSources": [
    {
      object (CitationSource)
    }
  ]
}
Các trường
citationSources[]

object (CitationSource)

Trích dẫn các nguồn cho một câu trả lời cụ thể.

CitationSource

Trích dẫn đến một nguồn cho một phần của câu trả lời cụ thể.

Biểu diễn dưới dạng JSON 
{
  "startIndex": integer,
  "endIndex": integer,
  "uri": string,
  "license": string
}
Các trường
startIndex

integer

Không bắt buộc. Bắt đầu phân đoạn của phản hồi được phân bổ cho nguồn này.

Chỉ mục cho biết điểm bắt đầu của phân đoạn, được tính bằng byte.
endIndex

integer

Không bắt buộc. Kết thúc độc quyền phân đoạn được phân bổ.
uri

string

Không bắt buộc. URI được phân bổ dưới dạng nguồn cho một phần văn bản.
license

string

Không bắt buộc. Giấy phép của dự án GitHub được phân bổ dưới dạng nguồn cho phân khúc.

Cần có thông tin giấy phép để trích dẫn mã.

PromptFeedback

Một tập hợp siêu dữ liệu phản hồi mà lời nhắc đã chỉ định trong GenerateContentRequest.content.

Biểu diễn dưới dạng JSON 
{
  "blockReason": enum (BlockReason),
  "safetyRatings": [
    {
      object (SafetyRating)
    }
  ]
}
Các trường
blockReason

enum (BlockReason)

Không bắt buộc. Nếu bạn đặt chính sách này, lời nhắc đã bị chặn và không có ứng viên nào được trả về. Diễn đạt lại gợi ý của bạn.
safetyRatings[]

object (SafetyRating)

Điểm xếp hạng về mức độ an toàn của câu lệnh. Có tối đa một điểm xếp hạng cho mỗi danh mục.

BlockReason

Nêu lý do khiến lời nhắc bị chặn.

Enum
BLOCK_REASON_UNSPECIFIED Giá trị mặc định. Giá trị này không đượ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 để biết danh mục an toàn nào đã chặn lệnh này.
OTHER Lời nhắc đã bị chặn do lý do không xác định.