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

Converses a conversation.

Requête HTTP

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

L'URL utilise la syntaxe de transcodage gRPC.

Paramètres de chemin d'accès

Paramètres
name

string

Obligatoire. Nom de ressource de la conversation à récupérer. Format : projects/{project}/locations/{location}/collections/{collection}/dataStores/{dataStoreId}/conversations/{conversationId}. Utilisez projects/{project}/locations/{location}/collections/{collection}/dataStores/{dataStoreId}/conversations/- pour activer le mode session automatique, qui crée automatiquement une conversation dans une session conversations.converse.

Corps de la requête

Le corps de la requête contient des données présentant la structure suivante :

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

object (TextInput)

Obligatoire. Entrée utilisateur actuelle.
servingConfig

string

Nom de ressource de la configuration de diffusion à utiliser. Format : projects/{project}/locations/{location}/collections/{collection}/dataStores/{dataStoreId}/servingConfigs/{servingConfigId}. Si cette valeur n'est pas définie, la configuration de diffusion par défaut sera utilisée.
conversation

object (Conversation)

Conversation à utiliser par la session automatique uniquement. Le champ du nom sera ignoré, car nous attribuons automatiquement un nouveau nom à la conversation dans la session automatique.
userLabels

map (key: string, value: string)

Les libellés utilisateur appliqués à une ressource doivent répondre aux exigences suivantes :

  • Chaque ressource peut posséder plusieurs libellés, jusqu'à un maximum de 64.
  • Chaque étiquette doit correspondre à une paire clé/valeur.
  • Les clés doivent comporter un (1) caractère au minimum et 63 au maximum, et ne peuvent pas être vides. Les valeurs peuvent être vides et comporter 63 caractères au maximum.
  • Les clés et les valeurs ne peuvent contenir que des lettres minuscules, des chiffres, des traits de soulignement et des tirets. Tous les caractères doivent être au format d'encodage UTF-8. Les caractères internationaux sont autorisés.
  • La partie clé d'un libellé doit être unique. Cependant, vous pouvez utiliser la même clé avec plusieurs ressources.
  • Les clés doivent commencer par une lettre minuscule ou un caractère international.

Pour en savoir plus, consultez la documentation Google Cloud.
summarySpec

object (SummarySpec)

Spécification permettant de configurer le récapitulatif renvoyé dans la réponse.
filter

string

La syntaxe des filtres consiste en un langage d'expression permettant de construire un prédicat à partir d'un ou de plusieurs champs des documents filtrés. L'expression de filtre est sensible à la casse. Il sera utilisé pour filtrer les résultats de recherche, ce qui peut avoir une incidence sur la réponse récapitulative.

Si ce champ n'est pas reconnaissable, un INVALID_ARGUMENT est renvoyé.

Le filtrage dans Vertex AI Search s'effectue en mappant la clé de filtre LHS à une propriété clé définie dans le backend Vertex AI Search. Ce mappage est défini par le client dans son schéma. Par exemple, un client média peut avoir un champ "name" (nom) dans son schéma. Dans ce cas, le filtre se présenterait comme suit : filter --> name:'ANY("king kong")`

Pour en savoir plus sur le filtrage, y compris sur la syntaxe et les opérateurs de filtre, consultez Filtrer.
boostSpec

object (BoostSpec)

Spécification d'augmentation pour mettre en avant certains documents dans les résultats de recherche, ce qui peut avoir une incidence sur la réponse de la conversation. Pour en savoir plus sur l'amplification, consultez Amplification.

Corps de la réponse

Si la requête aboutit, le corps de la réponse contient une instance de ConverseConversationResponse.

Niveaux d'accès des autorisations

Nécessite l'un des champs d'application OAuth suivants :

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

Pour plus d'informations, consultez la Authentication Overview.

Autorisations IAM

Nécessite l'autorisation IAM suivante sur la ressource name :

  • discoveryengine.conversations.converse

Pour en savoir plus, consultez la documentation IAM.