התכונה 'פעולות שיחה' הוצאה משימוש ב-13 ביוני 2023.
כאן תוכלו לקרוא מידע נוסף על ההוצאה משימוש של 'פעולות שיחה'.
Intent
קל לארגן דפים בעזרת אוספים
אפשר לשמור ולסווג תוכן על סמך ההעדפות שלך.
אובייקטים מסוג Intent ממפים קלט פתוח של משתמשים לאובייקטים מובנים. המערכת מתאימה בין ביטויים מדוברים לכוונות באמצעות Natural Language Understanding של Google (NLU). התאמות Intent יכולות להפעיל אירועים בעיצוב השיחה שלכם כדי לקדם את השיחה של המשתמש. שם ה-Intent מצוין בשם הקובץ.
| ייצוג 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. אפשר להשתמש בו בתנאים ובתגובות כדי להפנות לפרמטרים של Intent שנשלפו על ידי NLU עם $intent.params.[name].resolved
|
שדה איחוד parameter_type. סוג הפרמטר Intent. parameter_type יכול להיות רק אחת מהאפשרויות הבאות: |
type |
object (ClassReference)
זה שינוי אופציונלי. מצהיר על סוג הנתונים של הפרמטר הזה. אין להגדיר זאת לאובייקטים מובנים של Intent.
|
entitySetReferences |
object (EntitySetReferences)
זה שינוי אופציונלי. התייחסויות לקבוצות של הישויות המותרות לפרמטר הזה של Intent. תקף רק לפרמטרים של Intent מובנה. ההפניות האלו מפנות לקבוצות ישויות ב-'custom/entitySets'
|
EntitySetReferences
הפניות לקבוצת ישויות לפרמטר של Intent.
| שדות |
entitySetReferences[] |
object (EntitySetReference)
חובה. הפניות לקבוצת ישויות לפרמטר של Intent.
|
EntitySetReference
הפניה לקבוצת הישויות המותרות לפרמטר הזה של Intent.
| ייצוג YAML |
entitySet: string |
| שדות |
entitySet |
string
חובה. העמודה הזו מראה את אוסף הישויות הספציפי שיש להביא בחשבון עבור פרמטר נתון. ההגדרה של קבוצת הישויות התואמת צריכה להיות בספרייה המותאמת אישית/entitySets/ .
|
אלא אם צוין אחרת, התוכן של דף זה הוא ברישיון Creative Commons Attribution 4.0 ודוגמאות הקוד הן ברישיון Apache 2.0. לפרטים, ניתן לעיין במדיניות האתר Google Developers. Java הוא סימן מסחרי רשום של חברת Oracle ו/או של השותפים העצמאיים שלה.
עדכון אחרון: 2025-07-26 (שעון UTC).
[null,null,["עדכון אחרון: 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. |"]]
