GenerateContentResponse

Risposta da parte del modello che supporta più candidati.

Nota sulle classificazioni di sicurezza e sul filtro dei contenuti. Vengono registrati sia per il prompt in GenerateContentResponse.prompt_feedback che per ogni candidato in finishReason e in safetyRatings. Il contratto API prevede che: - vengano restituiti tutti i candidati richiesti o non vengano restituiti candidati - non vengono restituiti candidati solo se si è verificato un problema nel prompt (vedi promptFeedback) - nei giorni finishReason e safetyRatings viene segnalato il feedback su ciascun candidato.

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

object (Candidate)

Risposte dei candidati dal modello.
promptFeedback

object (PromptFeedback)

Restituisce il feedback della richiesta relativo ai filtri dei contenuti.

Candidato

Una risposta candidata generata 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 valutazioni per la sicurezza di un candidato alla risposta.

È presente al massimo una classificazione per categoria.
citationMetadata

object (CitationMetadata)

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

Questo campo può essere compilato con informazioni sulla recitazione per qualsiasi testo incluso in content. Si tratta di passaggi "recitati" da materiale protetto da copyright nei dati di addestramento degli LLM di base.
tokenCount

integer

Solo output. Numero di token per questo candidato.
index

integer

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

FinishReason

Definisce il motivo per cui il modello ha interrotto la generazione di token.

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

SafetyRating

Valutazione di sicurezza di un contenuto.

La classificazione di sicurezza contiene la categoria di danno e il livello di probabilità di danno in quella categoria per un contenuto. I contenuti sono classificati come sicurezza in base a una serie di categorie di danno e qui è inclusa la probabilità di classificazione del danno.

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

enum (HarmCategory)

Obbligatorio. La categoria di questa valutazione.
probability

enum (HarmProbability)

Obbligatorio. La probabilità di danno per questi contenuti.
blocked

boolean

Questi contenuti sono stati bloccati a causa di questa classificazione?

HarmProbability

La probabilità che un contenuto sia dannoso.

Il sistema di classificazione indica la probabilità che i contenuti non siano sicuri. Ciò non indica la gravità del danno per una parte dei contenuti.

Enum
HARM_PROBABILITY_UNSPECIFIED La probabilità non è specificata.
NEGLIGIBLE I contenuti hanno una possibilità trascurabile di essere non sicuri.
LOW I contenuti hanno una bassa probabilità di essere non sicuri.
MEDIUM I contenuti hanno una media probabilità di non essere sicuri.
HIGH È molto probabile che i contenuti non siano sicuri.

CitationMetadata

Una raccolta di attribuzioni della fonte di un contenuto.

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

object (CitationSource)

Citazioni alle fonti per una risposta specifica.

CitationSource

La citazione di 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 di 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 dei codici.

PromptFeedback

Un set di metadati del feedback che il prompt specificato in GenerateContentRequest.content.

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

enum (BlockReason)

Campo facoltativo. Se impostato, il prompt è stato bloccato e non vengono restituiti candidati. Riformula il prompt.
safetyRatings[]

object (SafetyRating)

Valutazioni relative alla sicurezza del prompt. È presente 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 La richiesta è stata bloccata per motivi di sicurezza. Puoi esaminare safetyRatings per capire quale categoria di sicurezza l'ha bloccato.
OTHER Il prompt è stato bloccato a causa di motivi sconosciuti.