- Richiesta HTTP
- Parametri del percorso
- Corpo della richiesta
- Corpo della risposta
- Ambiti di autorizzazione
- GroundingPassages
- GroundingPassage
- SemanticRetrieverConfig
- AnswerStyle
- InputFeedback
- BlockReason
Genera una risposta basata su fondamento sul modello a partire da un input GenerateAnswerRequest
.
Richiesta HTTP
POST https://generativelanguage.googleapis.com/v1beta/{model=models/*}:generateAnswer
L'URL utilizza la sintassi di transcodifica gRPC.
Parametri del percorso
Parametri | |
---|---|
model |
obbligatorio. Il nome di Formato: |
Corpo della richiesta
Il corpo della richiesta contiene dati con la seguente struttura:
Rappresentazione JSON |
---|
{ "contents": [ { object ( |
Campi | |
---|---|
contents[] |
obbligatorio. I contenuti della conversazione corrente con il modello. Per le query in un solo passaggio, questa è una singola domanda a cui rispondere. Per le query in più passaggi, si tratta di un campo ripetuto contenente la cronologia delle conversazioni e l'ultimo Nota: model.generateAnswer al momento supporta solo le query in inglese. |
answerStyle |
obbligatorio. Stile in cui devono essere restituite le risposte. |
safetySettings[] |
Campo facoltativo. Un elenco di istanze Questa impostazione verrà applicata a |
Campo di unione grounding_source . Le fonti su cui fondare la risposta. grounding_source può essere solo uno dei seguenti: |
|
inlinePassages |
Passaggi forniti in linea con la richiesta. |
semanticRetriever |
Contenuti recuperati dalle risorse create tramite l'API Semantic Retriever. |
temperature |
Campo facoltativo. Controlla la casualità dell'output. I valori possono variare da [0,0,1,0] inclusi. Un valore più vicino a 1,0 produce risposte più variegate e creative, mentre un valore più vicino a 0,0 produce in genere risposte più dirette da parte del modello. In genere è consigliata una temperatura bassa (~0,2) per i casi d'uso della risposta alle domande attribuite. |
Corpo della risposta
Risposta dal modello per una risposta fondata.
In caso di esito positivo, il corpo della risposta contiene dati con la seguente struttura:
Rappresentazione JSON |
---|
{ "answer": { object ( |
Campi | |
---|---|
answer |
Risposta del candidato dal modello. Nota: il modello cerca sempre di fornire una risposta legittima, anche quando è improbabile che sia possibile rispondere alla risposta in base ai passaggi indicati. In questo caso, potrebbe essere fornita una risposta di bassa qualità o infondata, insieme a un valore basso di |
answerableProbability |
Solo output. Stima del modello della probabilità che la sua risposta sia corretta e basata sui passaggi di input. Un valore answerableProbability basso indica che la risposta potrebbe non essere radicata nelle fonti. Quando il valore di
|
inputFeedback |
Solo output. Feedback relativo ai dati di input utilizzati per rispondere alla domanda, anziché la risposta generata da un modello. I "Dati di input" possono essere uno o più dei seguenti:
|
Ambiti di autorizzazione
Richiede uno dei seguenti ambiti OAuth:
https://www.googleapis.com/auth/generative-language
https://www.googleapis.com/auth/generative-language.retriever
https://www.googleapis.com/auth/generative-language.retriever.readonly
https://www.googleapis.com/auth/generative-language.tuning
https://www.googleapis.com/auth/generative-language.tuning.readonly
Per ulteriori informazioni, consulta la Panoramica dell'autenticazione.
GroundingPassages
Un elenco ripetuto di passaggi.
Rappresentazione JSON |
---|
{
"passages": [
{
object ( |
Campi | |
---|---|
passages[] |
Elenco dei passaggi. |
GroundingPassage
Passaggio incluso in linea con una configurazione di grounding.
Rappresentazione JSON |
---|
{
"id": string,
"content": {
object ( |
Campi | |
---|---|
id |
Identificatore del passaggio per l'attribuzione di questo passaggio nelle risposte basate su fondamenta. |
content |
Contenuto del passaggio. |
SemanticRetrieverConfig
Configurazione per il recupero di contenuti di grounding da un elemento Corpus
o Document
creato utilizzando l'API Semantic Retriever.
Rappresentazione JSON |
---|
{ "source": string, "query": { object ( |
Campi | |
---|---|
source |
obbligatorio. Nome della risorsa per il recupero, ad esempio corpora/123 o corpora/123/documents/abc. |
query |
obbligatorio. Query da utilizzare per la corrispondenza della somiglianza |
metadataFilters[] |
Campo facoltativo. Filtri per la selezione di |
maxChunksCount |
Campo facoltativo. Numero massimo di |
minimumRelevanceScore |
Campo facoltativo. Punteggio di pertinenza minimo per gli elementi |
AnswerStyle
Definisci uno stile per le risposte basate su dati concreti.
Enum | |
---|---|
ANSWER_STYLE_UNSPECIFIED |
Stile di risposta non specificato. |
ABSTRACTIVE |
Stile succinto ma astratto. |
EXTRACTIVE |
Stile molto breve ed estrattivo. |
VERBOSE |
Stile dettagliato con dettagli aggiuntivi. La risposta può essere formattata come una frase, un paragrafo, più paragrafi, elenchi puntati e così via. |
InputFeedback
Feedback relativo ai dati di input utilizzati per rispondere alla domanda, anziché la risposta generata da un modello.
Rappresentazione JSON |
---|
{ "safetyRatings": [ { object ( |
Campi | |
---|---|
safetyRatings[] |
Valutazioni relative alla sicurezza dell'input. È presente al massimo una valutazione per categoria. |
blockReason |
Campo facoltativo. Se impostato, l'input è stato bloccato e non vengono restituiti candidati. Riformula l'input. |
BlockReason
Specifica il motivo per cui l'input è stato bloccato.
Enum | |
---|---|
BLOCK_REASON_UNSPECIFIED |
Valore predefinito. Questo valore non è utilizzato. |
SAFETY |
L'input è stato bloccato per motivi di sicurezza. Puoi esaminare safetyRatings per capire quale categoria di sicurezza l'ha bloccato. |
OTHER |
L'input è stato bloccato per altri motivi. |