Method: corpora.query

Esegue la ricerca semantica su un elemento Corpus.

Richiesta HTTP

POST https://generativelanguage.googleapis.com/v1beta/{name=corpora/*}:query

L'URL utilizza la sintassi di transcodifica gRPC.

Parametri del percorso

Parametri
name

string

Obbligatorio. Il nome dell'oggetto Corpus su cui eseguire la query. Esempio: corpora/my-corpus-123

Corpo della richiesta

Il corpo della richiesta contiene dati con la seguente struttura:

Rappresentazione JSON 
{
  "query": string,
  "metadataFilters": [
    {
      object (MetadataFilter)
    }
  ],
  "resultsCount": integer
}
Campi
query

string

Obbligatorio. Stringa di query per eseguire la ricerca semantica.
metadataFilters[]

object (MetadataFilter)

Campo facoltativo. Filtra in base ai metadati Chunk e Document. Ogni oggetto MetadataFilter deve corrispondere a una chiave univoca. Più oggetti MetadataFilter sono uniti da "AND" logici.

Esempio di query a livello di documento: (anno >= 2020 OR anno < 2010) AND (genere = drammatico OR genere = azione)

MetadataFilter elenco di oggetti: metadataFiltri = [ {key = "document.custom_metadata.year" terms = [{int_value = 2020, Operation = GREATER_EQUAL}, {int_value = 2010, Operation = LESS}]}, {key = "document.custom_metadata.year" terms = [{int_value = 2020,operation = GREATER_EQUAL}, {int_value = 2010, Operation = LESS}]}, {key = "document.custom_metadata.year" terms = [{int_value = 2020, Operation = GREATER_EQUAL}, {int_value = 2010,operation = LESS}]}, {key = "document.custom_metadata.year} condizioni = [{int_value0, EQUAL_value}condizioni}

Esempio di query a livello di blocco per un intervallo numerico di valori: (anno > 2015 AND anno <= 2020)

Elenco di oggetti MetadataFilter: metadataFiltri = [ {key = condizioni "chunk.custom_metadata.year" = [{int_value = 2015, Operation = GREATER}]}, {key = "chunk.custom_metadata.year" condizioni = [{int_value = 2020, operazione = LESS_EQUAL}]}]

Nota: gli "AND" per la stessa chiave sono supportati solo per i valori numerici. I valori stringa supportano solo gli operatori "OR" per la stessa chiave.
resultsCount

integer

Campo facoltativo. Il numero massimo di Chunk da restituire. Il servizio potrebbe restituire meno Chunk.

Se non specificato, verranno restituiti al massimo 10 Chunk. Il numero massimo di risultati specificato è 100.

Corpo della risposta

Risposta da corpora.query contenente un elenco di blocchi pertinenti.

In caso di esito positivo, il corpo della risposta contiene dati con la seguente struttura:

Rappresentazione JSON 
{
  "relevantChunks": [
    {
      object (RelevantChunk)
    }
  ]
}
Campi
relevantChunks[]

object (RelevantChunk)

I blocchi pertinenti.

Ambiti di autorizzazione

Richiede uno dei seguenti ambiti OAuth:

  • https://www.googleapis.com/auth/generative-language.retriever
  • https://www.googleapis.com/auth/generative-language.retriever.readonly

Per ulteriori informazioni, consulta la Panoramica dell'autenticazione.