EventHandler

یک کنترل کننده را برای اجرا پس از یک رویداد تعریف می کند. نمونه‌هایی از رویدادها رویدادهای مبتنی بر قصد و شرط در یک صحنه هستند.

نمایندگی YAML
webhookHandler: string

# Union field prompt can be only one of the following:
staticPrompt: 
  object (StaticPrompt)
staticPromptName: string
# End of list of possible types for union field prompt.
زمینه های
webhookHandler

string

نام کنترل کننده وب هوک برای تماس.

prompt میدان اتحادیه درخواست‌ها می‌توانند خطی شوند یا با نام ارجاع شوند. prompt فقط می تواند یکی از موارد زیر باشد:
staticPrompt

object ( StaticPrompt )

اعلان ایستا خطی. می تواند حاوی ارجاع به منابع رشته ای در بسته ها باشد.

staticPromptName

string

نام اعلان ایستا برای فراخوانی.

StaticPrompt

نشان دهنده لیستی از نامزدهای درخواستی است که یکی از آنها به عنوان درخواستی که در پاسخ به کاربر نشان داده می شود انتخاب می شود. این پیام قابل بومی سازی است.

نمایندگی YAML
candidates: 
  - object (StaticPromptCandidate)
زمینه های
candidates[]

object ( StaticPromptCandidate )

لیست کاندیداها درخواست می کند که برای مشتری ارسال شود. هر اعلان دارای یک انتخابگر برای تعیین زمان قابل استفاده است. اولین انتخابی که با یک درخواست مطابقت داشته باشد ارسال می شود و بقیه نادیده گرفته می شوند.

StaticPromptCandidate

یک کاندیدای سریع ثابت را نشان می دهد.

نمایندگی YAML
selector: 
  object (Selector)
promptResponse: 
  object (StaticPromptResponse)
زمینه های
selector

object ( Selector )

اختیاری. معیارهایی برای مطابقت این درخواست با یک درخواست. اگر انتخابگر خالی باشد، این اعلان همیشه فعال می شود.

promptResponse

object ( StaticPromptResponse )

پاسخ سریع مرتبط با انتخابگر.

انتخابگر

معیارهایی را برای مطابقت یک درخواست با یک درخواست تعریف می کند.

نمایندگی YAML
surfaceCapabilities: 
  object (SurfaceCapabilities)
زمینه های
surfaceCapabilities

object ( SurfaceCapabilities )

مجموعه ای از قابلیت های سطح مورد نیاز.

قابلیت های سطحی

نمایانگر سطحی است که کاربر برای ارسال درخواست به Action از آن استفاده می کند.

نمایندگی YAML
capabilities: 
  - enum (Capability)
زمینه های
capabilities[]

enum ( Capability )

ضروری. قابلیت های سطح درخواست به اکشن.

StaticPromptResponse

نشان دهنده پاسخ های ساختاریافته برای ارسال به کاربر، مانند متن، گفتار، کارت ها، داده های بوم، تراشه های پیشنهاد و غیره.

نمایندگی YAML
firstSimple: 
  object (StaticSimplePrompt)
content: 
  object (StaticContentPrompt)
lastSimple: 
  object (StaticSimplePrompt)
suggestions: 
  - object (Suggestion)
link: 
  object (StaticLinkPrompt)
override: boolean
canvas: 
  object (StaticCanvasPrompt)
زمینه های
firstSimple

object ( StaticSimplePrompt )

اختیاری. اولین پاسخ صوتی و متنی.

content

object ( StaticContentPrompt )

اختیاری. محتوایی مانند کارت، فهرست یا رسانه برای نمایش به کاربر.

lastSimple

object ( StaticSimplePrompt )

اختیاری. آخرین پاسخ صوتی و متنی.

suggestions[]

object ( Suggestion )

اختیاری. پیشنهاداتی برای نمایش به کاربر که همیشه در انتهای پاسخ ظاهر می شوند. اگر فیلد append در فرمان حاوی true باشد، عناوین تعریف شده در این قسمت به عناوین تعریف شده در هر فرمان پیشنهادی تعریف شده قبلی اضافه می شود و مقادیر تکراری حذف خواهند شد.

override

boolean

اختیاری. حالت نحوه ادغام این پیام‌ها با پیام‌های تعریف‌شده قبلی. true تمام پیام‌های تعریف‌شده قبلی (اول و آخرین ساده، محتوا، پیوند پیشنهادات و بوم) را پاک می‌کند و پیام‌های تعریف‌شده در این اعلان را اضافه می‌کند. false پیام های تعریف شده در این اعلان را به پیام های تعریف شده در پاسخ های قبلی اضافه می کند. تنظیم این فیلد روی false الحاق به برخی از فیلدهای داخل فرمان های ساده، اعلان پیشنهادات و فرمان Canvas (بخشی از درخواست محتوا) را نیز فعال می کند. اگر در اعلان تعریف شده باشد، پیام‌های محتوا و پیوند همیشه بازنویسی می‌شوند. مقدار پیش فرض false است.

canvas

object ( StaticCanvasPrompt )

پاسخی که برای تجربه بوم تعاملی استفاده می شود.

StaticSimplePrompt

نشان دهنده یک اعلان ساده برای ارسال به کاربر است.

نمایندگی YAML
variants: 
  - object (Variant)
زمینه های
variants[]

object ( Variant )

لیست انواع احتمالی

گونه

یک نوع را نشان می دهد که بخشی از دستور ساده است.

نمایندگی YAML
speech: string
text: string
زمینه های
speech

string

اختیاری. بیانگر گفتاری است که باید به کاربر گفته شود. می تواند SSML یا متن به گفتار باشد. به طور پیش‌فرض، گفتار به سخنرانی قبلی Simple Prompt اضافه می‌شود. اگر فیلد override در فرمان حاوی true باشد، گفتار تعریف شده در این فیلد، گفتار اعلان ساده قبلی را لغو می کند.

text

string

اختیاری. متن برای نمایش در حباب چت. در صورت عدم ارائه، یک نمایش نمایشی از قسمت گفتار بالا استفاده خواهد شد. محدود به 640 کاراکتر. به‌طور پیش‌فرض، متن به متن درخواست ساده قبلی اضافه می‌شود. اگر فیلد override در دستور حاوی true باشد، متن تعریف شده در این قسمت، متن فرمان ساده قبلی را لغو می کند.

StaticContentPrompt

یک مکان نگهدار برای قسمت محتوای یک StaticPrompt.

نمایندگی YAML
# 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.
زمینه های
content زمینه اتحادیه فقط یک نوع محتوا می تواند در یک درخواست وجود داشته باشد. content فقط می تواند یکی از موارد زیر باشد:
card

object ( StaticCardPrompt )

یک کارت پایه

image

object ( StaticImagePrompt )

یک تصویر.

table

object ( StaticTablePrompt )

کارت جدول.

media

object ( StaticMediaPrompt )

پاسخ نشان‌دهنده مجموعه‌ای از رسانه‌ها برای پخش.

list

object ( StaticListPrompt )

کارتی برای ارائه لیستی از گزینه ها برای انتخاب.

collection

object ( StaticCollectionPrompt )

کارتی که فهرستی از گزینه ها را برای انتخاب ارائه می دهد.

collectionBrowse

object ( StaticCollectionBrowsePrompt )

کارتی که مجموعه ای از صفحات وب را برای باز کردن ارائه می دهد.

StaticCardPrompt

یک کارت اصلی برای نمایش برخی از اطلاعات، به عنوان مثال یک تصویر و/یا متن.

نمایندگی YAML
title: string
subtitle: string
text: string
image: 
  object (StaticImagePrompt)
imageFill: enum (ImageFill)
button: 
  object (StaticLinkPrompt)
زمینه های
title

string

اختیاری. عنوان کلی کارت

subtitle

string

اختیاری. زیرنویس کارت

text

string

ضروری. متن اصلی کارت که مورد نیاز است مگر اینکه تصویر موجود باشد. از مجموعه محدودی از نحو نشانه گذاری برای قالب بندی پشتیبانی می کند.

image

object ( StaticImagePrompt )

اختیاری. تصویر قهرمان برای کارت. ارتفاع روی 192dp ثابت شده است.

imageFill

enum ( ImageFill )

اختیاری. پس زمینه تصویر چگونه پر می شود.

button

object ( StaticLinkPrompt )

اختیاری. یک دکمه قابل کلیک برای نمایش در کارت.

StaticImagePrompt

تصویری که در کارت نمایش داده می شود.

نمایندگی YAML
url: string
alt: string
height: integer
width: integer
زمینه های
url

string

ضروری. آدرس منبع تصویر تصاویر می توانند JPG، PNG و GIF (متحرک و غیر متحرک) باشند. برای مثال، https://www.agentx.com/logo.png .

alt

string

ضروری. شرح متنی از تصویر که برای دسترسی استفاده می شود، به عنوان مثال صفحه خوان.

height

integer

اختیاری. ارتفاع تصویر بر حسب پیکسل

width

integer

اختیاری. عرض تصویر بر حسب پیکسل

StaticLinkPrompt

پیوندی را تعریف می کند که به عنوان یک تراشه پیشنهاد نمایش داده می شود و کاربر می تواند آن را باز کند.

نمایندگی YAML
name: string
open: 
  object (OpenUrl)
زمینه های
name

string

نام لینک

open

object ( OpenUrl )

وقتی کاربر پیوند را باز می کند رفتار را تعریف می کند.

OpenUrl

وقتی کاربر پیوند را باز می کند رفتار را تعریف می کند.

نمایندگی YAML
url: string
hint: enum (UrlHint)
زمینه های
url

string

فیلد url که می تواند یکی از این موارد باشد: - آدرس های http/https برای باز کردن یک برنامه مرتبط با برنامه یا یک صفحه وب

hint

enum ( UrlHint )

یک اشاره برای نوع URL را نشان می دهد.

StaticTablePrompt

کارت جدول برای نمایش جدول متن.

نمایندگی YAML
title: string
subtitle: string
image: 
  object (StaticImagePrompt)
columns: 
  - object (TableColumn)
rows: 
  - object (TableRow)
button: 
  object (StaticLinkPrompt)
زمینه های
title

string

اختیاری. عنوان کلی جدول اگر زیرنویس تنظیم شده باشد باید تنظیم شود.

subtitle

string

اختیاری. زیرنویس جدول

image

object ( StaticImagePrompt )

اختیاری. تصویر مرتبط با جدول

columns[]

object ( TableColumn )

اختیاری. سرصفحه ها و تراز ستون ها.

rows[]

object ( TableRow )

اختیاری. داده های ردیف جدول 3 ردیف اول تضمین شده است که نشان داده می شوند اما سایر ردیف ها ممکن است بر روی سطوح خاصی بریده شوند. لطفاً با شبیه ساز تست کنید تا ببینید کدام ردیف برای یک سطح مشخص نشان داده می شود. در سطوحی که از قابلیت WEB_BROWSER پشتیبانی می کنند، می توانید کاربر را به صفحه وب با داده های بیشتر هدایت کنید.

button

object ( StaticLinkPrompt )

اختیاری. دکمه.

ستون جدول

ستونی را در جدول توضیح می دهد.

نمایندگی YAML
header: string
align: enum (HorizontalAlignment)
زمینه های
header

string

متن سرصفحه برای ستون.

align

enum ( HorizontalAlignment )

تراز افقی ستون wrt محتوا. اگر مشخص نباشد، محتوا با لبه اصلی تراز می شود.

TableRow

یک ردیف را در جدول توصیف می کند.

نمایندگی YAML
cells: 
  - object (TableCell)
divider: boolean
زمینه های
cells[]

object ( TableCell )

سلول های این ردیف نمایش 3 سلول اول تضمین شده است، اما سایر سلول ها ممکن است بر روی سطوح خاصی بریده شوند. لطفاً با شبیه ساز تست کنید تا ببینید کدام سلول برای یک سطح مشخص نشان داده می شود.

divider

boolean

نشان می دهد که آیا بعد از هر ردیف باید یک تقسیم کننده وجود داشته باشد.

TableCell

یک سلول را در یک ردیف توصیف می کند.

نمایندگی YAML
text: string
زمینه های
text

string

محتوای متن سلول

StaticMediaPrompt

حاوی اطلاعاتی در مورد رسانه مانند نام، توضیحات، آدرس اینترنتی و غیره است. شناسه بعدی: 11

نمایندگی YAML
mediaType: enum (MediaType)
startOffset: string
optionalMediaControls: 
  - enum (OptionalMediaControls)
mediaObjects: 
  - object (MediaObject)
repeatMode: enum (RepeatMode)
زمینه های
mediaType

enum ( MediaType )

نوع رسانه ای این پاسخ.

startOffset

string ( Duration format)

شروع افست اولین شی رسانه ای.

مدت زمان در ثانیه با حداکثر نه رقم کسری که با ' s ' خاتمه می یابد. مثال: "3.5s" .

optionalMediaControls[]

enum ( OptionalMediaControls )

انواع کنترل رسانه اختیاری که این جلسه پاسخ رسانه می تواند پشتیبانی کند. در صورت تنظیم، زمانی که یک رویداد رسانه ای خاص اتفاق می افتد، درخواست به 3p ارسال می شود. اگر تنظیم نشده باشد، 3p همچنان باید دو نوع کنترل پیش‌فرض، FINISHED و FAILED را کنترل کند.

mediaObjects[]

object ( MediaObject )

فهرست اشیاء رسانه ای

repeatMode

enum ( RepeatMode )

حالت تکرار برای لیست اشیاء رسانه.

MediaObject

یک شی رسانه واحد را نشان می دهد.

نمایندگی YAML
name: string
description: string
url: string
image: 
  object (MediaImage)
زمینه های
name

string

نام این شی رسانه ای.

description

string

شرح این شی رسانه ای.

url

string

نشانی اینترنتی که به محتوای رسانه اشاره دارد.

image

object ( MediaImage )

تصویر برای نمایش با کارت رسانه.

MediaImage

تصویر در داخل MediaPrompt نشان داده شود.

نمایندگی YAML
# 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.
زمینه های
image میدان اتحادیه فقط یک نوع MediaImage مجاز است. image می تواند تنها یکی از موارد زیر باشد:
large

object ( StaticImagePrompt )

یک تصویر بزرگ، مانند جلد آلبوم و غیره.

icon

object ( StaticImagePrompt )

یک نماد تصویر کوچک در سمت راست عنوان نمایش داده شده است. اندازه آن به 36x36 dp تغییر یافته است.

StaticListPrompt

کارتی برای ارائه لیستی از گزینه ها برای انتخاب.

نمایندگی YAML
title: string
subtitle: string
items: 
  - object (ListItem)
زمینه های
title

string

اختیاری. عنوان لیست

subtitle

string

اختیاری. زیرنویس لیست

items[]

object ( ListItem )

ضروری. فهرست موارد

List Item

یک مورد در لیست

نمایندگی YAML
key: string
title: string
description: string
image: 
  object (StaticImagePrompt)
زمینه های
key

string

ضروری. کلید NLU که با نام کلید ورودی در نوع مرتبط مطابقت دارد. هنگامی که روی مورد ضربه بزنید، این کلید به عنوان پارامتر انتخاب گزینه ارسال می شود.

title

string

ضروری. عنوان مورد. وقتی روی آن ضربه بزنید، این متن به طور کلمه به مکالمه ارسال می شود، گویی که کاربر آن را تایپ کرده است. هر عنوان باید در میان مجموعه موارد منحصر به فرد باشد.

description

string

اختیاری. متن متن مورد

image

object ( StaticImagePrompt )

اختیاری. تصویر مورد.

StaticCollectionPrompt

کارتی برای ارائه مجموعه ای از گزینه ها برای انتخاب.

نمایندگی YAML
title: string
subtitle: string
items: 
  - object (CollectionItem)
imageFill: enum (ImageFill)
زمینه های
title

string

اختیاری. عنوان مجموعه.

subtitle

string

اختیاری. زیرنویس مجموعه.

items[]

object ( CollectionItem )

ضروری. اقلام مجموعه

imageFill

enum ( ImageFill )

اختیاری. گزینه نوع نمایش تصویر

مجموعه آیتم

یک مورد در مجموعه

نمایندگی YAML
key: string
title: string
description: string
image: 
  object (StaticImagePrompt)
زمینه های
key

string

ضروری. کلید NLU که با نام کلید ورودی در نوع مرتبط مطابقت دارد. هنگامی که روی مورد ضربه بزنید، این کلید به عنوان پارامتر انتخاب گزینه ارسال می شود.

title

string

ضروری. عنوان مورد. وقتی روی آن ضربه بزنید، این متن به طور کلمه به مکالمه ارسال می شود، گویی که کاربر آن را تایپ کرده است. هر عنوان باید در میان مجموعه موارد منحصر به فرد باشد.

description

string

اختیاری. متن متن مورد

image

object ( StaticImagePrompt )

اختیاری. تصویر مورد.

StaticCollectionBrowsePrompt

مجموعه ای از اسناد وب را به عنوان مجموعه ای از آیتم های کاشی بزرگ ارائه می دهد. موارد ممکن است برای راه اندازی سند وب مرتبط خود در یک نمایشگر وب انتخاب شوند.

نمایندگی YAML
items: 
  - object (CollectionBrowseItem)
imageFill: enum (ImageFill)
زمینه های
items[]

object ( CollectionBrowseItem )

موارد موجود در مجموعه مرور اندازه لیست باید در محدوده [2، 10] باشد.

imageFill

enum ( ImageFill )

گزینه نمایش تصویر برای تصاویر موجود در مجموعه.

CollectionBrowseItem

مورد موجود در مجموعه

نمایندگی YAML
title: string
description: string
footer: string
image: 
  object (StaticImagePrompt)
openUriAction: 
  object (OpenUrl)
زمینه های
title

string

ضروری. عنوان آیتم مجموعه.

description

string

شرح آیتم مجموعه

footer

string

متن پاورقی برای آیتم مجموعه، در زیر توضیحات نمایش داده شده است. تک خط متن، کوتاه شده با بیضی.

image

object ( StaticImagePrompt )

تصویر برای آیتم مجموعه.

openUriAction

object ( OpenUrl )

ضروری. URI برای باز کردن در صورت انتخاب مورد.

پیشنهاد

نشان دهنده یک تراشه پیشنهاد است، یک عنصر UI که برای راحتی به کاربر نشان داده می شود.

نمایندگی YAML
title: string
زمینه های
title

string

ضروری. متن نشان داده شده در تراشه پیشنهاد. وقتی روی آن ضربه بزنید، این متن به طور کلمه به مکالمه ارسال می شود، گویی که کاربر آن را تایپ کرده است. هر عنوان باید در میان مجموعه تراشه های پیشنهادی منحصر به فرد باشد. حداکثر 25 کاراکتر

StaticCanvasPrompt

نشان دهنده یک پاسخ بوم تعاملی برای ارسال به کاربر است. این می تواند همراه با فیلد firstSimple در اعلان حاوی برای صحبت با کاربر علاوه بر نمایش یک پاسخ بوم تعاملی استفاده شود.

نمایندگی YAML
url: string
data: 
  - value
suppressMic: boolean
sendStateDataToCanvasApp: boolean
enableFullScreen: boolean
continueTtsDuringTouch: boolean
زمینه های
url

string

ضروری. URL نمای وب برای بارگیری.

data[]

value ( Value format)

اختیاری. داده های JSON به عنوان یک رویداد به صفحه وب تجربه همهجانبه منتقل می شود. اگر فیلد override در فرمان حاوی false باشد، مقادیر داده‌های تعریف‌شده در این فرمان Canvas پس از مقادیر داده‌های تعریف‌شده در درخواست‌های قبلی Canvas اضافه می‌شوند.

suppressMic

boolean

اختیاری. یک مقدار واقعی به این معنی است که پس از ارائه این پاسخ همه جانبه به کاربر، میکروفون برای گرفتن ورودی باز نمی شود.

sendStateDataToCanvasApp

boolean

اختیاری. در صورت true ، فراداده مربوط به مکالمه گنجانده شده و به برنامه بوم بازگردانده می شود.

enableFullScreen

boolean

اختیاری. اگر true ، برنامه بوم تمام صفحه را اشغال می کند و هدر در بالا نخواهد داشت. یک پیام نان تست نیز در صفحه بارگیری نمایش داده می‌شود که شامل نام نمایشی Action، نام توسعه‌دهنده و دستورالعمل‌های خروج از Action است. مقدار پیش فرض: false .

continueTtsDuringTouch

boolean

اختیاری. اگر درست باشد، ضربه زدن روی صفحه نمایش، TTS را برای کل جلسه بوم متوقف نمی کند. مقدار پیش فرض: false.