Intent
Koleksiyonlar ile düzeninizi koruyun
İçeriği tercihlerinize göre kaydedin ve kategorilere ayırın.
Amaçlar, açık uçlu kullanıcı girişini yapılandırılmış nesnelerle eşler. Söylenen ifadeler, Google'ın Doğal Dil Anlama (NLU) özelliği ile niyetlerle eşleştirilir. Amaç eşleşmeleri, kullanıcının görüşmesini ilerletmek için sohbet tasarımınızdaki etkinlikleri tetikleyebilir. Amaç adı, dosyanın adında belirtilir.
| YAML temsili |
parameters:
- object (IntentParameter)
trainingPhrases:
- string |
| Alanlar |
parameters[] |
object (IntentParameter)
Eğitim ifadelerindeki parametrelerin listesi. Eğitim ifadesinde kullanılmaları için tüm parametrelerin burada tanımlanması gerekir.
|
trainingPhrases[] |
string
Eğitim ifadeleri, Google'ın NLU'sunun amaçları otomatik olarak kullanıcı girişiyle eşleştirmesine olanak tanır. Ne kadar çok benzersiz ifade sağlanırsa bu niyetin eşleşme olasılığı o kadar artar. Aşağıda, ek açıklamalı eğitim ifadesi bölümünün biçimi verilmiştir. auto alanının isteğe bağlı olduğunu ve auto belirtilmediğinde varsayılan davranışın auto=false ile eşdeğer olduğunu unutmayın. ($<paramName> '<sample text>' auto=<true or false>) auto = true, bölüme NLU tarafından otomatik olarak ek açıklama eklendiği anlamına gelir. auto = false, bölüme kullanıcı tarafından ek açıklama eklendiği anlamına gelir. Otomatik değeri belirtilmediğinde varsayılan olarak bu ayar kullanılır. Örnek: "($source 'San Francisco' auto=false) - ($dest 'Vancouver') uçuşları için uçuş rezervasyonu yap"
|
IntentParameter
Eğitim ifadelerinin içinde kullanılabilecek parametrenin tanımı.
| YAML temsili |
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. |
| Alanlar |
name |
string
Zorunlu. Intent parametresinin benzersiz adı. $intent.params.[name].resolved ile NLU tarafından ayıklanan referans intent parametrelerine koşullar ve yanıtlarda kullanılabilir.
|
Birleştirme alanı parameter_type. Amaç parametresinin türü. parameter_type şunlardan yalnızca biri olabilir: |
type |
object (ClassReference)
İsteğe bağlı. Bu parametrenin veri türünü tanımlar. Yerleşik amaçlar için ayarlanmamalıdır.
|
entitySetReferences |
object (EntitySetReferences)
İsteğe bağlı. Bu intent parametresi için izin verilen varlık gruplarına referanslar. Yalnızca yerleşik bir amacın parametreleri için geçerlidir. Bu referanslar, "custom/entitySets" içindeki varlık gruplarını işaret ediyor dizin.
|
EntitySetReferences
Bir intent parametresi için öğe grubu referansları.
| Alanlar |
entitySetReferences[] |
object (EntitySetReference)
Zorunlu. Bir intent parametresi için öğe grubu referansları.
|
EntitySetReference
Bu intent parametresi için izin verilen varlıklar grubuna referans.
| YAML temsili |
entitySet: string |
| Alanlar |
entitySet |
string
Zorunlu. Belirli bir parametre için dikkate alınacak özel öğe koleksiyonunu tanımlar. İlgili varlık grubu tanımı, custom/entitySets/ dizininde bulunmalıdır.
|
Aksi belirtilmediği sürece bu sayfanın içeriği Creative Commons Atıf 4.0 Lisansı altında ve kod örnekleri Apache 2.0 Lisansı altında lisanslanmıştır. Ayrıntılı bilgi için Google Developers Site Politikaları'na göz atın. Java, Oracle ve/veya satış ortaklarının tescilli ticari markasıdır.
Son güncelleme tarihi: 2025-07-26 UTC.
[null,null,["Son güncelleme tarihi: 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. |"]]
