EventHandler

candidates: 
  - object (StaticPromptCandidate)

object (StaticPromptCandidate)

قائمة بالطلبات المرشحة التي سيتم إرسالها إلى العميل. يتضمّن كل طلب أداة اختيار لتحديد وقت استخدامها. سيتم إرسال أداة الاختيار الأولى التي تتطابق مع أحد الطلبات، وسيتم تجاهل بقية العناصر.

selector: 
  object (Selector)
promptResponse: 
  object (StaticPromptResponse)

object (Selector)

اختياريّ. تمثّل هذه السمة معايير ما إذا كان هذا الطلب يتطابق مع أحد الطلبات. إذا كانت أداة الاختيار فارغة، سيتمّ عرض هذا الطلب دائمًا.

object (StaticPromptResponse)

الردّ المرتبط بأداة الاختيار

surfaceCapabilities: 
  object (SurfaceCapabilities)

object (SurfaceCapabilities)

مجموعة إمكانات السطح المطلوبة.

capabilities: 
  - enum (Capability)

enum (Capability)

مطلوبة. تمثّل هذه السمة إمكانات السطح الذي يمكنه تقديم طلب إلى الإجراء.

firstSimple: 
  object (StaticSimplePrompt)
content: 
  object (StaticContentPrompt)
lastSimple: 
  object (StaticSimplePrompt)
suggestions: 
  - object (Suggestion)
link: 
  object (StaticLinkPrompt)
override: boolean
canvas: 
  object (StaticCanvasPrompt)

object (StaticSimplePrompt)

اختياريّ. الاستجابة الأولى بالصوت والنص فقط.

object (StaticContentPrompt)

اختياريّ. محتوى مثل بطاقة أو قائمة أو وسائط يتم عرضها للمستخدم.

object (StaticSimplePrompt)

اختياريّ. الرد الأخير بالصوت والنص فقط.

object (Suggestion)

اختياريّ. الاقتراحات التي يتم عرضها للمستخدم والتي ستظهر دائمًا في نهاية الرد. إذا كان الحقل append في الطلب الذي يتضمّن الطلب هو true، ستتم إضافة العناوين المحدَّدة في هذا الحقل إلى العناوين المحدَّدة في أي طلبات مقترَحة محدَّدة سابقًا، وستتم إزالة القيم المكرّرة.

object (StaticLinkPrompt)

اختياريّ. شريحة اقتراحات إضافية يمكنها توفير رابط إلى التطبيق أو الموقع الإلكتروني المرتبطَين سيتم عرض الشريحة بعنوان "فتح ". الحد الأقصى هو 20 حرفًا.

boolean

اختياريّ. وضع لكيفية دمج هذه الرسائل مع الرسائل المحددة مسبقًا سيمحو "true" جميع الرسائل المحددة سابقًا (الأول والأخير ورابط المحتوى والاقتراحات ولوحة الرسم) وسيضيف الرسائل المحددة في هذا الطلب. سيضيف تطبيق "false" الرسائل المحدَّدة في هذا الطلب إلى الرسائل المحدَّدة في الردود السابقة. يؤدي ضبط هذا الحقل على false أيضًا إلى تفعيل إلحاق بعض الحقول به داخل "المطالبات البسيطة" ومطالبة "الاقتراحات" ومطالبة "لوحة الرسم" (جزء من مطالبة المحتوى). سيتم دائمًا استبدال رسائل المحتوى والرابط إذا تم تحديدها في الطلب. القيمة التلقائية هي false.

object (StaticCanvasPrompt)

ردّ يمكن استخدامه لتجربة لوحة تفاعلية.

variants: 
  - object (Variant)

object (Variant)

قائمة بالصيغ المحتملة

speech: string
text: string

string

اختياريّ. تمثِّل الكلام الذي سيتم قوله إلى المستخدم. يمكن أن يكون تنسيق SSML أو نص إلى كلام. سيتم إلحاق الكلام تلقائيًا بالكلام الخاص بـ Simple Speak. إذا كان الحقل override في الطلب الذي يتضمّن الطلب هو true، سيحلّ الكلام المحدّد في هذا الحقل محلّ الكلام السابق لـ "الطلب البسيط".

string

اختياريّ. نص لعرضه في فقاعة المحادثة. في حال عدم توفيره، سيتم عرض حقل الكلام أعلاه. تقتصر على 640 حرفًا. سيتم إلحاق النص تلقائيًا بنص رسالة "الطلب البسيط" السابقة. إذا كان الحقل override في الطلب الذي يتضمّن الطلب هو true، سيحلّ النص المحدّد في هذا الحقل محلّ نص الطلب البسيط السابق.

# Union field content can be only one of the following:
card: 
  object (StaticCardPrompt)
image: 
  object (StaticImagePrompt)
table: 
  object (StaticTablePrompt)
media: 
  object (StaticMediaPrompt)
list: 
  object (StaticListPrompt)
collection: 
  object (StaticCollectionPrompt)
collectionBrowse: 
  object (StaticCollectionBrowsePrompt)
# End of list of possible types for union field content.

object (StaticCardPrompt)

بطاقة أساسية.

object (StaticImagePrompt)

صورة.

object (StaticTablePrompt)

بطاقة جدول.

object (StaticMediaPrompt)

استجابة تشير إلى مجموعة من الوسائط التي سيتم تشغيلها.

object (StaticListPrompt)

بطاقة لمشاركة عرض قائمة خيارات للاختيار من بينها.

object (StaticCollectionPrompt)

بطاقة تعرِض قائمة بالخيارات التي يمكنك الاختيار من بينها.

object (StaticCollectionBrowsePrompt)

بطاقة تعرض مجموعة من صفحات الويب لتفتحها

title: string
subtitle: string
text: string
image: 
  object (StaticImagePrompt)
imageFill: enum (ImageFill)
button: 
  object (StaticLinkPrompt)

string

اختياريّ. العنوان العام للبطاقة.

string

اختياريّ. العنوان الفرعي للبطاقة.

string

مطلوبة. النص الأساسي للبطاقة، وهو مطلوب ما لم تكن الصورة متوفّرة. تدعم مجموعة محدودة من بنية markdown للتنسيق.

object (StaticImagePrompt)

اختياريّ. صورة الجزء الرئيسي للبطاقة. ويتم تثبيت الارتفاع على 192 بكسل مستقل الكثافة.

enum (ImageFill)

اختياريّ. كيفية ملء خلفية الصورة

object (StaticLinkPrompt)

اختياريّ. زر قابل للنقر يظهر في البطاقة.

url: string
alt: string
height: integer
width: integer

string

مطلوبة. عنوان URL المصدر للصورة ويمكن أن تكون الصور بتنسيق JPG وPNG وGIF (الرسوم المتحركة وغير المتحركة). مثلاً،https://www.agentx.com/logo.png.

string

مطلوبة. وصف نصي للصورة الذي سيتم استخدامه لتسهيل الاستخدام، مثل برامج قراءة الشاشة.

integer

اختياريّ. ارتفاع الصورة بالبكسل.

integer

اختياريّ. عرض الصورة بالبكسل.

name: string
open: 
  object (OpenUrl)

string

اسم الرابط

object (OpenUrl)

تُحدِّد السلوك عندما يفتح المستخدِم الرابط.

url: string
hint: enum (UrlHint)

string

حقل عنوان URL الذي يمكن أن يكون أيًا مما يلي: - عناوين URL التي تستخدم http/https لفتح تطبيق مرتبط بتطبيق أو صفحة ويب

enum (UrlHint)

تشير هذه السمة إلى نوع عنوان URL.

title: string
subtitle: string
image: 
  object (StaticImagePrompt)
columns: 
  - object (TableColumn)
rows: 
  - object (TableRow)
button: 
  object (StaticLinkPrompt)

string

اختياريّ. العنوان العام للجدول. يجب ضبطها في حال ضبط العنوان الفرعي.

string

اختياريّ. العنوان الفرعي للجدول.

object (StaticImagePrompt)

اختياريّ. صورة مرتبطة بالجدول

object (TableColumn)

اختياريّ. العناوين ومحاذاة الأعمدة.

object (TableRow)

اختياريّ. بيانات الصف في الجدول. نضمن ظهور أول 3 صفوف، ولكن قد يتم قص بعضها الآخر على مساحات عرض معيّنة. يُرجى الاختبار باستخدام المحاكي لمعرفة الصفوف التي سيتم عرضها لسطح معيّن. على مساحات العرض التي تتيح إمكانية استخدام WEB_BROWSER، يمكنك توجيه المستخدم إلى صفحة ويب تحتوي على مزيد من البيانات.

object (StaticLinkPrompt)

اختياريّ. زرّ

header: string
align: enum (HorizontalAlignment)

string

نص العنوان للعمود.

enum (HorizontalAlignment)

محاذاة أفقية للمحتوى w.r.t العمود وإذا لم يتم تحديده، ستتم محاذاة المحتوى مع الحافة البادئة.

cells: 
  - object (TableCell)
divider: boolean

object (TableCell)

الخلايا في هذا الصف. نضمن ظهور أول 3 خلايا، ولكن قد يتم قص الخلايا الأخرى على أسطح معينة. يُرجى الاختبار باستخدام المحاكي لمعرفة الخلايا التي سيتم عرضها لسطح معين.

boolean

يشير إلى ما إذا كان يجب وجود مُقسّم بعد كل صف.

text: string

string

المحتوى النصي للخلية.

mediaType: enum (MediaType)
startOffset: string
optionalMediaControls: 
  - enum (OptionalMediaControls)
mediaObjects: 
  - object (MediaObject)
repeatMode: enum (RepeatMode)

enum (MediaType)

نوع الوسائط لهذا الرد

string (Duration format)

بدء إزاحة كائن الوسائط الأول

مدة بالثواني مؤلفة من تسعة أرقام كسور كحد أقصى، وتم إنهاؤها بـ "s". مثال: "3.5s".

enum (OptionalMediaControls)

أنواع عناصر تحكّم اختيارية في الوسائط يمكن أن توفّرها جلسة الاستجابة للوسائط هذه. وفي حال ضبط هذه السياسة، سيتم إرسال الطلب إلى 3p عند وقوع حدث معيّن على الوسائط. إذا لم يتم ضبط السياسة، يجب أن تعالج جهة 3p نوعَي التحكّم التلقائيَّين، وهما "تم الانتهاء" و"تعذّر التحقق".

object (MediaObject)

قائمة بكائنات الوسائط

enum (RepeatMode)

وضع التكرار لقائمة كائنات الوسائط.

name: string
description: string
url: string
image: 
  object (MediaImage)

string

اسم عنصر الوسائط هذا

string

وصف عنصر الوسائط هذا.

string

تمثّل هذه السمة عنوان URL الذي يشير إلى محتوى الوسائط.

object (MediaImage)

الصورة التي سيتم عرضها مع بطاقة الوسائط.

# Union field image can be only one of the following:
large: 
  object (StaticImagePrompt)
icon: 
  object (StaticImagePrompt)
# End of list of possible types for union field image.

object (StaticImagePrompt)

صورة كبيرة، مثل غلاف الألبوم وما إلى ذلك

object (StaticImagePrompt)

رمز صورة صغير معروض على يسار العنوان يتم تغيير حجمه إلى 36x36 بكسل مستقل الكثافة.

title: string
subtitle: string
items: 
  - object (ListItem)

string

اختياريّ. عنوان القائمة

string

اختياريّ. العنوان الفرعي للقائمة.

object (ListItem)

مطلوبة. عناصر القائمة

key: string
title: string
description: string
image: 
  object (StaticImagePrompt)

string

مطلوبة. مفتاح NLU الذي يتطابق مع اسم مفتاح الإدخال في النوع المرتبط به. عند النقر على العنصر، ستتم إعادة نشر هذا المفتاح كمَعلَمة خيار تحديد.

string

مطلوبة. عنوان السلعة. عند النقر على هذا النص، سيتم مشاركته مرة أخرى في المحادثة كما لو كان المستخدم قد كتبه. يجب أن يكون كل عنوان فريدًا بين مجموعة العناصر.

string

اختياريّ. النص الأساسي للعنصر.

object (StaticImagePrompt)

اختياريّ. صورة العنصر

title: string
subtitle: string
items: 
  - object (CollectionItem)
imageFill: enum (ImageFill)

string

اختياريّ. عنوان المجموعة

string

اختياريّ. العنوان الفرعي للمجموعة.

object (CollectionItem)

مطلوبة. عناصر المجموعة

enum (ImageFill)

اختياريّ. نوع خيار عرض الصورة

key: string
title: string
description: string
image: 
  object (StaticImagePrompt)

string

مطلوبة. مفتاح NLU الذي يطابق اسم مفتاح الإدخال في النوع المرتبط به. عند النقر على العنصر، ستتم إعادة نشر هذا المفتاح كمَعلَمة خيار تحديد.

string

مطلوبة. عنوان السلعة. عند النقر على هذا النص، سيتم مشاركته مرة أخرى في المحادثة كما لو كان المستخدم قد كتبه. يجب أن يكون كل عنوان فريدًا بين مجموعة العناصر.

string

اختياريّ. النص الأساسي للعنصر.

object (StaticImagePrompt)

اختياريّ. صورة العنصر

items: 
  - object (CollectionBrowseItem)
imageFill: enum (ImageFill)

object (CollectionBrowseItem)

العناصر في مجموعة التصفُّح يجب أن يتراوح حجم القائمة بين النطاق [2 و10].

enum (ImageFill)

خيار عرض الصور للصور في المجموعة.

title: string
description: string
footer: string
image: 
  object (StaticImagePrompt)
openUriAction: 
  object (OpenUrl)

string

مطلوبة. عنوان عنصر المجموعة.

string

وصف عنصر المجموعة.

string

نص تذييل عنصر المجموعة، معروض أسفل الوصف. سطر واحد من النص، تم اقتطاعه بعلامة حذف.

object (StaticImagePrompt)

صورة لعنصر المجموعة

object (OpenUrl)

مطلوبة. معرّف موارد منتظم (URI) لفتحه في حال اختيار العنصر.

title: string

string

مطلوبة. النص المعروض في شريحة الاقتراح. عند النقر على هذا النص، سيتم مشاركته مرة أخرى في المحادثة كما لو كان المستخدم قد كتبه. يجب أن يكون كل عنوان فريدًا بين مجموعة شرائح الاقتراحات. 25 حرفًا بحد أقصى

url: string
data: 
  - value
suppressMic: boolean
sendStateDataToCanvasApp: boolean
enableFullScreen: boolean
continueTtsDuringTouch: boolean

string

مطلوبة. عنوان URL لعرض الويب المطلوب تحميله.

value (Value format)

اختياريّ. بيانات JSON التي يتم تمريرها إلى صفحة الويب الخاصة بالتجربة الشاملة على أنّها فعالية إذا كان الحقل override في الطلب الذي يتضمّن الطلب هو false، ستتم إضافة قيم بيانات تم تحديدها في هذا الطلب إلى لوحة الرسم بعد قيم البيانات المحدّدة في طلبات لوحة الرسم السابقة.

boolean

اختياريّ. وتعني القيمة الحقيقية أنّه لن يتم فتح الميكروفون لالتقاط الإدخال بعد تقديم هذا الاستجابة الشاملة للمستخدم.

boolean

اختياريّ. إذا true، يتم تضمين البيانات الوصفية ذات الصلة بالمحادثة وإرسالها مرة أخرى إلى تطبيق لوحة الرسم.

boolean

اختياريّ. إذا كان true يشغل تطبيق لوحة الرسم ملء الشاشة ولا يحتوي على عنوان في الأعلى. ستظهر أيضًا رسالة نخب على شاشة التحميل تتضمّن الاسم المعروض للإجراء واسم مطوّر البرامج وتعليمات الخروج من الإجراء. القيمة التلقائية: false.

boolean

اختياريّ. إذا كانت الإجابة "صحيحة"، لن تؤدي نقرات الشاشة إلى إيقاف تقنية "تحويل النص إلى كلام" (TTS) لجلسة لوحة الرسم بأكملها. القيمة التلقائية: خطأ.