빠른 시작: 설정

이 가이드에서는 Dialogflow를 사용하기 위한 모든 필수 설정 단계를 설명합니다.

시작하기 전에

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

  1. Dialogflow 기본사항 읽기
  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 문서를 참조하세요.

Dialogflow 콘솔(문서 보기, 콘솔 열기)은 에이전트를 만들 때 선택적으로 기본 프로젝트를 만들 수 있습니다. 프로젝트를 무료 버전에 대한 기본적인 액세스 이상의 용도로 사용하거나 API를 사용하려는 경우 아래 설명에 따라 Google Cloud Console로 프로젝트를 만들어야 합니다.

실험, 테스트, 프로덕션을 위해 각기 별도의 프로젝트를 만드는 것이 좋습니다. 각 프로젝트는 하나의 Dialogflow 에이전트만 만들 수 있습니다. 여러 에이전트가 필요하면 프로젝트를 여러 개 만들어야 합니다.

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

프로젝트 선택기 페이지로 이동

결제 사용 설정

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

Google 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. 서비스 계정 이름 필드에 이름을 입력합니다.
  4. 역할 목록에서 프로젝트 > 소유자를 선택합니다.

    참고: 역할 필드가 리소스에 액세스할 수 있도록 서비스 계정을 승인합니다. 나중에 Cloud Console을 사용하여 이 필드를 보고 변경할 수 있습니다. 프로덕션 애플리케이션을 개발하는 경우 프로젝트 > 소유자보다 세부적인 권한을 지정합니다. 자세한 내용은 서비스 계정에 역할 부여를 참조하세요.
  5. 만들기를 클릭합니다. 키가 포함된 JSON 파일이 컴퓨터에 다운로드됩니다.

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

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 클라이언트 라이브러리 설치

API 호출에는 Google 지원 클라이언트 라이브러리, REST, gRPC의 세 가지 옵션이 있습니다. 클라이언트 라이브러리는 널리 사용되는 여러 언어에서 사용할 수 있으며 권장되는 옵션입니다. 클라이언트 라이브러리를 설치하려면 다음 안내를 따르세요.

C#

NuGetGoogle.Cloud.Dialogflow.V2 패키지를 설치합니다. 일반적인 방법으로 프로젝트에 추가합니다(예를 들어 Visual Studio에서 프로젝트를 마우스 오른쪽 버튼으로 클릭하고 'Manage NuGet Packages...'(NuGet 패키지 관리)를 선택). 출시 전 패키지를 사용 설정해야 합니다(예를 들어 Visual Studio NuGet 사용자 인터페이스에서 'Include prerelease(출시 전 릴리스 포함)' 상자 선택).

또는 NuGet 명령줄 인터페이스를 사용할 수 있습니다.

nuget install Google.Cloud.Dialogflow.V2 -PreRelease

Go

go get cloud.google.com/go/dialogflow/apiv2

자바

Maven을 사용하는 경우 pom.xml 파일에 다음을 추가합니다. BOM에 대한 자세한 내용은 Google Cloud Platform 라이브러리 BOM을 참조하세요.

<dependencyManagement>
  <dependencies>
    <dependency>
      <groupId>com.google.cloud</groupId>
      <artifactId>libraries-bom</artifactId>
      <version>8.0.0</version>
      <type>pom</type>
      <scope>import</scope>
    </dependency>
  </dependencies>
</dependencyManagement>

<dependencies>
  <dependency>
    <groupId>com.google.cloud</groupId>
    <artifactId>google-cloud-dialogflow</artifactId>
  </dependency>

Gradle을 사용하는 경우 종속 항목에 다음을 추가합니다.

compile 'com.google.cloud:google-cloud-dialogflow:2.1.0'

SBT를 사용하는 경우 종속 항목에 다음을 추가합니다.

libraryDependencies += "com.google.cloud" % "google-cloud-dialogflow" % "2.1.0"

IntelliJ 또는 Eclipse를 사용하는 경우 다음 IDE 플러그인을 사용하여 프로젝트에 클라이언트 라이브러리를 추가할 수 있습니다.

이 플러그인은 서비스 계정의 키 관리와 같은 추가 기능을 제공합니다. 자세한 내용은 각 플러그인의 문서를 참조하세요.

Node.js

npm install dialogflow

PHP

  1. PHP Composer에 권장되는 종속 항목 관리자를 설치합니다.
  2. Google Cloud 클라이언트 라이브러리의 Dialogflow 구성요소를 설치합니다.
    composer require google/cloud-dialogflow
  3. 이 구성요소는 HTTP/1.1을 통한 REST와 gRPC를 모두 지원합니다. 스트리밍 방법 등 gRPC의 이점을 활용하려면 gRPC 설치 가이드의 안내를 따르세요.

Python

pip install dialogflow

Ruby

gem install google-cloud-dialogflow