Dialogflow CX 설정

이 가이드에서는 Dialogflow CX 사용을 시작하는 데 필요한 모든 설정 절차에 대하여 설명합니다.

시작하기 전에

이 가이드를 읽기 전에 다음을 수행해야 합니다.

  1. Dialogflow CX 기본사항 읽기
  2. 버전 읽기

Google Cloud Console 정보

Google Cloud Console(문서 보기, Console 열기)은 Google Cloud 제품을 사용하는 시스템을 프로비저닝, 구성, 관리, 모니터링하는 데 사용되는 웹 UI입니다. Google Cloud Console을 사용하여 Dialogflow 리소스를 설정 및 관리합니다.

프로젝트 만들기

Google Cloud에서 제공하는 서비스를 사용하려면 프로젝트를 만들어야 합니다. 프로젝트는 모든 Google Cloud 리소스를 구성합니다. 프로젝트는 공동작업자, 사용 설정된 API(및 기타 리소스), 모니터링 도구, 결제 정보, 인증, 액세스 제어로 구성됩니다. 프로젝트를 하나 또는 여러 개 만들 수 있으며 이를 사용하여 Google Cloud 리소스를 리소스 계층 구조로 구성할 수도 있습니다. 프로젝트를 만들 때 프로젝트 ID를 기록해 둡니다. API 호출에 이 ID가 필요합니다. 프로젝트에 대한 자세한 내용은 Resource Manager 문서를 참조하세요.

Google Cloud Console의 프로젝트 선택기 페이지에서 Google Cloud 프로젝트를 선택하거나 만듭니다.

프로젝트 선택기로 이동

결제 사용 설정

결제 계정은 정해진 리소스 집합의 비용을 누가 지불하는지 정의하는 데 사용되며 하나 이상의 프로젝트에 연결할 수 있습니다. 프로젝트 사용량이 연결된 결제 계정으로 청구됩니다. 대부분의 경우 프로젝트를 만들 때 결제를 구성합니다. 자세한 내용은 결제 문서를 참조하세요.

Cloud 프로젝트에 결제가 사용 설정되어 있는지 확인합니다. 프로젝트에 결제가 사용 설정되어 있는지 확인하는 방법을 알아보세요.

API 사용 설정

프로젝트에 Dialogflow API를 사용 설정해야 합니다. API 사용 설정에 대한 자세한 내용은 서비스 사용 문서를 참조하세요.

Dialogflow API를 사용 설정합니다.

API 사용 설정

인증 설정

Dialogflow API를 사용하려면 인증을 설정해야 합니다. API를 사용하는 모든 클라이언트 애플리케이션은 인증되어야 하며 요청된 리소스에 대한 액세스 권한을 받아야 합니다. 이 섹션에서는 중요한 인증 개념을 설명하고 설정 단계를 안내합니다. 자세한 내용은 Google Cloud 인증 개요를 참조하세요.

서비스 계정 정보

인증에는 여러 옵션이 있지만 인증 및 액세스 제어에는 서비스 계정을 사용하는 것이 좋습니다. 서비스 계정은 최종 사용자가 아닌 애플리케이션의 사용자 인증 정보를 제공합니다. 서비스 계정은 프로젝트에서 소유하며 하나의 프로젝트에 여러 개의 서비스 계정을 만들 수 있습니다. 자세한 내용은 서비스 계정 이해를 참조하세요.

역할 정보

ID가 API를 호출할 때 Google Cloud는 이 ID에 적절한 권한이 있을 것을 요구합니다. 서비스 계정에 역할을 부여하여 권한을 부여할 수 있습니다. 자세한 내용은 ID 및 액세스 관리(IAM) 문서를 참조하세요.

Dialogflow API를 살펴보기 위해 아래 단계에서 프로젝트 > 소유자 역할을 사용할 수 있습니다. 이 경우 서비스 계정에 프로젝트에 대한 전체 액세스 권한이 부여됩니다. Dialogflow 역할에 대한 자세한 내용은 Dialogflow 액세스 제어 문서를 참조하세요.

서비스 계정 키 정보

서비스 계정은 하나 이상의 공개 키/비공개 키 쌍을 사용합니다. 새 키 쌍을 만들 때 비공개 키를 다운로드합니다. 비공개 키는 API를 호출할 때 사용자 인증 정보를 생성하는 데 사용됩니다. 비공개 키의 보안 및 키 순환과 같은 다른 관리 작업의 책임은 사용자에게 있습니다.

서비스 계정을 만들고 비공개 키 파일을 다운로드합니다.

서비스 계정을 만듭니다.

  1. Cloud Console에서 서비스 계정 만들기 페이지로 이동합니다.

    서비스 계정 만들기로 이동
  2. 프로젝트를 선택합니다.
  3. 서비스 계정 이름 필드에 이름을 입력합니다. Cloud Console은 이 이름을 기반으로 서비스 계정 ID 필드를 채웁니다.

    서비스 계정 설명 필드에 설명을 입력합니다. 예를 들면 Service account for quickstart입니다.

  4. 만들기를 클릭합니다.
  5. 역할 선택 필드를 클릭합니다.

    빠른 액세스에서 기본을 클릭한 후 소유자를 클릭합니다.

  6. 계속을 클릭합니다.
  7. 완료를 클릭하여 서비스 계정 만들기를 마칩니다.

    브라우저 창을 닫지 마세요. 다음 단계에서 사용합니다.

서비스 계정 키 만들기

  1. Cloud Console에서 만든 서비스 계정의 이메일 주소를 클릭합니다.
  2. 를 클릭합니다.
  3. 키 추가를 클릭한 후 새 키 만들기를 클릭합니다.
  4. 만들기를 클릭합니다. JSON 키 파일이 컴퓨터에 다운로드됩니다.
  5. 닫기를 클릭합니다.

사용자 환경에서 서비스 계정 키 파일 사용

GOOGLE_APPLICATION_CREDENTIALS 환경 변수를 설정하여 애플리케이션 코드에 사용자 인증 정보를 제공합니다. [PATH]를 서비스 계정 키가 포함된 JSON 파일의 파일 경로로 바꿉니다. 이 변수는 현재 셸 세션에만 적용되므로 새 세션을 연 경우 변수를 다시 설정합니다.

Linux 또는 macOS

export GOOGLE_APPLICATION_CREDENTIALS="[PATH]"

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

export GOOGLE_APPLICATION_CREDENTIALS="/home/user/Downloads/my-key.json"

Windows

PowerShell:

$env:GOOGLE_APPLICATION_CREDENTIALS="[PATH]"

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

$env:GOOGLE_APPLICATION_CREDENTIALS="C:\Users\username\Downloads\my-key.json"

명령어 프롬프트:

set GOOGLE_APPLICATION_CREDENTIALS=[PATH]

Cloud SDK 설치 및 초기화

Dialogflow API를 사용하려는 경우 Cloud SDK를 설치하고 초기화해야 합니다. Cloud SDK는 Google Cloud에서 호스팅되는 리소스 및 애플리케이션을 관리하기 위해 사용할 수 있는 도구 집합입니다. 여기에는 gcloud 명령줄 도구가 포함됩니다.

다음 링크에서 안내를 제공합니다.

Cloud SDK 설치 및 초기화

SDK 및 인증 테스트

이전 단계에서 인증을 설정한 경우 'gcloud' 도구를 사용하여 인증 환경을 테스트할 수 있습니다. 다음 명령어를 실행하여 오류가 발생하지 않고 사용자 인증 정보가 반환되는지 확인합니다.

gcloud auth application-default print-access-token

이 명령어는 모든 Dialogflow 명령줄 REST 샘플에서 API 호출을 인증하는 데 사용됩니다.

Dialogflow 클라이언트 라이브러리 설치