GenerateContentResponse

Risposta del modello che supporta più candidati.

Nota sulle classificazioni della sicurezza e sul filtro dei contenuti. Sono riportate sia per la richiesta in GenerateContentResponse.prompt_feedback che per ogni candidato in finishReason e in safetyRatings. Il contratto relativo all'API è il seguente: - vengono restituiti tutti i candidati richiesti o nessun candidato - nessun candidato viene restituito solo se si è verificato un problema con la richiesta (vedi promptFeedback). I feedback relativi a ogni candidato vengono segnalati in data finishReason e safetyRatings.

Rappresentazione JSON 
{
  "candidates": [
    {
      object (Candidate)
    }
  ],
  "promptFeedback": {
    object (PromptFeedback)
  },
  "usageMetadata": {
    object (UsageMetadata)
  }
}
Campi
candidates[]

object (Candidate)

Risposte dei candidati del modello.
promptFeedback

object (PromptFeedback)

Restituisce il feedback del prompt relativo ai filtri per i contenuti.
usageMetadata

object (UsageMetadata)

Solo output. Metadati sull'utilizzo dei token delle richieste di generazione.

Candidato

Un candidato per la risposta generato dal modello.

Rappresentazione JSON 
{
  "content": {
    object (Content)
  },
  "finishReason": enum (FinishReason),
  "safetyRatings": [
    {
      object (SafetyRating)
    }
  ],
  "citationMetadata": {
    object (CitationMetadata)
  },
  "tokenCount": integer,
  "index": integer
}
Campi
content

object (Content)

Solo output. Contenuti generati restituiti dal modello.
finishReason

enum (FinishReason)

Campo facoltativo. Solo output. Il motivo per cui il modello ha smesso di generare token.

Se vuoto, il modello non ha smesso di generare i token.
safetyRatings[]

object (SafetyRating)

Elenco di classificazioni per la sicurezza di un candidato a una risposta.

Esiste al massimo una classificazione per categoria.
citationMetadata

object (CitationMetadata)

Solo output. Informazioni di citazione per il candidato generato dal modello.

Questo campo può essere compilato con informazioni sulle citazioni per qualsiasi testo incluso in content. Si tratta di passaggi che vengono "recitati" a partire da materiale protetto da copyright nei dati di addestramento dell'LLM di base.
tokenCount

integer

Solo output. Conteggio dei token per questo candidato.
index

integer

Solo output. Indice del candidato nell'elenco dei candidati.

FinishReason

Definisce il motivo per cui il modello ha smesso di generare token.

Enum
FINISH_REASON_UNSPECIFIED Valore predefinito. Questo valore non è utilizzato.
STOP Punto di interruzione naturale del modello o sequenza di interruzione fornita.
MAX_TOKENS È stato raggiunto il numero massimo di token specificato nella richiesta.
SAFETY I contenuti dei candidati sono stati segnalati per motivi di sicurezza.
RECITATION I contenuti dei candidati sono stati segnalati per motivi di recitazione.
OTHER Motivo sconosciuto.

SafetyRating

Valutazione della sicurezza di alcuni contenuti.

La valutazione di sicurezza contiene la categoria di danno e il livello di probabilità di danno in quella categoria per un determinato contenuto. I contenuti sono classificati per sicurezza in base a diverse categorie di danni e la probabilità della classificazione dei contenuti è inclusa qui.

Rappresentazione JSON 
{
  "category": enum (HarmCategory),
  "probability": enum (HarmProbability),
  "blocked": boolean
}
Campi
category

enum (HarmCategory)

Obbligatoria. La categoria di questa classificazione.
probability

enum (HarmProbability)

Obbligatoria. La probabilità di danni per questi contenuti.
blocked

boolean

I contenuti sono stati bloccati a causa della classificazione?

HarmProbability

La probabilità che un determinato contenuto sia dannoso.

Il sistema di classificazione dà la probabilità che i contenuti non siano sicuri. Ciò non indica la gravità del danno per un determinato contenuto.

Enum
HARM_PROBABILITY_UNSPECIFIED La probabilità non è specificata.
NEGLIGIBLE I contenuti hanno una probabilità trascurabile di non essere sicuri.
LOW I contenuti hanno una bassa probabilità di non essere sicuri.
MEDIUM I contenuti hanno una media probabilità di non essere sicuri.
HIGH I contenuti hanno un'alta probabilità di non essere sicuri.

CitationMetadata

Una raccolta di attribuzioni della fonte per un contenuto.

Rappresentazione JSON 
{
  "citationSources": [
    {
      object (CitationSource)
    }
  ]
}
Campi
citationSources[]

object (CitationSource)

Citazioni di fonti per una risposta specifica.

CitationSource

Una citazione a una fonte per una parte di una risposta specifica.

Rappresentazione JSON 
{
  "startIndex": integer,
  "endIndex": integer,
  "uri": string,
  "license": string
}
Campi
startIndex

integer

Campo facoltativo. Inizio del segmento della risposta attribuito a questa sorgente.

L'indice indica l'inizio del segmento, misurato in byte.
endIndex

integer

Campo facoltativo. Fine del segmento attribuito (escluso).
uri

string

Campo facoltativo. URI attribuito come origine per una parte del testo.
license

string

Campo facoltativo. Licenza per il progetto GitHub attribuito come origine del segmento.

Le informazioni sulla licenza sono obbligatorie per le citazioni di codici.

PromptFeedback

Un insieme di metadati dei feedback specificati dal prompt in GenerateContentRequest.content.

Rappresentazione JSON 
{
  "blockReason": enum (BlockReason),
  "safetyRatings": [
    {
      object (SafetyRating)
    }
  ]
}
Campi
blockReason

enum (BlockReason)

Campo facoltativo. Se impostato, la richiesta è stata bloccata e non vengono restituiti candidati. Riformula il prompt.
safetyRatings[]

object (SafetyRating)

Classificazioni per la sicurezza del prompt. Esiste al massimo una classificazione per categoria.

BlockReason

Specifica il motivo per cui la richiesta è stata bloccata.

Enum
BLOCK_REASON_UNSPECIFIED Valore predefinito. Questo valore non è utilizzato.
SAFETY Il prompt è stato bloccato per motivi di sicurezza. Puoi controllare safetyRatings per capire da quale categoria di sicurezza è stato bloccato.
OTHER Il prompt è stato bloccato per motivi sconosciuti.

UsageMetadata

Metadati sull'utilizzo dei token della richiesta di generazione.

Rappresentazione JSON 
{
  "promptTokenCount": integer,
  "candidatesTokenCount": integer,
  "totalTokenCount": integer
}
Campi
promptTokenCount

integer

Numero di token nel prompt. Quando è impostata l'impostazione cacheContent, si tratta comunque delle dimensioni effettive totali del prompt. Questo include il numero di token nei contenuti memorizzati nella cache.
candidatesTokenCount

integer

Numero totale di token tra i candidati generati.
totalTokenCount

integer

Conteggio totale dei token per la richiesta di generazione (prompt + candidati).