Intent
Tetap teratur dengan koleksi
Simpan dan kategorikan konten berdasarkan preferensi Anda.
Intent memetakan input pengguna terbuka ke objek terstruktur. Frasa lisan dicocokkan dengan intent menggunakan Natural Language Understanding (NLU) Google. Pencocokan intent dapat memicu peristiwa dalam desain percakapan Anda untuk melanjutkan percakapan pengguna. Nama intent ditetapkan dalam nama file.
| Representasi YAML |
parameters:
- object (IntentParameter)
trainingPhrases:
- string |
| Kolom |
parameters[] |
object (IntentParameter)
Daftar parameter dalam frasa pelatihan. Semua parameter harus ditentukan di sini agar dapat digunakan dalam frasa pelatihan.
|
trainingPhrases[] |
string
Frasa pelatihan memungkinkan NLU Google mencocokkan intent dengan input pengguna secara otomatis. Semakin banyak frasa unik yang diberikan, semakin besar kemungkinan niat ini akan dicocokkan. Berikut adalah format bagian frasa pelatihan yang dianotasi. Perhatikan bahwa kolom auto bersifat opsional dan perilaku default saat auto tidak ditentukan akan setara dengan auto=false. ($<paramName> '<sample text>' auto=<true or false>) auto = true berarti bagian tersebut dianotasi otomatis oleh NLU. auto = false berarti bagian tersebut dianotasi oleh pengguna. Ini adalah setelan default jika mode otomatis tidak ditentukan. Contoh: "Pesan penerbangan dari ($source 'San Francisco' auto=false) ke ($dest 'Vancouver')"
|
IntentParameter
Definisi parameter yang dapat digunakan dalam frasa pelatihan.
| Representasi 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. |
| Kolom |
name |
string
Wajib. Nama unik parameter intent. Dapat digunakan dalam kondisi dan respons untuk mereferensikan parameter intent yang diekstrak oleh NLU dengan $intent.params.[name].resolved
|
Kolom union parameter_type. Jenis parameter intent. parameter_type hanya dapat berupa salah satu dari berikut: |
type |
object (ClassReference)
Opsional. Mendeklarasikan jenis data parameter ini. Intent ini tidak boleh disetel untuk intent bawaan.
|
entitySetReferences |
object (EntitySetReferences)
Opsional. Rujukan ke kumpulan entity yang diizinkan untuk parameter intent ini. Hanya valid untuk parameter intent bawaan. Referensi ini mengarah ke kumpulan entity di 'custom/entitySets' saat ini.
|
EntitySetReferences
Referensi kumpulan entitas untuk parameter intent.
| Kolom |
entitySetReferences[] |
object (EntitySetReference)
Wajib. Referensi kumpulan entitas untuk parameter intent.
|
EntitySetReference
Referensi ke kumpulan entity yang diizinkan untuk parameter intent ini.
| Representasi YAML |
entitySet: string |
| Kolom |
entitySet |
string
Wajib. Mengidentifikasi kumpulan entitas tertentu yang akan dipertimbangkan untuk parameter tertentu. Definisi kumpulan entitas yang sesuai harus ada di direktori custom/entitySets/.
|
Kecuali dinyatakan lain, konten di halaman ini dilisensikan berdasarkan Lisensi Creative Commons Attribution 4.0, sedangkan contoh kode dilisensikan berdasarkan Lisensi Apache 2.0. Untuk mengetahui informasi selengkapnya, lihat Kebijakan Situs Google Developers. Java adalah merek dagang terdaftar dari Oracle dan/atau afiliasinya.
Terakhir diperbarui pada 2025-07-26 UTC.
[null,null,["Terakhir diperbarui pada 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. |"]]
