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 또는 TTS(텍스트 음성 변환)일 수 있습니다. 기본적으로 음성은 이전 Simple 프롬프트의 음성에 추가됩니다. 포함하는 프롬프트의 override 필드가 true인 경우 이 필드에 정의된 음성이 이전 단순 프롬프트의 음성을 재정의합니다.

string

선택사항입니다. 채팅 풍선에 표시할 텍스트입니다. 지정하지 않으면 위 음성 필드의 디스플레이 렌더링이 사용됩니다. 영문 기준 640자로 제한됩니다. 기본적으로 텍스트는 이전 Simple 프롬프트의 텍스트에 추가됩니다. 포함하는 프롬프트의 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

필수 항목입니다. 이미지가 없는 경우 필요한 카드의 본문 텍스트입니다. 형식 지정을 위해 제한된 마크다운 문법 세트를 지원합니다.

object (StaticImagePrompt)

선택사항입니다. 카드의 히어로 이미지입니다. 높이는 192dp로 고정되어 있습니다.

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 필드: - 앱에 연결된 애플리케이션 또는 웹페이지를 여는 데 사용되는 http/https URL

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)

첫 번째 미디어 객체의 시작 오프셋입니다.

초 단위 기간으로, 소수점 아래 9자리까지 지정 가능하며 's'로 끝납니다(예: "3.5s").

enum (OptionalMediaControls)

이 미디어 응답 세션에서 지원할 수 있는 선택적 미디어 컨트롤 유형입니다. 설정하는 경우 특정 미디어 이벤트가 발생할 때 서드 파티에 요청이 전송됩니다. 설정하지 않아도 3p는 두 가지 기본 컨트롤 유형인 FINISHED 및 FAILED를 처리해야 합니다.

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)

제목의 오른쪽에 작은 이미지 아이콘이 표시됩니다. 36x36dp로 크기가 조절되었습니다.

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

string

선택사항입니다. 목록의 제목입니다.

string

선택사항입니다. 목록의 부제목입니다.

object (ListItem)

필수 항목입니다. 목록 항목입니다.

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

string

필수 항목입니다. 연결된 유형의 엔트리 키 이름과 일치하는 NLU 키입니다. 항목을 탭하면 이 키가 select 옵션 매개변수로 다시 게시됩니다.

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

필수 항목입니다. 연결된 Type의 항목 키 이름과 일치하는 NLU 키입니다. 항목을 탭하면 이 키가 select 옵션 매개변수로 다시 게시됩니다.

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이면 이 Canvas 프롬프트에 정의된 데이터 값이 이전 Canvas 프롬프트에 정의된 데이터 값 뒤에 추가됩니다.

boolean

선택사항입니다. true 값은 이 몰입형 응답이 사용자에게 표시된 후 입력을 캡처하기 위해 마이크가 열리지 않음을 의미합니다.

boolean

선택사항입니다. true인 경우 대화 관련 메타데이터가 포함되며 캔버스 애플리케이션으로 다시 전송됩니다.

boolean

선택사항입니다. true인 경우 캔버스 애플리케이션이 전체 화면을 차지하며 상단에 헤더가 없습니다. 로드 화면에 작업의 표시 이름, 개발자 이름, 작업 종료 안내가 포함된 토스트 메시지도 표시됩니다. 기본값: false.

boolean

선택사항입니다. true인 경우 화면을 탭해도 전체 캔버스 세션에서 TTS가 중지되지 않습니다. 기본값은 false입니다.