처리 이전

인텐트와 장면을 설정한 후에는 작업 빌더의 요청 및 응답 형식의 변경사항을 반영하도록 처리 코드를 업데이트해야 합니다. Actions Builder의 추가 기능을 활용할 기회이기도 합니다. 이 페이지에서는 처리 코드를 업데이트할 때의 일반적인 단계와 고려사항을 설명합니다.

처리 방식 고려

프로젝트의 처리 코드는 대화 모델과 개발 플랫폼의 기능에 따라 달라집니다. Actions Builder는 대화를 빌드하는 방식을 바꾸고 프로젝트 처리에 접근하는 방식도 바꿀 가능성이 있는 새로운 대화 모델과 기능을 도입합니다. 이 섹션에서는 Dialogflow와 다른 Actions Builder의 기능과 이러한 차이점으로 인해 처리 코드를 구현하는 방식이 어떻게 달라지는지 설명합니다.

  • 대화 구현 변경사항

    • Dialogflow는 인텐트 간 컨텍스트 기반 대화 흐름을 사용합니다. 여기서는 개별 인텐트가 학습 문구와 이전 인텐트의 입력/출력 컨텍스트를 기반으로 일치됩니다.
    • Actions Builder의 대화 흐름에서는 장면을 대화 차례의 컨테이너로 사용합니다. Dialogflow의 컨텍스트와 마찬가지로 장면 내에서 특정 인텐트를 일치시킬 수 있습니다. 전환은 매칭되는 인텐트에 따라 어떤 장면으로 전환할지 정의합니다.

  • 재사용 가능한 웹훅 함수

    • Dialogflow에서 웹훅 핸들러는 개별 인텐트에 연결됩니다. 추가 로직이 필요한 경우 새 함수를 처리할 별도의 인텐트를 만들어야 합니다.
    • 웹훅 핸들러에는 Actions Builder에 커스텀 핸들러 이름이 있습니다. 이 기능을 사용하면 프로젝트 전체의 여러 장면에서 함수를 호출할 수 있습니다.

  • 웹훅을 호출하는 다양한 방법

    • Dialogflow에서 인텐트당 하나의 웹훅 접근 방식에는 프로젝트 처리 내에서 더 많은 대화형 로직을 용이하게 하기 위한 추가 인텐트가 필요합니다.
    • 작업 빌더를 사용하면 진입 시, 슬롯 채우기, 맞춤 및 시스템 인텐트 일치 등 장면 내의 여러 위치에서 웹훅 호출을 할 수 있습니다.

처리 코드 업데이트

각 작업의 처리 코드는 작업의 복잡성과 목적에 따라 다르지만 코드를 업데이트할 때 일반적으로 따라야 하는 단계가 있습니다.

  1. 최신 버전의 클라이언트 라이브러리를 다운로드하여 설치합니다.

    npm install @assistant/conversation

  2. 코드의 require 문을 업데이트합니다. 예를 들면 다음과 같습니다.

    const {
  SimpleResponse,
  BasicCard,
  Image,
} = require('actions-on-google');

    위의 코드는 다음과 같이 업데이트됩니다.

    const {
  conversation,
  Simple,
  Card,
  Image,
} = require('@assistant/conversation');

  3. 코드를 리팩터링하여 새 메서드를 사용합니다.

    • 인텐트 핸들러: app.intent → app.handle
    • 응답/프롬프트: conv.ask → conv.add
    • 표시 경로/기기 기능: conv.surface.capabilities.has('actions.capability.SCREEN_OUTPUT') → conv.device.capabilities.includes('RICH_RESPONSE')
    • 데이터 저장: conv.data → conv.session.params

    • 응답 유형:

      • SimpleResponse → Simple
      • BasicCard → Card
      • Suggestions → Suggestion

    • 인텐트 매개변수: conv.parameters[KEY] → conv.intent.parameters[KEY].resolved

    • 컨텍스트/장면 전환: conv.contexts.set(content_name, 5); → conv.scene.next.name = 'context_name'

    • 대화 종료: conv.close(response) → conv.add.response; conv.scene.next.name = 'actions.page.END_CONVERSATION'

  4. Builder의 새 응답 프리미티브를 활용할 수 있도록 응답 코드를 업데이트합니다. 예를 들면 다음과 같습니다.

    conv.ask(new Suggestions (['a', 'b']));

    위의 코드는 다음과 같이 업데이트됩니다.

    for (suggestion of ['a', 'b']) {
  conv.add.(new Suggestion({title: suggestion}))
}

전체 메서드 목록은 아래의 처리 코드 변환 맵을 참조하세요.

다음 페이지를 사용하여 요청 페이로드와 응답 페이로드를 비교합니다.

웹훅 설정

처리를 업데이트한 후 프로젝트의 장면 전체에서 웹훅 호출을 사용 설정합니다. 이전 도구는 Dialogflow 인텐트의 웹훅 설정을 이전하지만 리팩터링된 처리 코드와 웹훅 함수가 변경될 수 있으므로 이러한 설정을 검토해야 합니다.

Dialogflow에서는 인텐트에서 웹훅을 사용할 수 있으며, 인텐트가 일치하면 처리 코드에 실행할 핸들러와 함수가 포함됩니다. Actions Builder에서 웹훅은 호출 인텐트 또는 장면 내에서 트리거될 수 있으며, 이는 처리 엔드포인트로 요청을 전송합니다. 처리에는 요청의 JSON 페이로드를 처리하는 웹훅 핸들러가 포함되어 있습니다. 다음 상황에서 웹훅을 트리거할 수 있습니다.

  • 호출 인텐트 일치 후
  • 장면에 들어가는 동안
  • 장면의 조건 단계에서 조건이 true로 평가된 후
  • 장면의 슬롯 정리 단계 중
  • 장면의 입력 단계에서 인텐트 일치가 발생한 후

Dialogflow에서 Actions Builder로 이전할 때는 대화 흐름의 변경사항을 고려해야 합니다. 웹훅을 호출하는 시기와 위치는 변경될 수 있기 때문입니다.

웹훅 호출을 사용 설정하려면 다음 단계를 따르세요.

  1. 웹훅을 호출하려는 장면을 선택합니다.

  2. 웹훅을 사용 설정할 상태를 선택합니다. 다음 상태 중 하나 이상에 웹훅을 사용 설정할 수 있습니다.

    • 진입 시
    • 조건
    • 슬롯 채우기
    • 사용자 인텐트 처리
    • 시스템 인텐트 처리

  3. 웹훅 호출 옵션을 선택합니다.

  4. 처리 코드 내에서 정의한 웹훅 핸들러를 입력합니다.

  5. 저장을 클릭합니다.

  6. 테스트로 이동하여 웹훅 호출 및 처리 변경사항을 사용해 보세요.

처리 코드 변환 맵

아래 표에서는 Dialogflow의 처리 코드 문법이 Actions Builder 코드로 어떻게 변환되는지 보여줍니다. 전체 메서드 목록은 작업 빌더 및 SDK 참조 문서를 확인하세요.

Dialogflow 작업 빌더
conv.data conv.session.params
conv.ask conv.add
conv.close conv.scene.next.name = 'actions.scene.END_CONVERSATION'
conv.user.storage conv.user.params
conv.input.raw conv.intent.query
conv.parameters conv.intent.params[key].resolved
conv.arguments.get('MEDIA_STATUS')
mediaStatus.status==='FINISHED'		 conv.intent.params['MEDIA_STATUS']
mediaStatus.resolved==='FINISHED'
이벤트 시스템 인텐트 처리:
MEDIA_STATUS_FINISHED
MEDIA_STATUS_FAILED
conv.device.capabilities.has("actions.capability.SCREEN_OUTPUT") conv.device.capabilities.includes("RICH_RESPONSE")
app.intent app.handler
app.middleware app.middleware
간단한 응답 prompt -firstSimple
리치 응답 prompt -content -card: object -image: object -table: object -media: object -suggestions -link

추가 도구에 대한 정보는 아래에서 확인할 수 있습니다.

이전
프로젝트 마이그레이션