Intent
Restez organisé à l'aide des collections
Enregistrez et classez les contenus selon vos préférences.
Les intents mappent les entrées utilisateur ouvertes avec des objets structurés. Les expressions vocales sont mises en correspondance avec des intents à l'aide de la technologie Natural Language Understanding (NLU) de Google. Les correspondances d'intent peuvent déclencher des événements dans la conception de votre conversation pour faire avancer la conversation de l'utilisateur. Le nom de l'intent est spécifié dans le nom du fichier.
| Représentation YAML |
parameters:
- object (IntentParameter)
trainingPhrases:
- string |
| Champs |
parameters[] |
object (IntentParameter)
Liste des paramètres dans les phrases d'entraînement. Tous les paramètres doivent être définis ici pour pouvoir être utilisés dans la phrase d'entraînement.
|
trainingPhrases[] |
string
Les phrases d'entraînement permettent à la NLU de Google de mettre automatiquement en correspondance les intents avec les entrées utilisateur. Plus le nombre d'expressions uniques fournies est important, plus cet intent a de chances d'être mis en correspondance. Voici le format de la partie de phrase d'entraînement annotée. Notez que le champ auto est facultatif et que le comportement par défaut lorsque auto n'est pas spécifié est équivalent à auto=false. ($<paramName> '<sample text>' auto=<true or false>) auto = true signifie que la partie a été annotée automatiquement par NLU. auto = false signifie que la partie a été annotée par l'utilisateur. Il s'agit de la valeur par défaut lorsque le mode automatique n'est pas spécifié. Exemple : "Réserver un vol de ($source 'San Francisco' auto=false) à ($dest 'Vancouver')"
|
IntentParameter
Définition d'un paramètre pouvant être utilisé dans les phrases d'entraînement.
| Représentation YAML |
name: string
# Union field parameter_type can be only one of the following:
type:
object (ClassReference)
entitySetReferences:
object (EntitySetReferences)
# End of list of possible types for union field parameter_type. |
| Champs |
name |
string
Obligatoire. Nom unique du paramètre d'intent. Peut être utilisé dans les conditions et les réponses pour référencer des paramètres d'intent extraits par la NLU avec $intent.params.[name].resolved
|
Champ d'union parameter_type. Type du paramètre d'intent. parameter_type ne peut être qu'un des éléments suivants : |
type |
object (ClassReference)
Facultatif. Déclare le type de données de ce paramètre. Cette valeur ne doit pas être définie pour les intents intégrés.
|
entitySetReferences |
object (EntitySetReferences)
Facultatif. Références aux ensembles d'entités autorisées pour ce paramètre d'intent. N'est valide que pour les paramètres d'un intent intégré. Ces références pointent vers les ensembles d'entités de l'ensemble "custom/entitySets" .
|
EntitySetReferences
Références d'ensembles d'entités pour un paramètre d'intent.
| Champs |
entitySetReferences[] |
object (EntitySetReference)
Obligatoire. Références d'ensembles d'entités pour un paramètre d'intent.
|
EntitySetReference
Référence à l'ensemble des entités autorisées pour ce paramètre d'intent.
| Représentation YAML |
entitySet: string |
| Champs |
entitySet |
string
Obligatoire. Identifie la collection spécifique d'entités à prendre en compte pour un paramètre donné. La définition de l'ensemble d'entités correspondant doit figurer dans le répertoire custom/entitySets/.
|
Sauf indication contraire, le contenu de cette page est régi par une licence Creative Commons Attribution 4.0, et les échantillons de code sont régis par une licence Apache 2.0. Pour en savoir plus, consultez les Règles du site Google Developers. Java est une marque déposée d'Oracle et/ou de ses sociétés affiliées.
Dernière mise à jour le 2025/07/26 (UTC).
[null,null,["Dernière mise à jour le 2025/07/26 (UTC)."],[[["\u003cp\u003eIntents utilize Google's Natural Language Understanding (NLU) to match spoken phrases with user input, triggering events within a conversation design.\u003c/p\u003e\n"],["\u003cp\u003eIntent parameters are defined within training phrases, specifying data types and referencing allowed entities for built-in intents.\u003c/p\u003e\n"],["\u003cp\u003eEntity set references identify specific collections of entities for a given parameter, linking to definitions in the custom/entitySets/ directory.\u003c/p\u003e\n"],["\u003cp\u003eTraining phrases, incorporating parameters and entity references, enable Google's NLU to accurately match intents with user input, improving the conversational experience.\u003c/p\u003e\n"]]],[],null,["# Intent\n\n- [YAML representation](#SCHEMA_REPRESENTATION)\n- [IntentParameter](#IntentParameter)\n - [YAML representation](#IntentParameter.SCHEMA_REPRESENTATION)\n- [EntitySetReferences](#EntitySetReferences)\n - [YAML representation](#EntitySetReferences.SCHEMA_REPRESENTATION)\n- [EntitySetReference](#EntitySetReference)\n - [YAML representation](#EntitySetReference.SCHEMA_REPRESENTATION)\n\nIntents map open-ended user input to structured objects. Spoken phrases are matched to intents with Google's Natural Language Understanding (NLU). Intent matches can trigger events in your conversation design to progress the user's conversation. The intent name is specified in the name of the file.\n\n| YAML representation ||\n|-----------------------------------------------------------------------------------------------------------------------------------|---|\n| ``` parameters: - object (/assistant/actionssdk/reference/rest/Shared.Types/Intent#IntentParameter) trainingPhrases: - string ``` |\n\n| Fields ||\n|---------------------|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `parameters[]` | `object (`[IntentParameter](/assistant/actionssdk/reference/rest/Shared.Types/Intent#IntentParameter)`)` The list of parameters within the training phrases. All parameters must be defined here to be used in the training phrase. |\n| `trainingPhrases[]` | `string` Training phrases allow Google's NLU to automatically match intents with user input. The more unique phrases that are provided, the better chance this intent will be matched. The following is the format of training phrase part which are annotated. Note that `auto` field is optional and the default behavior when `auto` is not specified is equivalent to `auto=false`. `($\u003cparamName\u003e '\u003csample text\u003e' auto=\u003ctrue or false\u003e)` `auto = true` means the part was auto annotated by NLU. `auto = false` means the part was annotated by the user. This is the default when auto is not specified. Example: \"Book a flight from ($source 'San Francisco' auto=false) to ($dest 'Vancouver')\" |\n\nIntentParameter\n---------------\n\nDefinition of a parameter which can be used inside training phrases.\n\n| YAML representation ||\n|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|---|\n| ``` name: string # Union field `parameter_type` can be only one of the following: type: object (/assistant/actionssdk/reference/rest/Shared.Types/ClassReference) entitySetReferences: object (/assistant/actionssdk/reference/rest/Shared.Types/Intent#EntitySetReferences) # End of list of possible types for union field `parameter_type`. ``` |\n\n| Fields ||\n|-----------------------|------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|---|\n| `name` | `string` Required. Unique name of the intent parameter. Can be used in conditions and responses to reference intent parameters extracted by NLU with $intent.params.\\[name\\].resolved |\n| Union field `parameter_type`. The type of the intent parameter. `parameter_type` can be only one of the following: |||\n| `type` | `object (`[ClassReference](/assistant/actionssdk/reference/rest/Shared.Types/ClassReference)`)` Optional. Declares the data type of this parameter. This should not be set for built-in intents. |\n| `entitySetReferences` | `object (`[EntitySetReferences](/assistant/actionssdk/reference/rest/Shared.Types/Intent#EntitySetReferences)`)` Optional. References to the sets of allowed entities for this intent parameter. Only valid for parameters of a built-in intent. These references point to entity sets in the 'custom/entitySets' directory. |\n\nEntitySetReferences\n-------------------\n\nEntity set references for an intent parameter.\n\n| YAML representation ||\n|---------------------------------------------------------------------------------------------------------------------|---|\n| ``` entitySetReferences: - object (/assistant/actionssdk/reference/rest/Shared.Types/Intent#EntitySetReference) ``` |\n\n| Fields ||\n|-------------------------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `entitySetReferences[]` | `object (`[EntitySetReference](/assistant/actionssdk/reference/rest/Shared.Types/Intent#EntitySetReference)`)` Required. Entity set references for an intent parameter. |\n\nEntitySetReference\n------------------\n\nA reference to the set of allowed entities for this intent parameter.\n\n| YAML representation ||\n|---------------------------|---|\n| ``` entitySet: string ``` |\n\n| Fields ||\n|-------------|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `entitySet` | `string` Required. Identifies the specific collection of entities to be considered for a given parameter. The corresponding entity set definition should be present in the custom/entitySets/ directory. |"]]
