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à lọc nội dung. Các đề xuất này sẽ được báo cáo cho cả câu lệnh trong GenerateContentResponse.prompt_feedback cũng như cho từng đề xuất 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 – không có ứng viên nào được trả về chỉ nếu có vấn đề với câu lệnh (xem promptFeedback) – phản hồi về từng ứng viên sẽ đượ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)
  },
  "usageMetadata": {
    object (UsageMetadata)
  }
}
Trường
candidates[]

object (Candidate)

Phản hồ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 các bộ lọc nội dung.
usageMetadata

object (UsageMetadata)

Chỉ có đầu ra. Siêu dữ liệu về việc sử dụng mã thông báo của yêu cầu tạo.

Ứ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
}
Trường
content

object (Content)

Chỉ có đầu ra. Nội dung được tạo được 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 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 phản hồ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 trích dẫn cho bất kỳ văn bản nào có trong content. Đây là những đoạn văn được "trích dẫn" 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 nền tảng.
tokenCount

integer

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

integer

Chỉ có đầu ra. Chỉ mục của ứng cử viên trong danh sách ứng cử 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 điểm 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 của ứng cử viên đã bị gắn cờ vì lý do an toàn.
RECITATION Nội dung ứ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 phân loại an toàn cho một nội dung.

Mức phân loại an toàn bao gồm danh mục thiệt hại và mức độ xác suất gây hại trong 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 gây hại và xác suất được phân loại gây hại được đưa vào đây.

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

enum (HarmCategory)

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

enum (HarmProbability)

Bắt buộc. Xác suất gây hại của nội dung này.
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ột phần nội dung gây hại.

Hệ thống phân loại đưa ra xác suất nội dung sẽ không an toàn. Điều này không cho biết mức độ nghiêm trọng của hành vi gây hại đối với một nội dung.

Enum
HARM_PROBABILITY_UNSPECIFIED Xác suất không được xác định.
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 trở nên 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 khả năng không an toàn.

CitationMetadata

Tập hợp các thuộc tính nguồn cho một phần nội dung.

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

object (CitationSource)

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

CitationSource

Trích dẫn đến 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
}
Trường
startIndex

integer

Không bắt buộc. Bắt đầu phân đoạn của câu trả lờ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 đo bằng byte.
endIndex

integer

Không bắt buộc. Kết thúc phân đoạn được phân bổ, loại trừ.
uri

string

Không bắt buộc. URI được phân bổ dưới dạng nguồn cho một phần của 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 đoạn.

Bắt buộc phải có thông tin giấy phép cho 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)
    }
  ]
}
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ó đề xuất nào được trả về. Diễn đạt lại câu lệnh của bạn.
safetyRatings[]

object (SafetyRating)

Điểm xếp hạng về độ 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

Chỉ định 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 mã này.
OTHER Lời nhắc đã bị chặn do 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

integer

Số mã thông báo trong lời nhắc.
candidatesTokenCount

integer

Tổng số mã thông báo trên các đề xuất đã tạo.
totalTokenCount

integer

Tổng số mã thông báo cho yêu cầu tạo (lời nhắc + đề xuất).