GenerateContentResponse

Respuesta del modelo que admite varios candidatos.

Nota sobre las clasificaciones de seguridad y el filtrado de contenido. Se informan para la instrucción en GenerateContentResponse.prompt_feedback y para cada candidato en finishReason y en safetyRatings. El contrato de la API es lo siguiente: - se muestran todos los candidatos solicitados o no se muestra ninguno - no se muestran candidatos solo si hubo algún problema con la instrucción (consulta promptFeedback) - Los comentarios sobre cada candidato se informan en finishReason y safetyRatings.

Representación JSON 
{
  "candidates": [
    {
      object (Candidate)
    }
  ],
  "promptFeedback": {
    object (PromptFeedback)
  }
}
Campos
candidates[]

object (Candidate)

Respuestas de candidatos del modelo.
promptFeedback

object (PromptFeedback)

Muestra los comentarios de la instrucción relacionados con los filtros de contenido.

Candidato

Un candidato de respuesta generado a partir del modelo.

Representación JSON 
{
  "content": {
    object (Content)
  },
  "finishReason": enum (FinishReason),
  "safetyRatings": [
    {
      object (SafetyRating)
    }
  ],
  "citationMetadata": {
    object (CitationMetadata)
  },
  "tokenCount": integer,
  "index": integer
}
Campos
content

object (Content)

Solo salida. Contenido generado que muestra el modelo.
finishReason

enum (FinishReason)

Opcional. Solo salida. El motivo por el que el modelo dejó de generar tokens.

Si está vacío, el modelo no dejó de generar los tokens.
safetyRatings[]

object (SafetyRating)

Es la lista de calificaciones relacionadas con la seguridad de los candidatos a las respuestas.

Existe, como máximo, una calificación por categoría.
citationMetadata

object (CitationMetadata)

Solo salida. Información sobre citas del candidato generado por el modelo.

Este campo puede propagarse con información de recitación para cualquier texto incluido en content. Estos son pasajes “recitados” de material protegido por derechos de autor en los datos de entrenamiento fundamentales del LLM.
tokenCount

integer

Solo salida. Recuento de tokens de este candidato.
index

integer

Solo salida. Índice del candidato en la lista de candidatos.

FinishReason

Define el motivo por el que el modelo dejó de generar tokens.

Enumeradores
FINISH_REASON_UNSPECIFIED Valor predeterminado Este valor no se usa.
STOP Punto de parada natural del modelo o secuencia de parada proporcionada.
MAX_TOKENS Se alcanzó la cantidad máxima de tokens especificada en la solicitud.
SAFETY El contenido del candidato se marcó por motivos de seguridad.
RECITATION El contenido de los candidatos se marcó por motivos de recitación.
OTHER Motivo desconocido.

SafetyRating

Es la clasificación de seguridad de un contenido.

La clasificación de seguridad incluye la categoría de daño y el nivel de probabilidad de daño de un elemento de contenido. El contenido se clasifica en función de la seguridad en una serie de categorías de daño, y aquí se incluye la probabilidad de que se clasifique como un daño.

Representación JSON 
{
  "category": enum (HarmCategory),
  "probability": enum (HarmProbability),
  "blocked": boolean
}
Campos
category

enum (HarmCategory)

Obligatorio. Es la categoría de esta calificación.
probability

enum (HarmProbability)

Obligatorio. Indica la probabilidad de daño a este contenido.
blocked

boolean

¿Este contenido estaba bloqueado debido a esta clasificación?

HarmProbability

Es la probabilidad de que un contenido sea dañino.

El sistema de clasificación indica la probabilidad de que el contenido no sea seguro. Esto no indica la gravedad del daño en un contenido.

Enumeradores
HARM_PROBABILITY_UNSPECIFIED La probabilidad no se especifica.
NEGLIGIBLE La probabilidad de que el contenido sea peligroso es mínima.
LOW Hay pocas probabilidades de ser inseguro.
MEDIUM Es probable que el contenido no sea seguro.
HIGH Es muy probable que el contenido no sea seguro.

CitationMetadata

Es una colección de atribuciones fuente para un elemento de contenido.

Representación JSON 
{
  "citationSources": [
    {
      object (CitationSource)
    }
  ]
}
Campos
citationSources[]

object (CitationSource)

Citas a las fuentes para una respuesta específica.

CitationSource

Es una cita a una fuente para una parte de una respuesta específica.

Representación JSON 
{
  "startIndex": integer,
  "endIndex": integer,
  "uri": string,
  "license": string
}
Campos
startIndex

integer

Opcional. Inicio del segmento de la respuesta atribuida a esta fuente.

El índice indica el inicio del segmento, medido en bytes.
endIndex

integer

Opcional. Fin del segmento atribuido, exclusivo.
uri

string

Opcional. Es el URI que se atribuye como fuente de una parte del texto.
license

string

Opcional. Licencia del proyecto de GitHub que se atribuye como fuente del segmento.

Se requiere la información de la licencia para las citas de código.

PromptFeedback

Un conjunto de metadatos de comentarios que la instrucción especificó en GenerateContentRequest.content.

Representación JSON 
{
  "blockReason": enum (BlockReason),
  "safetyRatings": [
    {
      object (SafetyRating)
    }
  ]
}
Campos
blockReason

enum (BlockReason)

Opcional. Si se configura, se bloqueó el mensaje y no se muestran candidatos. Reformula tu instrucción.
safetyRatings[]

object (SafetyRating)

Calificaciones de seguridad del mensaje Existe, como máximo, una calificación por categoría.

BlockReason

Especifica el motivo por el que se bloqueó el mensaje.

Enumeradores
BLOCK_REASON_UNSPECIFIED Valor predeterminado Este valor no se usa.
SAFETY Por motivos de seguridad, se bloqueó el mensaje. Puedes inspeccionar safetyRatings para comprender qué categoría de seguridad lo bloqueó.
OTHER Se bloqueó el mensaje debido a motivos desconocidos.