API 상호작용

통합 옵션 중 하나를 사용하지 않는 경우 최종 사용자와 직접 상호작용하는 코드를 작성해야 합니다. 또한 최종 사용자 표현을 보내고 인텐트 일치를 수신하려면 대화 차례마다 Dialogflow의 API와 직접 상호작용해야 합니다. 다음 다이어그램은 API와 상호작용하는 경우의 처리 흐름을 보여줍니다.

API의 흐름을 보여주는 다이어그램
  1. 최종 사용자가 표현을 입력하거나 말합니다.
  2. 서비스가 이 최종 사용자 표현을 Dialogflow에 인텐트 탐지 요청 메시지로 보냅니다.
  3. Dialogflow가 서비스에 인텐트 감지 응답 메시지를 보냅니다. 이 메시지에는 일치하는 인텐트, 작업, 매개변수, 인텐트에 정의된 응답에 대한 정보가 포함됩니다.
  4. 서비스가 필요에 따라 데이터베이스 쿼리 또는 외부 API 호출과 같은 작업을 수행합니다.
  5. 서비스가 최종 사용자에게 응답을 보냅니다.
  6. 최종 사용자가 응답을 보거나 듣습니다.

프로젝트 설정 및 인증

API를 호출하기 전에 GCP 프로젝트와 인증을 설정해야 합니다. 설정 빠른 시작의 단계를 따르세요.

에이전트 빌드

대부분의 경우 Dialogflow 콘솔(문서 보기, 콘솔 열기)을 사용하여 에이전트를 빌드해야 합니다. 콘솔 빠른 시작 페이지의 단계에 따라 에이전트를 만들 수 있습니다. 또한 Dialogflow API를 사용하여 고급 시나리오용 에이전트를 빌드할 수도 있습니다. 많은 개념 페이지는 콘솔을 사용하여 에이전트를 빌드하는 데 중점을 두지만 관련 API 유형에 대한 링크도 제공합니다.

REST, gRPC, 클라이언트 라이브러리

REST, gRPC 또는 제공된 클라이언트 라이브러리를 통해 Dialogflow API에 액세스할 수 있습니다. 이러한 옵션에 대한 자세한 내용은 API 사용 개요를 참조하세요.

세션

세션은 Dialogflow 에이전트와 최종 사용자 간의 대화를 나타냅니다. 대화를 시작할 때 세션을 만들고 대화 차례마다 이 세션을 사용합니다. 대화가 종료되면 세션 사용을 중단합니다.

여러 최종 사용자와 동시에 진행되는 대화에서 동일한 세션을 사용하면 안 됩니다. Dialogflow는 각 활성 세션에 현재 활성인 컨텍스트를 유지합니다. Dialogflow는 20분 동안 세션 데이터를 저장합니다.

각 세션은 시스템에서 생성되는 세션 ID로 고유하게 구분됩니다. 인텐트 감지 요청에 새 세션 ID를 제공하여 새 세션을 만듭니다. 세션 ID는 최대 36바이트 크기의 문자열입니다. 시스템은 고유한 세션 ID를 생성합니다. 세션 ID는 랜덤 숫자, 해싱된 최종 사용자 식별자 또는 사용자가 생성하기 편리한 기타 값일 수 있습니다.

인텐트 감지

상호작용에 API를 사용하면 서비스는 최종 사용자와 직접 상호작용합니다. 각 대화 차례에서 서비스는 Sessions 유형의 detectIntent 또는 streamingDetectIntent 메서드를 호출하여 Dialogflow에 최종 사용자 표현을 전송합니다. Dialogflow는 일치하는 인텐트, 작업, 매개변수, 인텐트에 정의된 응답에 대한 정보로 응답합니다. 서비스는 필요에 따라 작업을 수행하고(예: 데이터베이스 쿼리 또는 외부 API 호출) 최종 사용자에게 메시지를 전송합니다. 이 프로세스는 대화가 종료될 때까지 계속됩니다.

API 빠른 시작 페이지방법 페이지에서 인텐트 감지 호출의 예시를 확인할 수 있습니다.