GenerateContentResponse

Respuesta del modelo que admite varios candidatos.

Nota sobre las clasificaciones de seguridad y los filtros 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 el siguiente: - Se muestran todos los candidatos solicitados o ninguno - no se muestra ningún candidato 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)
  },
  "usageMetadata": {
    object (UsageMetadata)
  }
}
Campos
candidates[]

object (Candidate)

Respuestas de los candidatos del modelo.
promptFeedback

object (PromptFeedback)

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

object (UsageMetadata)

Solo salida. Metadatos sobre el uso del token de las solicitudes de generación.

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)

Lista de calificaciones sobre la seguridad de un candidato para responder.

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

object (CitationMetadata)

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

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

integer

Solo salida. Recuento de tokens para esta variante.
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 especificado 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 para un 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.

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

enum (HarmCategory)

Obligatorio. La categoría de esta calificación.
probability

enum (HarmProbability)

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

boolean

¿Este contenido está 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 que causa el contenido.

Enumeradores
HARM_PROBABILITY_UNSPECIFIED La probabilidad no se especifica.
NEGLIGIBLE El contenido tiene pocas probabilidades de ser inseguro.
LOW Hay pocas probabilidades de que el contenido no sea seguro.
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 contenido.

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

object (CitationSource)

Citas a las fuentes de una respuesta específica.

CitationSource

Una cita a una fuente que corresponde a 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 para el proyecto de GitHub que se atribuye como fuente del segmento.

Se requiere información de 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 establece, se bloqueó el mensaje y no se muestran candidatos. Reformula tu instrucción.
safetyRatings[]

object (SafetyRating)

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

BlockReason

Especifica el motivo por el que se bloqueó la instrucción.

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

UsageMetadata

Metadatos sobre el uso del token de la solicitud de generación.

Representación JSON 
{
  "promptTokenCount": integer,
  "candidatesTokenCount": integer,
  "totalTokenCount": integer
}
Campos
promptTokenCount

integer

Cantidad de tokens en el mensaje.
candidatesTokenCount

integer

Cantidad total de tokens entre los candidatos generados.
totalTokenCount

integer

Recuento total de tokens para la solicitud de generación (mensaje + candidatos).