Method: projects.locations.collections.engines.conversations.converse

Converte una conversazione.

Richiesta HTTP

POST https://discoveryengine.googleapis.com/v1/{name=projects/*/locations/*/collections/*/engines/*/conversations/*}:converse

L'URL utilizza la sintassi di transcodifica gRPC.

Parametri del percorso

Parametri
name

string

Obbligatorio. Il nome della risorsa della conversazione da recuperare. Formato: projects/{project}/locations/{location}/collections/{collection}/dataStores/{dataStoreId}/conversations/{conversationId}. Utilizza projects/{project}/locations/{location}/collections/{collection}/dataStores/{dataStoreId}/conversations/- per attivare la modalità sessione automatica, che crea automaticamente una nuova conversazione all'interno di una sessione conversations.converse.

Corpo della richiesta

Il corpo della richiesta contiene dati con la seguente struttura:

Rappresentazione JSON 
{
  "query": {
    object (TextInput)
  },
  "servingConfig": string,
  "conversation": {
    object (Conversation)
  },
  "safeSearch": boolean,
  "userLabels": {
    string: string,
    ...
  },
  "summarySpec": {
    object (SummarySpec)
  },
  "filter": string,
  "boostSpec": {
    object (BoostSpec)
  }
}
Campi
query

object (TextInput)

Obbligatorio. Input utente corrente.
servingConfig

string

Il nome risorsa della configurazione di pubblicazione da utilizzare. Formato: projects/{project}/locations/{location}/collections/{collection}/dataStores/{dataStoreId}/servingConfigs/{servingConfigId} Se questo valore non è impostato, verrà utilizzata la configurazione di pubblicazione predefinita.
conversation

object (Conversation)

La conversazione da utilizzare solo per la sessione automatica. Il campo del nome verrà ignorato perché assegniamo automaticamente un nuovo nome alla conversazione nella sessione automatica.
userLabels

map (key: string, value: string)

Le etichette utente applicate a una risorsa devono soddisfare i seguenti requisiti:

  • Ogni risorsa può avere più etichette, fino a un massimo di 64.
  • Ogni etichetta deve essere una coppia chiave-valore.
  • Le chiavi hanno una lunghezza minima di 1 carattere e una lunghezza massima di 63 caratteri e non possono essere vuote. I valori possono essere vuoti e avere una lunghezza massima di 63 caratteri.
  • Le chiavi e i valori possono contenere solo lettere minuscole, caratteri numerici, trattini bassi e trattini. Tutti i caratteri devono utilizzare la codifica UTF-8 e sono consentiti i caratteri internazionali.
  • La parte della chiave di un'etichetta deve essere univoca. Tuttavia, puoi utilizzare la stessa chiave con più risorse.
  • Le chiavi devono iniziare con una lettera minuscola o un carattere internazionale.

Per ulteriori dettagli, consulta il documento Google Cloud.
summarySpec

object (SummarySpec)

Una specifica per la configurazione del riepilogo restituito nella risposta.
filter

string

La sintassi del filtro è costituita da un linguaggio di espressione per costruire un predicato da uno o più campi dei documenti da filtrare. L'espressione del filtro è sensibile alle maiuscole. Verrà utilizzato per filtrare i risultati di ricerca, il che potrebbe influire sulla risposta riepilogativa.

Se questo campo non è riconoscibile, viene restituito un INVALID_ARGUMENT.

Il filtro in Vertex AI Search viene eseguito mappando la chiave del filtro LHS a una proprietà chiave definita nel backend di Vertex AI Search. Questa mappatura viene definita dal cliente nello schema. Ad esempio, un cliente del settore dei media potrebbe avere un campo "nome" nel proprio schema. In questo caso, il filtro sarà simile a questo: filter --> name:'ANY("king kong")'

Per saperne di più sul filtraggio, inclusi sintassi e operatori di filtro, consulta Filtro.
boostSpec

object (BoostSpec)

Specifica del boost per aumentare il ranking di determinati documenti nei risultati di ricerca, il che potrebbe influire sulla risposta inversa. Per ulteriori informazioni sul boosting, consulta la sezione Boosting.

Corpo della risposta

In caso di esito positivo, il corpo della risposta contiene un'istanza di ConverseConversationResponse.

Ambiti di autorizzazione

Richiede uno dei seguenti ambiti OAuth:

  • https://www.googleapis.com/auth/cloud-platform
  • https://www.googleapis.com/auth/discoveryengine.readwrite

Per ulteriori informazioni, consulta Authentication Overview.

Autorizzazioni IAM

Richiede la seguente autorizzazione IAM per la risorsa name:

  • discoveryengine.conversations.converse

Per saperne di più, consulta la documentazione di IAM.