Method: projects.matchIntents

Recherche les intents correspondant à une requête donnée.

Requête HTTP

POST https://actions.googleapis.com/v2/{project=projects/*}:matchIntents

L'URL utilise la syntaxe de transcodage gRPC.

Paramètres de chemin d'accès

Paramètres
project

string

Obligatoire. Projet testé, indiqué par l'ID du projet Format: projects/{project}

Corps de la requête

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

Représentation JSON
{
  "query": string,
  "locale": string
}
Champs
query

string

Obligatoire. Requête de l'utilisateur en texte brut.

locale

string

Obligatoire. Paramètres régionaux à utiliser pour évaluer la requête, tels que "en". Le format doit respecter la norme BCP 47: https://tools.ietf.org/html/bcp47. Consultez la liste des langues compatibles sur https://developers.google.com/assistant/console/languages-locales.

Corps de la réponse

Si la requête aboutit, le corps de la réponse contient des données qui ont la structure suivante :

Réponse pour la recherche d'intents correspondants.

Représentation JSON
{
  "matchedIntents": [
    {
      object (Intent)
    }
  ]
}
Champs
matchedIntents[]

object (Intent)

Intents mis en correspondance, classés du plus pertinent au moins pertinent. Seules les 50 premières correspondances sont renvoyées.

Intention

Représente un intent.

Représentation JSON
{
  "name": string,
  "params": {
    string: {
      object (IntentParameterValue)
    },
    ...
  },
  "query": string
}
Champs
name

string

Obligatoire. Nom du dernier intent mis en correspondance.

params

map (key: string, value: object (IntentParameterValue))

Obligatoire. Représente les paramètres identifiés dans le cadre de la mise en correspondance des intents. Il s'agit d'un mappage du nom du paramètre identifié avec la valeur du paramètre identifié à partir de l'entrée utilisateur. Tous les paramètres définis dans l'intent correspondant qui sont identifiés sont affichés ici.

Objet contenant une liste de paires "key": value. Exemple : { "name": "wrench", "mass": "1.3kg", "count": "3" }.

query

string

Facultatif. Entrée saisie ou prononcée par l'utilisateur final correspondant à cet intent. Ce champ est renseigné lorsqu'un intent est mis en correspondance, en fonction de l'entrée utilisateur.