fulfillment

에이전트의 대화 차례인 경우 에이전트는 질문에 대한 답변, 정보 쿼리 또는 세션 종료를 통해 최종 사용자에게 응답해야 합니다. 또한 에이전트가 서비스에 문의하여 동적 응답을 생성하거나 차례를 위해 조치를 취해야 할 수도 있습니다. fulfillment는 이 모든 작업을 완료하는 데 사용됩니다.

fulfillment에는 다음 중 하나가 포함될 수 있습니다.

  • 정적 응답 메시지입니다.
  • 웹훅은 동적 응답 또는 조치를 취할 것을 요청합니다.
  • 매개변수 값을 설정하거나 재정의할 매개변수 사전 설정

에이전트의 차례에는 여러 개의 fulfillment를 호출할 수 있으며(호출하는 것이 바람직한 경우도 있음), 각 fulfillment는 응답 메시지를 생성할 수 있습니다. Dialogflow는 이러한 응답을 응답 큐에 유지합니다. 에이전트의 차례가 끝나면 Dialogflow는 순서가 지정된 응답을 최종 사용자에게 전송합니다.

ES fulfillment는 웹훅 서비스 연결로 제한됩니다. CX에서 fulfillment 범위가 확장되었으므로 이제 모든 유형의 프롬프트, 응답을 다룹니다.

fulfillment 사용 사례

Fulfillment는 응답 메시지가 필요한 모든 곳에서 사용됩니다.

콘솔에서 이러한 사용 사례마다 fulfillment 수정 패널을 엽니다.

fulfillment 스크린샷

정적 응답 메시지(대화상자 옵션)

정적 응답 메시지는 설계 시 정의한 에이전트 응답입니다. fulfillment를 만들 때 정의합니다. 런타임에 이러한 응답은 응답 큐에 추가됩니다.

응답 메시지의 유형에는 여러 가지가 있으며 다음 하위 섹션에서 설명합니다. 콘솔을 사용하는 경우 fulfillment 패널에 초기 텍스트 응답 메시지 카드가 있지만 대화 옵션 추가를 클릭하면 더 많은 기타 응답 메시지 유형의 카드를 추가할 수 있습니다.

텍스트

텍스트 응답 메시지는 최종 사용자에게 텍스트 대화상자를 보냅니다. 인텐트 인식 API 호출이나 통합 호출에서 음성 합성을 사용하는 경우 이 텍스트는 오디오 콘텐츠를 생성하는 데 사용됩니다. 이 경우 제공되는 텍스트는 선택적으로 음성 합성 마크업 언어(SSML)를 사용할 수 있습니다.

각 텍스트 내에 텍스트 응답 카드 여러 개와 텍스트 응답 여러 개를 정의할 수 있습니다. 카드 여러 개를 정의하면 런타임에 단일 응답으로 연결됩니다. 카드 내에 응답을 여러 개 정의하면 런타임에 카드의 메시지 중 하나가 무작위로 선택됩니다.

이러한 문자 메시지에는 매개변수 참조 및 인라인 시스템 함수가 포함될 수 있습니다.

커스텀 페이로드

일부 통합에서는 다양한 응답을 처리하도록 커스텀 페이로드 응답을 지원합니다. 이러한 커스텀 페이로드는 통합 문서에 정의된 JSON 형식으로 제공됩니다. 예를 들어 Dialogflow Messenger 커스텀 페이로드 형식을 참조하세요.

또한 개발 중인 통합에 커스텀 페이로드를 보낼 수도 있습니다. Dialogflow에서 처리되지 않으므로 자체 비즈니스 로직에서 처리해야 합니다.

실시간으로 상담사에게 전달

이 응답은 인텐트 인식 API 호출자에게 대화가 상담사에게 전달되었음을 알립니다. Dialogflow는 이 신호를 사용하여 측정용으로 전달된 대화를 식별하며 어떤 방식으로도 세션 상태를 변경하지 않습니다. 시스템이나 통합은 이 신호를 사용하여 대화를 전달하는 데 필요한 조치를 수행할 수 있습니다. Dialogflow는 이 데이터에 구조를 적용하지 않으므로 시스템에 맞는 구조를 선택할 수 있습니다.

대화 성공 메타데이터

이 응답은 Dialogflow 에이전트와의 대화가 성공했음을 인텐트 인식 API 호출자에 알립니다. Dialogflow는 이 신호만 사용하여 측정용으로 성공한 대화를 식별하며 어떠한 방식으로도 세션 상태를 변경하지 않습니다. 시스템이나 통합은 이 신호를 사용하여 필요한 조치를 취할 수 있습니다. Dialogflow는 이 데이터에 구조를 적용하지 않으므로 시스템에 맞는 구조를 선택할 수 있습니다.

사전 녹음된 오디오 재생

이 응답은 이 기능을 지원하는 통합의 오디오 파일을 재생합니다. 오디오 파일에 공개적으로 사용 가능한 URL을 제공해야 합니다. 예를 들어 Cloud Storage로 공개 파일을 호스팅할 수 있습니다.

출력 오디오 텍스트

이 응답은 텍스트 응답과 비슷하지만 음성 합성에만 적용됩니다. 에이전트가 텍스트 및 음성 세션을 모두 처리할 수 있는 경우 고유한 텍스트출력 오디오 텍스트 응답을 사용하여 텍스트와 음성에 대한 서로 다른 사용자 환경을 만들 수 있습니다. 음성 세션에 출력 오디오 텍스트가 제공되면 일반 텍스트 응답은 무시됩니다.

에이전트가 텍스트 및 음성 세션을 모두 처리하며 동일한 응답 메시지가 필요한 경우 텍스트 및 음성 세션 모두에 텍스트 응답을 사용하세요.

출력 오디오 텍스트는 텍스트 응답과 비슷하게 연결됩니다. 출력 오디오 텍스트 응답이 텍스트와 SSML의 조합인 경우 연결된 결과는 SSML로 처리됩니다. 에이전트 설계자는 텍스트 또는 SSML을 일관되게 사용해야 합니다.

조건부 응답

이 응답 유형은 조건부 응답에 사용됩니다. 일반적인 형식은 다음과 같습니다.

if [condition]
  [response]
elif [condition]
  [response]
elif [condition]
  [response]
else
  [response]
endif

각 매개변수는 다음과 같습니다.

  • [condition]경로 조건에 사용되는 형식과 동일합니다.
  • [response]는 텍스트 응답입니다.
  • elifelse 블록은 선택사항입니다.

예를 들면 다음과 같습니다.

if $session.params.user-age >= 21
  Ok, you may enter.
else
  Sorry, you cannot enter.
endif

[condition][response] 모두 인라인 시스템 함수를 사용하여 대화 중에 동적 값을 생성할 수 있습니다. 자세한 내용은 시스템 함수경로 조건의 참조를 확인하세요.

다국어 에이전트의 경우 [condition]은 모든 언어에서 일반적으로 사용되는 반면 [response]는 언어별로 다릅니다. 콘솔에서 한 언어의 [condition]을 변경하면 이 부분은 모든 에이전트의 언어로 업데이트되고 새 조건이 되기 때문에 [condition] 업데이트 시 선택한 언어 이외의 모든 언어에 대해 [response]가 삭제됩니다.

웹훅 호출

fulfillment가 호출되고 fulfillment에 웹훅이 있으면 에이전트가 웹훅에 요청을 보냅니다. 웹훅은 서비스에 필요한 모든 작업을 수행하고, 동적 응답 메시지를 제공하고, 매개변수 값을 재정의하고, 현재 페이지를 변경할 수 있습니다.

매개변수 사전 설정

fulfillment를 사용하여 현재 매개변수 값을 설정하거나 재정의하는 사전 설정을 제공할 수 있습니다. 이러한 사전 설정은 정적 응답 메시지를 해결하거나 웹훅을 호출하기 전에 적용됩니다.

또한 시스템 함수를 사용하여 매개변수를 동적으로 생성된 값으로 사전 설정할 수 있습니다.

그 예는 다음과 같습니다.

  • now 매개변수를 현재 시간으로 설정합니다.
    매개변수
    지금 $sys.func.NOW()
  • 기존 매개변수 counter를 1씩 증분합니다.
    매개변수
    카운터 $sys.func.ADD($session.params.counter, 1)

응답 큐

에이전트의 차례에는 여러 개의 fulfillment를 호출할 수 있으며(호출하는 것이 바람직한 경우도 있음), 각 fulfillment는 응답 메시지를 생성할 수 있습니다. Dialogflow는 이러한 응답을 응답 큐에 유지합니다.

스트리밍 API에 대한 부분 응답

기본적으로 Dialogflow는 에이전트의 차례가 끝나면 최종 사용자에게 정렬된 응답을 보냅니다. fulfillment에서 부분 응답 반환 옵션을 사용 설정하여 스트리밍 API를 사용할 때 현재 큐에 추가된 응답을 부분 응답으로 반환할 수도 있습니다. 자세한 내용은 페이지의 수명 주기를 참조하세요.

예를 들어 웹훅이 장시간 실행될 가능성이 있는 경우 fulfillment에 정적 응답을 추가하고 부분 응답을 사용 설정할 수 있습니다. 이렇게 하면 웹훅이 호출되기 전에 Dialogflow가 응답 큐를 삭제하고 모든 메시지를 부분 응답으로 전송합니다.

시뮬레이터에서 이 기능을 테스트하려면 부분 응답도 사용 설정해야 합니다.

시뮬레이터 부분 응답 스크린샷

다음 예시에서는 웹훅이 완료되는 데 5초가 소요되며 부분 응답을 사용 설정하지 않았다고 가정합니다. Dialogflow 에이전트의 대화 차례는 웹훅이 완료될 때까지 끝나지 않습니다. 이 5초의 차례 중 웹훅을 기다릴 때 응답이 큐에 추가되고 차례가 끝날 때까지 최종 사용자에게 반환되지 않습니다. 이로 인해 사용자 경험에 대한 만족도가 떨어집니다.

부분 응답 제외.

첫 번째 fulfillment에서 부분 응답을 사용 설정하면 Dialogflow는 첫 번째 fulfillment 메시지를 빠르게 반환하고 웹훅을 호출합니다. 웹훅이 완료되면 Dialogflow가 최종 응답을 반환합니다. 최종 사용자 환경에서는 짧은 대기를 기대하므로 이 시나리오에서는 최종 사용자 환경이 개선됩니다. 또한 웹훅 호출은 최종 사용자에게 전송되는 응답과 동시에 실행됩니다.

부분 응답 포함.