تم إيقاف إجراءات المحادثات نهائيًا في 13 حزيران (يونيو) 2023. لمزيد من المعلومات، يُرجى الاطّلاع على
إنهاء إجراءات المحادثة.
Intent
تنظيم صفحاتك في مجموعات
يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.
تربط أهدافًا إدخال المستخدم المفتوح للكائنات المنظَّمة. تتم مطابقة العبارات الشفهية مع الأهداف من خلال ميزة "فهم اللغات الطبيعية" (NLU) من Google. يمكن أن تؤدي مطابقات الأهداف إلى تشغيل أحداث في تصميم محادثتك لإحراز تقدّم في محادثة المستخدم. ويتم تحديد اسم الغرض في اسم الملف.
| تمثيل YAML |
parameters:
- object (IntentParameter)
trainingPhrases:
- string |
| الحقول |
parameters[] |
object (IntentParameter)
تمثّل هذه السمة قائمة بالمعلَمات ضمن عبارات التدريب. يجب تحديد جميع المَعلمات هنا لاستخدامها في عبارة التدريب.
|
trainingPhrases[] |
string
تتيح العبارات التدريبية لـ NLU من Google مطابقة الأهداف تلقائيًا مع البيانات التي أدخلها المستخدم. وكلما زاد عدد العبارات الفريدة التي يتم تقديمها، زادت فرصة مطابقة هذا الهدف. في ما يلي تنسيق جزء العبارة التدريبية المُشار إليه في تعليقات توضيحية. تجدر الإشارة إلى أنّ الحقل auto اختياري وأنّ السلوك التلقائي في حال عدم تحديد auto يعادل auto=false. تعني ($<paramName> '<sample text>' auto=<true or false>) auto = true أنه تمت إضافة تعليقات توضيحية تلقائيًا إلى الجزء من قِبل NLU. تشير القيمة auto = false إلى أنّ المستخدم أضاف تعليقًا توضيحيًا إلى الجزء. ويكون هذا هو الخيار التلقائي عندما لا يتم تحديد الخيار "تلقائي". مثال: "حجز رحلة جوية من ($source 'San Francisco' auto=false) إلى ($dest 'Vancouver')"
|
IntentParameter
يشير ذلك المصطلح إلى تعريف معلَمة يمكن استخدامها داخل عبارات التدريب.
| تمثيل 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. |
| الحقول |
name |
string
مطلوب. اسم فريد لمعلَمة intent. يمكن استخدامها في الشروط والردود على مَعلمات الأهداف المرجعية المستخرجة من وحدة NLU باستخدام $intent.params.[name].resolved
|
حقل الاتحاد parameter_type. نوع معلَمة intent. يمكن أن يكون parameter_type واحدًا فقط مما يلي: |
type |
object (ClassReference)
اختياريّ. لتعريف نوع البيانات لهذه المَعلمة. لا يجب ضبط هذا الخيار على الأهداف المضمّنة.
|
entitySetReferences |
object (EntitySetReferences)
اختياريّ. إحالات إلى مجموعات الكيانات المسموح بها لمعلَمة الغرض هذه صالحة فقط لمعلمات هدف مدمج. وتشير هذه المراجع إلى مجموعات الكيانات في الحقل "custom/entitySets" الدليل.
|
EntitySetReferences
مراجع مجموعة الكيانات لمعلَمة intent.
| الحقول |
entitySetReferences[] |
object (EntitySetReference)
مطلوب. مراجع مجموعة الكيانات لمعلَمة intent.
|
EntitySetReference
مرجع إلى مجموعة الكيانات المسموح بها لمعلَمة الغرض هذه.
| تمثيل YAML |
entitySet: string |
| الحقول |
entitySet |
string
مطلوب. تحدّد المجموعة المحدّدة من الكيانات التي يجب أخذها في الاعتبار لمَعلمة معيّنة. يجب أن يتوفّر تعريف مجموعة الكيانات المقابل في الدليل custom/entitySets/.
|
إنّ محتوى هذه الصفحة مرخّص بموجب ترخيص Creative Commons Attribution 4.0 ما لم يُنصّ على خلاف ذلك، ونماذج الرموز مرخّصة بموجب ترخيص Apache 2.0. للاطّلاع على التفاصيل، يُرجى مراجعة سياسات موقع Google Developers. إنّ Java هي علامة تجارية مسجَّلة لشركة Oracle و/أو شركائها التابعين.
تاريخ التعديل الأخير: 2025-07-26 (حسب التوقيت العالمي المتفَّق عليه)
[null,null,["تاريخ التعديل الأخير: 2025-07-26 (حسب التوقيت العالمي المتفَّق عليه)"],[[["\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. |"]]
