Intent
Zadbaj o dobrą organizację dzięki kolekcji
Zapisuj i kategoryzuj treści zgodnie ze swoimi preferencjami.
Intencje mapują otwarte dane wejściowe użytkownika na uporządkowane obiekty. Głosowe wyrażenia są dopasowywane do intencji użytkownika za pomocą opracowanego przez Google systemu rozumienia języka naturalnego (NLU). Dopasowanie intencji może wywoływać zdarzenia w projekcie rozmowy w celu postępów w rozmowie użytkownika. Nazwa intencji jest podana w nazwie pliku.
| Reprezentacja YAML |
parameters:
- object (IntentParameter)
trainingPhrases:
- string |
| Pola |
parameters[] |
object (IntentParameter)
Lista parametrów w wyrażeniach na potrzeby trenowania. Aby można było używać ich w wyrażeniu na potrzeby trenowania, musisz tutaj zdefiniować wszystkie parametry.
|
trainingPhrases[] |
string
Wyrażenia na potrzeby trenowania pozwalają NLU Google automatycznie dopasować intencje do danych wejściowych użytkownika. Im więcej unikalnych wyrażeń podasz, tym większa szansa na dopasowanie intencji. Poniżej znajduje się format części wyrażenia na potrzeby trenowania, która jest oznaczona adnotacjami. Pamiętaj, że pole auto jest opcjonalne, a domyślne działanie, gdy nie określono ustawienia auto, jest równoważne z wartością auto=false. ($<paramName> '<sample text>' auto=<true or false>) auto = true oznacza, że część została automatycznie oznaczona adnotacją przez NLU. auto = false oznacza, że użytkownik dodał adnotacje do części. Jest to ustawienie domyślne, jeśli nie określono ustawienia automatycznego. Przykład: „Zarezerwuj lot z ($source 'Warszawa' auto=false) do ($dest 'Vancouver')'.
|
IntentParameter
Definicja parametru, którego można używać w wyrażeniach na potrzeby trenowania.
| Reprezentacja 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. |
| Pola |
name |
string
Wymagane. Unikalna nazwa parametru intencji. Można go używać w warunkach i odpowiedziach, aby odwołać się do parametrów intencji wyodrębnionych przez NLU z parametrem $intent.params.[nazwa].rozstrzygnięty
|
Pole sumy parameter_type. Typ parametru intencji. parameter_type może mieć tylko jedną z tych wartości: |
type |
object (ClassReference)
Opcjonalnie: Deklaruje typ danych tego parametru. Nie należy go ustawiać w przypadku intencji wbudowanych.
|
entitySetReferences |
object (EntitySetReferences)
Opcjonalnie: Odniesienia do zbiorów dozwolonych encji dla tego parametru intencji. Tej formuły można użyć tylko w przypadku parametrów intencji wbudowanej. Te odwołania wskazują na zestawy encji w elemencie „custom/entitySets” katalogu.
|
EntitySetReferences
Odniesienia do zestawu encji dla parametru intencji.
| Pola |
entitySetReferences[] |
object (EntitySetReference)
Wymagane. Odniesienia do zestawu encji dla parametru intencji.
|
EntitySetReference
Odwołanie do zbioru dozwolonych encji dla tego parametru intencji.
| Reprezentacja YAML |
entitySet: string |
| Pola |
entitySet |
string
Wymagane. Określa określony zbiór encji, które mają być uwzględniane w przypadku danego parametru. Odpowiednia definicja zestawu encji powinna znajdować się w katalogu custom/entitySets/.
|
O ile nie stwierdzono inaczej, treść tej strony jest objęta licencją Creative Commons – uznanie autorstwa 4.0, a fragmenty kodu są dostępne na licencji Apache 2.0. Szczegółowe informacje na ten temat zawierają zasady dotyczące witryny Google Developers. Java jest zastrzeżonym znakiem towarowym firmy Oracle i jej podmiotów stowarzyszonych.
Ostatnia aktualizacja: 2025-07-26 UTC.
[null,null,["Ostatnia aktualizacja: 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. |"]]
