어시스턴트 응답 추가
작업이 활성화되면, 작업의 본체는 여러 단계로 구성되어 있으며, 이 단계들은 사용자와 어시스턴트 간의 대화를 구성합니다. 각 단계의 한 부분은 단계가 처리될 때 어시스턴트가 고객에게 언급하는 내용입니다.
단계에서 어시스턴트의 응답을 작성하려면 어시스턴트 언급 섹션을 사용하십시오. 이 단계는 어시스턴트가 특정 단계에서 사용자에게 전달하는 텍스트 또는 음성을 나타냅니다. 단계에 따라 사용자의 질문에 완전한 답변을 추가하거나 후속 질문을 할 수 있습니다.
어시스턴트가 사용자에게 표시될 텍스트를 입력하는 것만으로 간단한 텍스트 응답을 입력할 수 있습니다. 또한 서식 및 웹 콘텐츠를 추가할 수 있으며, 변수를 사용하여 사용자 정보를 참조할 수 있습니다.
응답 형식화
텍스트 편집기 도구를 사용하여 글꼴 스타일(예: 굵은체 또는 이탤릭체)을 텍스트에 적용하거나 링크를 추가하십시오.
배후에서 글꼴 스타일과 링크 구문이 마크다운 형식으로 저장됩니다. 웹 대화 통합을 사용하는 경우 HTML및 Markdown 태그 지정이 지원됩니다. 자세한 정보는 Markdown 형식화 를 참조하십시오.
HTML 태그(링크 제외)는 페이스북, WhatsApp,, 슬랙 통합 기능으로 전송되는 텍스트 응답에서 자동으로 제거됩니다. 이러한 채널은 HTML 서식을 지원하지 않기 때문입니다. HTML 태그는 여전히 이를 지원하는 채널 (예: 웹 대화) 에서 처리되며 세션 히스토리에 저장됩니다.
Markdown을 지원하지 않는 사용자 정의 클라이언트 애플리케이션을 사용하는 경우 텍스트 스타일을 텍스트 응답에 적용하지 마십시오.
변수 추가 및 참조
어시스턴트는 대화 중에 정보를 변수로 저장합니다. 변수는 런타임 시 사용 가능하게 되는 데이터 값의 컨테이너입니다. 변수의 값은 시간이 지남에 따라 변경될 수 있습니다. 변수에는 특정 조치 중에만 지속되는 조치 변수 및 모든 조치에 사용 가능한 세션 변수가 포함됩니다. 변수에 대한 자세한 정보는 대화 중에 정보 관리를 참조하십시오.
어시스턴트의 출력에서 변수를 참조하여 대화를 개인화하거나 실행 시에 사용할 수 있는 정보를 포함할 수 있습니다. 어시스턴트가 언급하는 변수의 참조에 대한 자세한 정보는 변수를 사용하여 대화 사용자 정의를 참조하십시오.
응답 테스트
어시스턴트 응답이 올바르게 형식화되었는지 확인하려면 미리보기를 사용할 수 있습니다.
- 미리보기 단추를 클릭하십시오.
- 조치를 시작하려면 첫 번째 구문을 입력하십시오(예:
What are your store hours?
). - 비서가 응답하면 메시지가 의도한 대로 서식 및 변수 사용과 함께 표시되는지 확인하십시오.
응답 추가를 위한 팁
- 답변은 짧고 유용하게 하십시오.
- 응답에 사용자 인텐트를 반영하십시오. 이렇게 하면 봇이 자신을 이해했다고 사용자가 확신하게 되며, 그렇지 않은 경우에는 오해를 즉시 정정할 수 있는 기회를 사용자에게 제공합니다.
- 답변이 자주 바뀌는 데이터에 의존하는 경우, 답변에 외부 사이트 링크를 포함시키십시오.
- 당신의 반응을 조심스럽게 말로 표현하십시오. 응답을 어떻게 표현하는지에 따라 누군가가 시스템에 반응하는 방식을 바꿀 수 있습니다. 한 행의 텍스트를 변경하여 복잡한 프로그램 솔루션을 구현하기 위해 다중 행의 코드를 작성하지 않아도 될 수 있습니다.
변형 추가
사용자가 자주 어시스턴트를 사용한다면, 매번 똑같은 인사말과 응답을 보는 것이 지루할 수 있습니다. 어시스턴트가 다른 방식으로 동일한 요청에 응답할 수 있도록 응답 변형 을 추가할 수 있습니다.
순차적으로 또는 임의 순서로 응답 변형을 교체하도록 선택할 수 있습니다. 기본적으로 순서가 지정된 목록에서 선택되는 것처럼 응답이 순차적으로 교체됩니다.
응답 변형을 추가하는 방법
-
지원에서 응답 변형 추가 아이콘
를 클릭하십시오.
-
반응 변동 유형에 대해 반응 변동을 순차적으로 순환할지 또는 무작위 순서로 순환할지 여부를 선택하십시오. 자세한 정보는 순차 또는 무작위 를 참조하십시오.
응답 변형 -
각 변형을 자체 필드에 추가하십시오. 예를 들어, 다음과 같습니다.
응답 변형 예 응답 번호 변형 응답 1 무엇을 도와드릴까요? 응답 2 오늘 제가 무엇을 도와드릴까요? 응답 3 내가 무엇을 도울 수 있는지 말해줘. 응답 4 도와드릴까요? -
완료되면 적용을 클릭하십시오. 이러한 변형은 Assistant 내부에서블록으로 표시됩니다. 편집 아이콘을 클릭하여 변형을 업데이트하거나 삭제 아이콘을 클릭하여 모든 변형을 제거할 수 있습니다. 또한 단계에 여러 응답 변형 세트를 추가할 수 있습니다.
어시스턴트의 응답 변형은 다음과 유사합니다.
순차 또는 무작위
반응 변동 유형의 경우 순차 또는 무작위를 선택할 수 있습니다.
순차적은 동작이 처음 트리거될 때 첫 번째 응답 변형을 반환하고, 두 번째 응답 변형을 반환하고, 세 번째 응답 변형을 반환하는 식으로 변형을 입력한 순서와 동일한 순서로 반환합니다. 이 결과, 노드가 처리될 때 응답이 다음 순서로 반환됩니다
-
1회:
How can I help you?
-
2회:
What can I do for you today?
-
세 번째:
Tell me what I can help with.
-
네 번째 시간:
Can I help you?
무작위 는 조치가 처음 트리거될 때 변형을 선택하고 다음 번에 무작위로 다른 변형을 선택하지만 동일한 변형을 연속적으로 반복하지 않습니다. 이 예는 응답이 나타날 수 있는 순서를 표시합니다.
-
1회:
Tell me what I can help with.
-
2회:
Can I help you?
-
세 번째:
How can I help you?
-
네 번째 시간:
What can I do for you today?
매체 응답
텍스트 응답 외에도, 멀티미디어나 상호작용 요소를 포함하는 응답을 보내기 위해 다른 응답 유형을 사용할 수 있습니다.
조치 편집기는 다음 매체 응답 유형을 지원합니다.
- 이미지: 응답에 이미지를 임베드합니다. 소스 이미지 파일은 어딘가에 호스팅되어야 하며 이 파일을 참조하는 데 사용할 수 있는 URL이 있어야 합니다. 이는 공용으로 액세스할 수 없는 디렉토리에 저장된 파일이 아니어야 합니다.
- 비디오: 비디오 플레이어를 응답에 임베드합니다. 소스 비디오는 지원되는 비디오 스트리밍 서비스에서 재생 가능한 비디오로 또는 이를 참조하는 데 사용할 수 있는 URL을 가진 비디오 파일로 호스팅되어야 합니다. 이는 공용으로 액세스할 수 없는 디렉토리에 저장된 파일이 아니어야 합니다.
- 오디오: 응답에 오디오 클립을 임베드합니다. 소스 오디오 파일은 임의 위치에서 호스트되어야 하며 이를 참조하는 데 사용할 수 있는 URL이 있어야 합니다. 이는 공용으로 액세스할 수 없는 디렉토리에 저장된 파일이 아니어야 합니다.
- iframe: 외부 웹 사이트의 컨텐츠(예: 양식 또는 기타 대화식 컴포넌트)를 대화 내에서 직접 임베드합니다. 소스 컨텐츠는 HTTP를 사용하여 공개적으로 액세스할 수 있어야 하며 HTML
iframe
요소로 임베드할 수 있어야 합니다.
채널 통합 방식에 따라 미디어 응답을 표시하는 기능이 다릅니다. 어떤 채널 통합이 어떤 응답 유형을 지원하는지 확인하려면 응답 유형에 대한 채널 통합 지원 을 참조하십시오.
다른 채널에 맞게 다른 응답을 정의하고 싶다면, JSON 편집기를 사용하여 응답을 편집할 수 있습니다. 자세한 정보는 특정 통합 대상의 내용을 참조하십시오.
JSON 편집기에서 응답을 편집하여 채널 특정 상호작용을 처리하기 위해 추가 응답 유형에 액세스할 수도 있습니다.
JSON 편집기를 사용하여 응답을 편집하는 방법에 대한 자세한 내용은 JSON 편집기를 사용하여 응답 정의하기를 참조하십시오.
이미지 추가 응답
이미지 응답을 추가하여 고객에게 이미지를 표시하십시오.
이미지 응답 유형은 다음 채널 통합에서 지원됩니다.
- 웹 대화
- SMS
- Slack
- Microsoft Teams
이미지 응답 을 추가하려면 다음 단계를 완료하십시오
-
어시스턴트가 표시 필드에서
이미지 아이콘을 클릭하십시오.
-
URL 에 호스팅된 이미지의 전체 URL 입력합니다.
이미지는
JPEG
,GIF
,PNG
형식이어야 합니다.https:
URL 이미지 파일은 공개적으로 접근할 수 있는 위치(예:https://www.example.com/assets/common/logo.png
)에 저장해야 합니다.IBM Cloud® Object Storage에 저장된 이미지에 액세스하려면 개별 이미지 스토리지 오브젝트에 공용 액세스를 허용하고 다음과 같은 구문으로 이미지 소스를 지정하여 참조하십시오.
https://s3.eu.cloud-object-storage.appdomain.cloud/your-bucket-name/image-name.png
. -
선택적으로 제공된 필드에 이미지 제목, 설명 및 대체 텍스트를 지정하십시오. 웹 대화 통합에서 제목 및 설명이 이미지와 함께 표시됩니다.
변수에 대한 참조는 지원되지 않습니다. 일부 통합 채널에서는 제목 또는 설명을 무시합니다.
-
적용을 클릭하십시오.
음성 응답 추가하기
오디오 응답을 추가하여 음성 단어 또는 기타 음성 컨텐츠를 포함시키십시오. 웹 채팅에서 오디오 응답은 내장된 오디오 플레이어로 렌더링됩니다. 전화 통합에서 오디오 응답은 전화를 통해 재생됩니다.
오디오 응답 유형은 다음 채널 통합에서 지원됩니다.
- 웹 대화
- 전화
- SMS
- Slack
음성 응답을 추가하려면 다음 단계를 완료하십시오
-
어시스턴트가 말하기 필드에서
오디오 아이콘을 클릭하십시오.
-
URL 에 호스팅된 오디오 클립의 전체 URL 입력합니다:
-
오디오 파일에 직접 링크하려면 MP3 또는 WAV와 같은 표준 형식의 파일에 URL을 지정하십시오. 웹 채팅에서 연결된 오디오 클립은 내장된 오디오 플레이어로 표시됩니다.
-
지원되는 오디오 호스팅 서비스의 오디오 클립에 링크하려면 오디오 클립에 URL을 지정하십시오. 웹 채팅에서, 링크된 오디오 클립은 호스팅 서비스의 임베드 가능한 플레이어를 사용하여 렌더링됩니다.
브라우저에서 오디오 파일에 액세스하는 데 사용할 URL 지정합니다(예:
https://soundcloud.com/ibmresearch/fallen-star-amped
). URL 임베드 가능한 형식으로 변환할 필요는 없습니다. 웹 채팅이 자동으로 변환합니다.다음 서비스에 호스트된 오디오를 임베드할 수 있습니다.
-
-
선택적으로 제공된 필드에 제목, 설명 및 대체 텍스트를 지정하십시오. 웹 대화 통합에서 제목 및 설명은 오디오 플레이어와 함께 표시됩니다.
변수에 대한 참조는 지원되지 않습니다. 일부 통합 채널에서는 제목 또는 설명을 무시합니다.
비디오 응답 추가하기
사용 방법 데모, 프로모션 클립 또는 기타 비디오 컨텐츠를 표시하려면 비디오 응답을 추가하십시오. 웹 대화에서 비디오 응답은 임베드된 비디오 플레이어로 렌더링됩니다.
Video 응답 유형은 다음 채널 통합에서 지원됩니다.
- 웹 대화
- SMS
- Slack
동영상 답변을 추가하려면 다음 단계를 완료하십시오
-
어시스턴트 말 필드에서
비디오 아이콘을 클릭하십시오.
-
URL 에, 호스팅된 비디오의 전체 URL 입력하세요:
-
비디오 파일에 직접 링크하려면 MPEG 또는 AVI와 같은 표준 형식의 파일에 URL을 지정하십시오. 웹 채팅에서 링크된 비디오는 임베드된 비디오 플레이어로 렌더링됩니다.
HLS(
.m3u8
) 및 DASH(MPD) 스트리밍 비디오는 지원되지 않습니다. -
지원되는 비디오 호스팅 서비스에서 호스트되는 비디오에 링크하려면 비디오에 대한 URL을 지정하십시오. 웹 채팅에서는 호스팅 서비스의 임베드 가능한 플레이어를 사용하여 링크된 비디오가 렌더링됩니다.
브라우저에서 동영상을 볼 때 사용할 URL 지정합니다(예:
https://www.youtube.com/watch?v=52bpMKVigGU
). URL 임베드 가능한 형식으로 변환할 필요는 없습니다. 웹 채팅이 자동으로 변환합니다.다음 서비스에서 호스팅되는 동영상을 삽입할 수 있습니다
- YouTube
- Vimeo
- Twitch
- 스트리밍 가능
- 위스티아
- 비디어드
-
-
선택적으로 제공된 필드에 비디오 제목, 설명 및 대체 텍스트를 지정하십시오. 웹 대화 통합에서 제목 및 설명은 비디오 플레이어와 함께 표시됩니다.
변수에 대한 참조는 지원되지 않습니다. 일부 통합 채널에서는 제목 또는 설명을 무시합니다.
-
비디오를 특정 표시 크기로 스케일링하려면 기본 높이 필드에 숫자를 지정하십시오.
Iframe 응답 추가하기
Iframe 응답을 추가하여 다른 웹사이트의 콘텐츠를 HTML iframe
요소로 채팅 창 안에 직접 삽입합니다. 고객이 대화를 떠나지 않고 외부 서비스와의 일부 상호작용을 수행할 수 있도록 하려는 경우 iframe 응답이 유용합니다. 예를 들어, 웹 채팅 내에서 다음 예제를 표시하기 위해 iframe 응답을 사용할 수 있습니다
- Google Maps 의 대화식 맵
- SurveyMonkey 를 사용하는 설문조사
- OpenTable 통한 예약 양식
- Calendly 를 사용하는 스케줄링 양식
웹 대화에는 iframe을 포함할 수 있는 두 가지 방법이 있습니다.
- 임베드된 컨텐츠를 설명하는 미리보기 카드와 같습니다. 고객은 이 카드를 클릭하여 프레임을 표시하고 컨텐츠와 상호작용할 수 있습니다.
- 대화 내에서 의미하는 인라인입니다. 이 옵션은 iframe 컨텐츠의 작은 부분에 적합합니다.
iframe 응답 유형은 다음 채널 통합에서 지원됩니다.
- 웹 대화
iframe 응답 유형을 추가하려면 다음 단계를 완료하십시오.
-
어시스턴트가 말하기 필드에서 iframe 아이콘 (
) 을 클릭하십시오.
-
iframe 소스 필드에서 외부 컨텐츠에 전체 URL을 추가하십시오.
URL은 HTML
iframe
요소에 임베드 가능한 컨텐츠를 지정해야 합니다. 사이트마다 콘텐츠 임베딩에 대한 제한 사항과 임베딩 가능한 URL을 생성하는 과정이 다릅니다. 임베드 가능한 URL은iframe
요소의src
속성 값으로 지정할 수 있는 URL입니다.예를 들어, Google 사용하는 대화형 지도를 삽입하려면 Google 사용할 수 있습니다. 자세한 정보는 맵 임베드 API 개요를 참조하십시오. 다른 사이트에는 임베드 가능한 컨텐츠를 작성하기 위한 다른 프로세스가 있습니다.
어시스턴트에 웹 사이트 컨텐츠를 임베드할 수 있는 권한을 제공하는
Content-Security-Policy: frame-src
사용에 대한 기술 세부사항은 CSP: frame-src를 참조하십시오. -
선택적으로 제목 필드에 자세한 제목을 추가하십시오.
웹 대화에서 사용자가 추가하는 제목이 미리보기 카드에 표시됩니다. 고객이 미리보기 카드를 클릭하여 외부 컨텐츠를 렌더링합니다.
제목을 지정하지 않으면 웹 채팅은 URL 에서 메타데이터를 검색하고 소스에 지정된 내용의 제목을 표시합니다.
변수에 대한 참조는 지원되지 않습니다.
-
대화의 플로우에서 iframe을 미리보기 카드가 아닌 표시하려면 iframe 인라인 표시 를 켜기로 설정하십시오. iframe의 높이를 설정할 수도 있습니다. 기본값은 180 픽셀입니다.
기술적 세부 사항: iframe
샌드박싱
웹 채팅에 의해 iframe에 로드되는 콘텐츠는 샌드박스로 보호되어 보안 취약점을 줄이는 권한을 제한합니다. 웹 대화는 iframe
요소의 sandbox
속성을 사용하여 다음 권한만 부여합니다.
권한 | 설명 |
---|---|
allow-downloads |
사용자가 다운로드를 시작한 경우 네트워크에서 파일을 다운로드할 수 있습니다. |
allow-forms |
양식 제출을 허용합니다. |
allow-scripts |
스크립트를 실행할 수 있지만 팝업 창은 열리지 않습니다. |
allow-same-origin |
콘텐츠가 자체 데이터 저장소(예: 쿠키)에 액세스할 수 있도록 허용하고, JavaScript 에 대한 제한된 액세스를 허용합니다. |
샌드박스된 iframe 안에서 실행되는 스크립트는 외부 페이지와 iframe의 출처가 다를 경우 iframe 외부의 콘텐츠를 변경할 수 없습니다. iframe 응답을 사용하여 웹 대화 위젯이 호스팅되는 페이지와 원본이 동일한 컨텐츠를 임베드하는 경우 주의하십시오. 이 상황에서 임베디드 컨텐츠는 샌드박싱을 차단하고 프레임 외부의 컨텐츠에 대한 액세스를 얻을 수 있습니다. 이 잠재적 취약성에
대한 자세한 정보는 sandbox
속성 문서를 참조하십시오.
기술 세부사항: iframe
미리보기 카드
웹 대화의 iframe
응답 유형은 사용자가 웹 대화에서 방문하는 웹 페이지의 이미지, 제목 및 설명을 포함하는 미리보기 카드를 표시합니다.
미리보기 카드에 이미지, 제목 및 설명을 표시하려면 웹 페이지에 <head>
태그 안에 다음 <meta>
태그가 있어야 합니다.
<meta property="og:image" content="https://.../image.jpg" />
<meta property="og:image:url" content="https://.../image.jpg" />
<meta property="og:title" content="The webpage title" />
<meta property="og:description" content="The webpage description" />
지정된 이러한 메타데이터 특성은 Open Graph Protocol 에서 가져옵니다.
메타데이터는 선택사항입니다. 웹 대화는 웹 대화가 성공적으로 페치한 웹 페이지 URL및 메타데이터가 있는 미리보기 카드를 표시합니다.
응답 일시정지
일시정지 응답을 사용하여 어시스턴트가 다음 응답 전에 지정된 간격 동안 대기하도록 하십시오. 이 일시정지는 요청이 완료되거나 응답 사이에 일시정지하는 활성 에이전트처럼 작동하는 시간을 허용합니다. 일시정지 기간은 0
- 60
초여야 하며, 여기에는 최대 milliseconds
까지 일시정지를 구성하기 위한 초의 10진수가 포함될 수 있습니다.
일시정지 응답 은 일반적으로 다른 응답과 함께 사용됩니다. 기본적으로 활성 에이전트를 시뮬레이션하기 위해 일시정지 중에 입력 표시기 애니메이션이 표시됩니다.
일시정지 응답 유형은 다음 채널 통합에서 지원됩니다.
- 웹 대화
전화 채널을 사용하면 어시스턴트 출력에 SSML break
요소를 포함하여 일시정지를 추가할 수 있습니다. 자세한 정보는 Text to Speech 문서를 참조하십시오.
일시 중지 응답을 추가하려면:
-
어시스턴트 표시 필드에서
일시정지 아이콘을 클릭하십시오.
-
지속 기간 필드에
seconds
의 일시정지 기간을 입력하십시오.지속 기간은
60 seconds
을 (를) 초과할 수 없습니다. 또한 지속 기간 필드에second
의 10진수를 입력하여milliseconds
까지 응답을 일시정지할 수 있습니다. 예를 들어,10.50 seconds
를 입력하면10500 milliseconds
에 대한 응답이 일시정지됩니다. 고객들은 보통 누군가 응답을 입력할 때까지 약 8초 정도 기다릴 의향이 있습니다. -
입력 표시기 는 기본적으로 켜짐 으로 설정됩니다. 원하는 경우 이를 Off 로 설정할 수 있습니다.
일시정지가 끝났음을 명확히 표시하도록 일시정지 후 다른 응답 유형(예: 텍스트 응답 유형)을 추가하십시오.