GenerateContentResponse

Resposta do modelo que oferece suporte a vários candidatos.

Observação sobre classificações de segurança e filtragem de conteúdo Elas são informadas para o comando em GenerateContentResponse.prompt_feedback e para cada candidato em finishReason e em safetyRatings. O contrato da API é que: - ou todos os candidatos solicitados são retornados ou nenhum candidato é retornado apenas se houver algo errado com a solicitação (consulte promptFeedback) - o feedback sobre cada candidato é informado no finishReason e no safetyRatings.

Representação JSON 
{
  "candidates": [
    {
      object (Candidate)
    }
  ],
  "promptFeedback": {
    object (PromptFeedback)
  }
}
Campos
candidates[]

object (Candidate)

Respostas candidatos do modelo.
promptFeedback

object (PromptFeedback)

Retorna o feedback da solicitação relacionado aos filtros de conteúdo.

Candidato

Um candidato de resposta gerado pelo modelo.

Representação JSON 
{
  "content": {
    object (Content)
  },
  "finishReason": enum (FinishReason),
  "safetyRatings": [
    {
      object (SafetyRating)
    }
  ],
  "citationMetadata": {
    object (CitationMetadata)
  },
  "tokenCount": integer,
  "index": integer
}
Campos
content

object (Content)

Apenas saída. Conteúdo gerado retornado do modelo.
finishReason

enum (FinishReason)

Opcional. Apenas saída. É o motivo pelo qual o modelo parou de gerar tokens.

Se estiver vazio, o modelo não parou de gerar os tokens.
safetyRatings[]

object (SafetyRating)

Lista de classificações de segurança de um candidato.

Há no máximo uma classificação por categoria.
citationMetadata

object (CitationMetadata)

Apenas saída. Informações de citação do candidato gerado pelo modelo.

Esse campo pode ser preenchido com informações de recitação de qualquer texto incluído em content. Esses trechos são "recitados" de materiais protegidos por direitos autorais nos dados de treinamento do LLM de base.
tokenCount

integer

Apenas saída. Contagem de tokens desse candidato.
index

integer

Apenas saída. Índice do candidato na lista de candidatos.

FinishReason

Define o motivo pelo qual o modelo parou de gerar tokens.

Enums
FINISH_REASON_UNSPECIFIED Valor padrão. Esse valor não é usado.
STOP Ponto de parada natural do modelo ou sequência de parada fornecida.
MAX_TOKENS O número máximo de tokens especificado na solicitação foi atingido.
SAFETY O conteúdo do candidato foi sinalizado por motivos de segurança.
RECITATION O conteúdo do candidato foi sinalizado por motivos de recitação.
OTHER Motivo desconhecido.

SafetyRating

É a classificação de segurança de um conteúdo.

A classificação de segurança contém a categoria do dano e o nível de probabilidade de danos nessa categoria para um conteúdo. O conteúdo é classificado de acordo com a segurança em várias categorias de danos, e a probabilidade de classificação de danos está incluída aqui.

Representação JSON 
{
  "category": enum (HarmCategory),
  "probability": enum (HarmProbability),
  "blocked": boolean
}
Campos
category

enum (HarmCategory)

Obrigatório. A categoria desta classificação.
probability

enum (HarmProbability)

Obrigatório. A probabilidade de danos para o conteúdo.
blocked

boolean

O conteúdo foi bloqueado devido a essa classificação?

HarmProbability

A probabilidade de um conteúdo ser prejudicial.

O sistema de classificação indica a probabilidade de o conteúdo não ser seguro. Isso não indica a gravidade do dano para uma parte do conteúdo.

Enums
HARM_PROBABILITY_UNSPECIFIED A probabilidade não foi especificada.
NEGLIGIBLE o conteúdo tem uma chance mínima de não ser seguro.
LOW O conteúdo tem uma chance baixa de não ser seguro.
MEDIUM O conteúdo tem uma chance média de não ser seguro.
HIGH O conteúdo tem uma grande chance de não ser seguro.

CitationMetadata

Uma coleção de atribuições de fonte para um conteúdo.

Representação JSON 
{
  "citationSources": [
    {
      object (CitationSource)
    }
  ]
}
Campos
citationSources[]

object (CitationSource)

Citações de fontes para uma resposta específica.

CitationSource

Uma citação de uma fonte para uma parte de uma resposta específica.

Representação JSON 
{
  "startIndex": integer,
  "endIndex": integer,
  "uri": string,
  "license": string
}
Campos
startIndex

integer

Opcional. Início do segmento da resposta atribuído a essa origem.

Índice indica o início do segmento, medido em bytes.
endIndex

integer

Opcional. Fim do segmento atribuído, exclusivo.
uri

string

Opcional. URI que é atribuído como a origem de uma parte do texto.
license

string

Opcional. Licença para o projeto do GitHub que é atribuído como uma origem do segmento.

As informações de licença são obrigatórias para citações de código.

PromptFeedback

Um conjunto de metadados de feedback da solicitação especificada em GenerateContentRequest.content.

Representação JSON 
{
  "blockReason": enum (BlockReason),
  "safetyRatings": [
    {
      object (SafetyRating)
    }
  ]
}
Campos
blockReason

enum (BlockReason)

Opcional. Se definido, a solicitação será bloqueada e nenhum candidato será retornado. Reformule seu comando.
safetyRatings[]

object (SafetyRating)

Classificações de segurança da solicitação. Há no máximo uma classificação por categoria.

BlockReason

Especifica o motivo do bloqueio da solicitação.

Enums
BLOCK_REASON_UNSPECIFIED Valor padrão. Esse valor não é usado.
SAFETY A solicitação foi bloqueada por motivos de segurança. Inspecione o safetyRatings para entender qual categoria de segurança a bloqueou.
OTHER A solicitação foi bloqueada devido a motivos desconhecidos.