Intent
Mit Sammlungen den Überblick behalten
Sie können Inhalte basierend auf Ihren Einstellungen speichern und kategorisieren.
Intents ordnen offene Nutzereingaben strukturierten Objekten zu. Gesprochene Wortgruppen werden mithilfe von Natural Language Understanding (NLU) Intents zugeordnet. Intent-Übereinstimmungen können Ereignisse in Ihrem Unterhaltungsdesign auslösen, um die Unterhaltung des Nutzers voranzutreiben. Der Intent-Name wird im Namen der Datei angegeben.
| YAML-Darstellung |
parameters:
- object (IntentParameter)
trainingPhrases:
- string |
| Felder |
parameters[] |
object (IntentParameter)
Die Liste der Parameter in den Trainingsformulierungen. Hier müssen alle Parameter definiert werden, damit sie in der Trainingsformulierung verwendet werden können.
|
trainingPhrases[] |
string
Trainingsformulierungen ermöglichen es der NLU von Google, Intents automatisch mit Nutzereingaben abzugleichen. Je mehr eindeutige Wortgruppen angegeben sind, desto höher ist die Wahrscheinlichkeit, dass dieser Intent zugeordnet wird. Im Folgenden finden Sie das Format der Trainingsformulierungen, die annotiert sind. Das Feld auto ist optional und das Standardverhalten, wenn auto nicht angegeben ist, entspricht auto=false. ($<paramName> '<sample text>' auto=<true or false>) auto = true bedeutet, dass der Teil automatisch von NLU annotiert wurde. auto = false bedeutet, dass der Teil vom Nutzer mit einer Anmerkung versehen wurde. Dies ist die Standardeinstellung, wenn „auto“ nicht festgelegt ist. Beispiel: "Buchen Sie einen Flug von ($source 'San Francisco' auto=false) nach ($dest 'Vancouver')"
|
IntentParameter
Definition eines Parameters, der in Trainingsformulierungen verwendet werden kann.
| YAML-Darstellung |
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. |
| Felder |
name |
string
Erforderlich. Eindeutiger Name des Intent-Parameters. Kann in Bedingungen und Antworten verwendet werden, um auf von NLU mit $intent.params.[name].resolved extrahierte Intent-Parameter zu verweisen.
|
Union-Feld parameter_type. Der Typ des Intent-Parameters. Für parameter_type ist nur einer der folgenden Werte zulässig: |
type |
object (ClassReference)
Optional. Deklariert den Datentyp dieses Parameters. Für integrierte Intents sollte dies nicht festgelegt werden.
|
entitySetReferences |
object (EntitySetReferences)
Optional. Verweise auf die Gruppen zulässiger Entitäten für diesen Intent-Parameter. Nur gültig für die Parameter eines integrierten Intents. Diese Verweise verweisen auf Entitäts-Sets in „custom/entitySets“ -Verzeichnis.
|
EntitySetReferences
Entitäts-Set-Referenzen für einen Intent-Parameter
| Felder |
entitySetReferences[] |
object (EntitySetReference)
Erforderlich. Entitäts-Set-Referenzen für einen Intent-Parameter
|
EntitySetReference
Ein Verweis auf die Gruppe zulässiger Entitäten für diesen Intent-Parameter.
| YAML-Darstellung |
entitySet: string |
| Felder |
entitySet |
string
Erforderlich. Gibt die spezifische Sammlung von Entitäten an, die für einen bestimmten Parameter zu berücksichtigen ist. Die entsprechende Entitäts-Set-Definition muss im Verzeichnis „custom/entitySets/“ vorhanden sein.
|
Sofern nicht anders angegeben, sind die Inhalte dieser Seite unter der Creative Commons Attribution 4.0 License und Codebeispiele unter der Apache 2.0 License lizenziert. Weitere Informationen finden Sie in den Websiterichtlinien von Google Developers. Java ist eine eingetragene Marke von Oracle und/oder seinen Partnern.
Zuletzt aktualisiert: 2025-07-26 (UTC).
[null,null,["Zuletzt aktualisiert: 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. |"]]
