- StaticPromptCandidate
- 선택기
- SurfaceCapabilities
- StaticPromptResponse
- StaticSimplePrompt
- 옵션
- StaticContentPrompt
- StaticCardPrompt
- StaticImagePrompt
- StaticLinkPrompt
- OpenUrl
- StaticTablePrompt
- TableColumn
- TableRow
- TableCell
- StaticMediaPrompt
- MediaObject
- MediaImage
- StaticListPrompt
- ListItem
- StaticCollectionPrompt
- CollectionItem
- 추천
- StaticCanvasPrompt
프롬프트 후보 목록을 나타내며, 그중 하나는 사용자에 대한 응답에 표시될 프롬프트로 선택됩니다. 이 메시지는 현지화할 수 있습니다.
JSON 표현 | |
---|---|
{
"candidates": [
{
object ( |
필드 | |
---|---|
candidates[] |
고객에게 전송할 후보 메시지 목록입니다. 각 프롬프트에는 언제 사용할 수 있는지 결정하는 선택기가 있습니다. 요청과 일치하는 첫 번째 선택기가 전송되고 나머지는 무시됩니다. |
StaticPromptCandidate
정적 프롬프트 후보를 나타냅니다.
JSON 표현 | |
---|---|
{ "selector": { object ( |
필드 | |
---|---|
selector |
선택사항입니다. 이 메시지가 요청과 일치하는지에 대한 기준입니다. 선택기가 비어 있으면 이 메시지가 항상 트리거됩니다. |
promptResponse |
선택기와 연결된 프롬프트 응답입니다. |
선택기
프롬프트가 요청과 일치하는지에 관한 기준을 정의합니다.
JSON 표현 | |
---|---|
{
"surfaceCapabilities": {
object ( |
필드 | |
---|---|
surfaceCapabilities |
필수 노출 영역 기능 집합입니다. |
SurfaceCapabilities
사용자가 작업에 요청하는 데 사용하는 영역을 나타냅니다.
JSON 표현 | |
---|---|
{
"capabilities": [
enum ( |
필드 | |
---|---|
capabilities[] |
필수 항목입니다. 작업에 요청하는 노출 영역의 기능입니다. |
StaticPromptResponse
텍스트, 음성, 카드, 캔버스 데이터, 추천 쿼리 칩과 같이 사용자에게 보낼 구조화된 응답을 나타냅니다.
JSON 표현 | |
---|---|
{ "firstSimple": { object ( |
필드 | |
---|---|
firstSimple |
선택사항입니다. 첫 번째 음성 및 텍스트 응답입니다. |
content |
선택사항입니다. 사용자에게 표시할 카드, 목록, 미디어 등의 콘텐츠입니다. |
lastSimple |
선택사항입니다. 음성 및 텍스트 전용 마지막 응답입니다. |
suggestions[] |
선택사항입니다. 사용자에게 표시할 추천이며 항상 응답의 끝부분에 표시됩니다. 포함하는 프롬프트의 'append' 필드가 'true'인 경우 이 필드에 정의된 제목은 이전에 정의한 추천 프롬프트에 정의된 제목에 추가되고 중복 값은 삭제됩니다. |
link |
선택사항입니다. 연결된 앱 또는 사이트로 연결할 수 있는 추가 추천 칩 칩이 '열기 |
override |
선택사항입니다. 이 메시지를 이전에 정의한 메시지와 병합하는 방법에 대한 모드입니다. 'true'는 이전에 정의된 모든 메시지 (첫 번째 및 마지막 단순 메시지, 콘텐츠, 추천 링크, 캔버스)를 모두 지우고 이 프롬프트에 정의된 메시지를 추가합니다. 'false'는 이 메시지에 정의된 메시지를 이전 응답에서 정의한 메시지에 추가합니다. 이 필드를 'false'로 설정하면 단순 프롬프트, 제안 프롬프트 및 캔버스 프롬프트 (콘텐츠 프롬프트의 일부) 내 일부 필드에도 데이터를 추가할 수 있습니다. 프롬프트에 정의된 경우 콘텐츠 및 링크 메시지를 항상 덮어씁니다. 기본값은 'false'입니다. |
canvas |
대화형 캔버스 환경에 사용할 응답입니다. |
StaticSimplePrompt
사용자에게 전송할 간단한 메시지를 나타냅니다.
JSON 표현 | |
---|---|
{
"variants": [
{
object ( |
필드 | |
---|---|
variants[] |
가능한 변형 목록입니다. |
대안
간단한 프롬프트의 일부인 변형을 나타냅니다.
JSON 표현 | |
---|---|
{ "speech": string, "text": string } |
필드 | |
---|---|
speech |
선택사항입니다. 사용자에게 말할 음성을 나타냅니다. SSML 또는 TTS(텍스트 음성 변환)일 수 있습니다. 포함하는 프롬프트의 '추가' 필드가 'true'인 경우 이 필드에 정의된 음성은 이전 단순 프롬프트의 음성에 추가됩니다. |
text |
선택사항입니다. 채팅 풍선에 표시할 텍스트입니다. 지정하지 않으면 위 음성 필드의 디스플레이 렌더링이 사용됩니다. 영문 기준 640자로 제한됩니다. 포함하는 프롬프트의 '추가' 필드가 'true'인 경우 이 필드에 정의된 텍스트가 이전 단순 프롬프트의 텍스트에 추가됩니다. |
StaticContentPrompt
StaticPrompt의 콘텐츠 부분의 자리표시자입니다.
JSON 표현 | |
---|---|
{ // Union field |
필드 | ||
---|---|---|
통합 필드 content . 프롬프트에는 한 가지 유형의 콘텐츠만 표시할 수 있습니다. content 은 다음 중 하나여야 합니다. |
||
card |
기본 카드입니다. |
|
image |
이미지입니다. |
|
table |
표 카드 |
|
media |
재생할 미디어 집합을 나타내는 응답입니다. |
|
list |
선택할 수 있는 옵션 목록을 표시하는 카드입니다. |
|
collection |
선택할 수 있는 옵션 목록을 표시하는 카드입니다. |
StaticCardPrompt
이미지 또는 텍스트와 같은 일부 정보를 표시하기 위한 기본 카드입니다.
JSON 표현 | |
---|---|
{ "title": string, "subtitle": string, "text": string, "image": { object ( |
필드 | |
---|---|
title |
선택사항입니다. 카드의 전체 제목입니다. |
subtitle |
선택사항입니다. 카드의 부제목입니다. |
text |
필수 항목입니다. 이미지가 없는 경우 필요한 카드의 본문 텍스트입니다. 형식 지정을 위해 제한된 마크다운 문법 세트를 지원합니다. |
image |
선택사항입니다. 카드의 히어로 이미지입니다. 높이는 192dp로 고정되어 있습니다. |
imageFill |
선택사항입니다. 이미지 배경이 채워지는 방식입니다. |
button |
선택사항입니다. 카드에 표시될 클릭 가능한 버튼입니다. |
StaticImagePrompt
카드에 표시되는 이미지입니다.
JSON 표현 | |
---|---|
{ "url": string, "alt": string, "height": integer, "width": integer } |
필드 | |
---|---|
url |
필수 항목입니다. 이미지의 소스 URL입니다. 이미지는 JPG, PNG, GIF (애니메이션 및 애니메이션 이외)일 수 있습니다. 예: |
alt |
필수 항목입니다. 접근성을 위해 사용되는 이미지의 텍스트 설명입니다(예: 스크린 리더). |
height |
선택사항입니다. 이미지 높이(픽셀 단위)입니다. |
width |
선택사항입니다. 이미지 너비(픽셀 단위)입니다. |
StaticLinkPrompt
추천 검색어 칩으로 표시되고 사용자가 열 수 있는 링크를 정의합니다.
JSON 표현 | |
---|---|
{
"name": string,
"open": {
object ( |
필드 | |
---|---|
name |
링크 이름 |
open |
사용자가 링크를 열 때의 동작을 정의합니다. |
OpenUrl
사용자가 링크를 열 때의 동작을 정의합니다.
JSON 표현 | |
---|---|
{
"url": string,
"hint": enum ( |
필드 | |
---|---|
url |
URL 필드: - 앱에 연결된 애플리케이션 또는 웹페이지를 여는 데 사용되는 http/https URL |
hint |
URL 유형에 대한 힌트를 나타냅니다. |
StaticTablePrompt
텍스트 표를 표시하는 표 카드입니다.
JSON 표현 | |
---|---|
{ "title": string, "subtitle": string, "image": { object ( |
필드 | |
---|---|
title |
선택사항입니다. 표의 전체 제목입니다. 자막이 설정된 경우 설정해야 합니다. |
subtitle |
선택사항입니다. 테이블의 부제목입니다. |
image |
선택사항입니다. 테이블과 연결된 이미지입니다. |
columns[] |
선택사항입니다. 헤더 및 열 정렬 |
rows[] |
선택사항입니다. 테이블의 행 데이터입니다. 처음 3개 행은 항상 표시되지만 다른 행은 특정 표면에서 잘릴 수 있습니다. 시뮬레이터로 테스트하여 특정 표면에 어떤 행이 표시되는지 확인하세요. WEB_BROWSER 기능을 지원하는 표시 경로에서 사용자를 더 많은 데이터가 포함된 웹페이지로 안내할 수 있습니다. |
button |
선택사항입니다. 버튼 |
TableColumn
테이블의 열을 설명합니다.
JSON 표현 | |
---|---|
{
"header": string,
"align": enum ( |
필드 | |
---|---|
header |
열의 헤더 텍스트입니다. |
align |
콘텐츠 W.r.T 열의 가로 정렬 지정하지 않으면 콘텐츠가 선행 가장자리에 정렬됩니다. |
TableRow
테이블의 행을 설명합니다.
JSON 표현 | |
---|---|
{
"cells": [
{
object ( |
필드 | |
---|---|
cells[] |
이 행의 셀입니다. 처음 3개의 셀은 항상 표시되지만 다른 셀은 특정 표면에서 잘릴 수도 있습니다. 시뮬레이터로 테스트하여 주어진 표면에 어떤 셀을 표시할지 확인하세요. |
divider |
각 행 뒤에 구분선이 있어야 하는지 여부를 나타냅니다. |
TableCell
행의 셀을 설명합니다.
JSON 표현 | |
---|---|
{ "text": string } |
필드 | |
---|---|
text |
셀의 텍스트 콘텐츠입니다. |
StaticMediaPrompt
이름, 설명, URL 등의 미디어 정보가 포함됩니다. 다음 ID: 9
JSON 표현 | |
---|---|
{ "mediaType": enum ( |
필드 | |
---|---|
mediaType |
이 응답의 미디어 유형입니다. |
startOffset |
첫 번째 미디어 객체의 시작 오프셋입니다. 초 단위 기간으로, 소수점 아래 9자리까지 지정 가능하며 ' |
optionalMediaControls[] |
이 미디어 응답 세션에서 지원할 수 있는 선택적 미디어 컨트롤 유형입니다. 설정하는 경우 특정 미디어 이벤트가 발생할 때 서드 파티에 요청이 전송됩니다. 설정하지 않아도 3p는 두 가지 기본 컨트롤 유형인 FINISHED 및 FAILED를 처리해야 합니다. |
mediaObjects[] |
미디어 객체 목록입니다. |
MediaObject
단일 미디어 객체를 나타냅니다.
JSON 표현 | |
---|---|
{
"name": string,
"description": string,
"url": string,
"image": {
object ( |
필드 | |
---|---|
name |
이 미디어 객체의 이름입니다. |
description |
이 미디어 객체의 설명입니다. |
url |
미디어 콘텐츠를 가리키는 URL입니다. |
image |
미디어 카드와 함께 표시할 이미지입니다. |
MediaImage
MediaPrompt 내에 표시될 이미지입니다.
JSON 표현 | |
---|---|
{ // Union field |
필드 | ||
---|---|---|
통합 필드 image . 한 가지 유형의 MediaImage만 허용됩니다. image 은 다음 중 하나여야 합니다. |
||
large |
앨범 표지 등과 같은 큰 이미지 |
|
icon |
제목의 오른쪽에 작은 이미지 아이콘이 표시됩니다. 36x36dp로 크기가 조절되었습니다. |
StaticListPrompt
선택할 수 있는 옵션 목록을 표시하는 카드입니다.
JSON 표현 | |
---|---|
{
"title": string,
"subtitle": string,
"items": [
{
object ( |
필드 | |
---|---|
title |
선택사항입니다. 목록의 제목입니다. |
subtitle |
선택사항입니다. 목록의 부제목입니다. |
items[] |
필수 항목입니다. 목록 항목입니다. |
ListItem
목록의 항목입니다.
JSON 표현 | |
---|---|
{
"key": string,
"title": string,
"description": string,
"image": {
object ( |
필드 | |
---|---|
key |
필수 항목입니다. 연결된 유형의 엔트리 키 이름과 일치하는 NLU 키입니다. 항목을 탭하면 이 키가 select 옵션 매개변수로 다시 게시됩니다. |
title |
필수 항목입니다. 상품 제목입니다. 탭하면 이 텍스트가 사용자가 입력한 것처럼 대화에 그대로 다시 게시됩니다. 각 제목은 항목 세트 내에서 고유해야 합니다. |
description |
선택사항입니다. 항목의 본문 텍스트입니다. |
image |
선택사항입니다. 항목 이미지입니다. |
StaticCollectionPrompt
선택할 수 있는 옵션 모음을 표시하는 카드입니다.
JSON 표현 | |
---|---|
{ "title": string, "subtitle": string, "items": [ { object ( |
필드 | |
---|---|
title |
선택사항입니다. 컬렉션의 제목입니다. |
subtitle |
선택사항입니다. 컬렉션의 부제목입니다. |
items[] |
필수 항목입니다. 컬렉션 항목 |
imageFill |
선택사항입니다. 이미지 표시 옵션의 유형입니다. |
CollectionItem
컬렉션의 항목입니다.
JSON 표현 | |
---|---|
{
"key": string,
"title": string,
"description": string,
"image": {
object ( |
필드 | |
---|---|
key |
필수 항목입니다. 연결된 Type의 항목 키 이름과 일치하는 NLU 키입니다. 항목을 탭하면 이 키가 select 옵션 매개변수로 다시 게시됩니다. |
title |
필수 항목입니다. 상품 제목입니다. 탭하면 이 텍스트가 사용자가 입력한 것처럼 대화에 그대로 다시 게시됩니다. 각 제목은 항목 세트 내에서 고유해야 합니다. |
description |
선택사항입니다. 항목의 본문 텍스트입니다. |
image |
선택사항입니다. 항목 이미지입니다. |
추천
편의를 위해 사용자에게 표시되는 UI 요소인 추천 검색어 칩을 나타냅니다.
JSON 표현 | |
---|---|
{ "title": string } |
필드 | |
---|---|
title |
필수 항목입니다. 추천 검색어 칩에 표시되는 텍스트입니다. 탭하면 이 텍스트가 사용자가 입력한 것처럼 대화에 그대로 다시 게시됩니다. 각 제목은 추천 칩 세트 내에서 고유해야 합니다. 최대 25자(영문 기준) |
StaticCanvasPrompt
사용자에게 전송할 Interactive Canvas 응답을 나타냅니다. 대화형 캔버스 응답을 표시하는 것 외에도 포함 프롬프트의 'firstSimple' 필드와 함께 사용하여 사용자와 대화할 수 있습니다.
JSON 표현 | |
---|---|
{ "url": string, "data": [ value ], "suppressMic": boolean } |
필드 | |
---|---|
url |
필수 항목입니다. 로드할 웹 뷰의 URL입니다. |
data[] |
선택사항입니다. 몰입형 환경 웹페이지에 이벤트로 전달되는 JSON 데이터입니다. 포함하는 프롬프트의 'override' 필드가 'false'이면 이 Canvas 프롬프트에 정의된 데이터 값이 이전 Canvas 프롬프트에서 정의된 데이터 값 뒤에 추가됩니다. |
suppressMic |
선택사항입니다. true 값은 이 몰입형 응답이 사용자에게 표시된 후 입력을 캡처하기 위해 마이크가 열리지 않음을 의미합니다. |