GenerateContentResponse

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 (Candidate)
    }
  ],
  "promptFeedback": {
    object (PromptFeedback)
  },
  "usageMetadata": {
    object (UsageMetadata)
  }
}
Trường
candidates[]

object (Candidate)

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

object (PromptFeedback)

Trả về phản hồi của câu lệnh liên quan đến 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 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 (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 đã tạo được trả về từ mô hình.
finishReason

enum (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[]

object (SafetyRating)

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

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ể điề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 "rút lại" từ tài liệu có bản quyền trong dữ liệu huấn luyện của mô hình ngôn ngữ lớn (LLM).
tokenCount

integer

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

integer

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 (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. Khả năng 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à 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 (CitationSource)
    }
  ]
}
Trường
citationSources[]

object (CitationSource)

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

integer

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

integer

Không bắt buộc. Kết thúc phân đoạn được phân bổ, không bao gồm.
uri

string

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

string

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 (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 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[]

object (SafetyRating)

Đ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

integer

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

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 (câu lệnh + đề xuất).