이 가이드에서는 Dialogflow를 사용하기 위한 모든 필수 설정 단계를 설명합니다. 또한 Dialogflow를 시도하거나 테스트한 후 가능한 삭제 단계에 대한 안내를 제공합니다.
시작하기 전에
이 가이드를 읽기 전에 다음을 수행해야 합니다.
- Dialogflow ES 기본사항 읽기
- 버전 읽기
Google Cloud 콘솔 정보
Google Cloud 콘솔(문서 보기, 콘솔 열기)은 Google Cloud 제품을 사용하는 시스템을 프로비저닝, 구성, 관리, 모니터링하는 데 사용되는 웹 UI입니다. Google Cloud 콘솔을 사용하여 Dialogflow 리소스를 설정 및 관리합니다.
프로젝트 만들기
Google Cloud에서 제공하는 서비스를 사용하려면 프로젝트를 만들어야 합니다. 프로젝트는 모든 Google Cloud 리소스를 구성합니다. 프로젝트는 공동작업자, 사용 설정된 API(및 기타 리소스), 모니터링 도구, 결제 정보, 인증, 액세스 제어로 구성됩니다. 프로젝트를 하나 또는 여러 개 만들 수 있으며 이를 사용하여 Google Cloud 리소스를 리소스 계층 구조로 구성할 수도 있습니다. 프로젝트를 만들 때 프로젝트 ID를 기록해 둡니다. API 호출에 이 ID가 필요합니다. 프로젝트에 대한 자세한 내용은 Resource Manager 문서를 참조하세요.
Dialogflow ES 콘솔(문서 보기, 콘솔 열기)은 에이전트를 만들 때 선택적으로 기본 프로젝트를 만들 수 있습니다. 프로젝트를 무료 버전에 대한 기본적인 액세스 이상의 용도로 사용하거나 API를 사용하려는 경우 아래 설명에 따라 Google Cloud Console로 프로젝트를 만들어야 합니다.
실험, 테스트, 프로덕션을 위해 각기 별도의 프로젝트를 만드는 것이 좋습니다. 각 프로젝트는 하나의 Dialogflow 에이전트만 만들 수 있습니다. 여러 에이전트가 필요하면 프로젝트를 여러 개 만들어야 합니다.
In the Google Cloud console, on the project selector page, select or create a Google Cloud project.
결제 사용 설정
결제 계정은 정해진 리소스 집합의 비용을 누가 지불하는지 정의하는 데 사용되며 하나 이상의 프로젝트에 연결할 수 있습니다. 프로젝트 사용량이 연결된 결제 계정으로 청구됩니다. 대부분의 경우 프로젝트를 만들 때 결제를 구성합니다. 자세한 내용은 결제 문서를 참조하세요.
Google Cloud 프로젝트에 결제가 사용 설정되어 있는지 확인합니다.
API 사용 설정
프로젝트에 Dialogflow API를 사용 설정해야 합니다. API 사용 설정에 대한 자세한 내용은 서비스 사용 문서를 참조하세요.
Enable the Dialogflow API.
감사 로그 사용 설정
프로젝트에서 Dialogflow API에 대한 데이터 액세스 감사 로그를 사용 설정합니다. 이를 통해 이 프로젝트에 연결된 Dialogflow 에이전트의 설계 시간 변경사항을 추적할 수 있습니다.
Google Cloud CLI를 설치하고 초기화합니다.
Dialogflow API를 사용하려면 Google Cloud CLI를 설치하고 초기화해야 합니다. gcloud CLI는 Google Cloud에서 호스팅되는 리소스와 애플리케이션을 관리하는 데 사용할 수 있는 도구 집합입니다.
다음 링크에서 안내를 제공합니다.
Install the Google Cloud CLI, then initialize it by running the following command:
gcloud init
인증 및 액세스 제어 설정
Dialogflow API를 사용하려면 인증을 설정해야 합니다. API를 사용하는 모든 클라이언트 애플리케이션은 인증되어야 하며 요청된 리소스에 대한 액세스 권한을 받아야 합니다. 이 섹션에서는 중요한 인증 개념을 설명하고 설정 단계를 안내합니다. 자세한 내용은 Google Cloud 인증 개요를 참조하세요.
사용자 계정을 사용한 인증
사용자 계정은 Dialogflow API를 학습할 때 그리고 로컬 개발을 위한 최고의 인증 옵션입니다. 사용자 계정을 사용하여 REST 명령줄 실행 또는 클라이언트 라이브러리 호출에 대해 인증을 수행할 수 있습니다.
REST 명령줄 사용자 계정 인증
REST 명령줄 호출에 대해 인증을 수행하려면 gcloud CLI를 사용합니다.
gcloud auth login 명령어는 사용자 계정을 사용하여 gcloud에 사용자 로그인을 수행합니다. 이 작업은 API 호출 전에 수행되어야 합니다.
gcloud auth print-access-token 명령어는 이 문서에서 REST 명령줄 샘플을 통해 REST 호출 인증을 위해 사용됩니다.
로컬 환경에 대해 사용자 인증 정보를 만들려면 다음 안내를 따르세요.
gcloud auth login
클라이언트 라이브러리 사용자 계정 인증
클라이언트 라이브러리 호출에 대해 인증을 수행하려면 gcloud CLI를 사용합니다.
gcloud auth application-default login 명령어는 사용자 계정을 사용하여 애플리케이션 기본 사용자 인증 정보에 대해 gcloud에 사용자 로그인을 수행합니다. 이 작업은 API 호출 전에 수행되어야 합니다.
API 호출 관련 결제 및 할당량에 대해 프로젝트를 설정하려면 gcloud auth application-default set-quota-project 명령어를 사용해야 합니다.
일반적으로 이것은 에이전트에 사용되는 동일한 프로젝트이며, 위 단계에서 만든 프로젝트에 대해 프로젝트 ID를 제공합니다.
애플리케이션 기본 사용자 인증 정보를 클라이언트 라이브러리에 사용하려면 GOOGLE_APPLICATION_CREDENTIALS 환경 변수를 설정하지 않아야 합니다.
로컬 환경에 대해 애플리케이션 기본 사용자 인증 정보를 만들려면 다음 안내를 따르세요.
gcloud auth application-default login gcloud auth application-default set-quota-project PROJECT_ID
서비스 계정을 사용하여 인증
서비스 계정은 프로덕션 또는 스테이징과 같은 보안 환경에서만 사용해야 하는 또 다른 인증 옵션입니다. 서비스 계정은 최종 사용자가 아닌 애플리케이션의 사용자 인증 정보를 제공합니다. 서비스 계정은 프로젝트에서 소유하며 하나의 프로젝트에 여러 개의 서비스 계정을 만들 수 있습니다. 자세한 내용은 다음을 참고하세요.
역할을 사용하여 액세스 제어
주 구성원(사용자 계정, 서비스 계정 등)이 API를 호출할 때 Google Cloud는 주 구성원에게 적절한 권한을 요구합니다. 주 구성원에 역할을 부여하여 권한을 부여할 수 있습니다. 자세한 내용은 역할 개요를 참조하세요.
사용자 계정을 사용하여 프로젝트를 만든 경우 사용자 계정에 프로젝트에 대한 소유자 기본 역할이 포함됩니다. 이 역할은 프로젝트의 모든 API를 호출할 액세스 권한을 제공합니다. 하지만 다른 계정이 프로젝트를 만든 경우 API를 호출하려면 사용자 계정에 역할을 부여해야 할 수 있습니다. 자세한 내용은 Dialogflow 액세스 제어 가이드를 참조하세요.
Dialogflow 클라이언트 라이브러리 설치
API 호출에는 Google 지원 클라이언트 라이브러리, REST, gRPC의 세 가지 옵션이 있습니다.
클라이언트 라이브러리는 많이 사용되는 여러 언어로 제공됩니다. 설치 안내는 클라이언트 라이브러리에서 원하는 언어를 참조하세요.
삭제
Dialogflow 설정 및 시험 사용 또는 테스트 후 생성한 리소스를 삭제해야 할 수 있습니다.
- 에이전트를 삭제합니다.
- 프로젝트를 종료합니다.
-
gcloud auth login을 호출한 경우 컴퓨터의 사용자 디렉터리에 사용자 인증 정보가 저장됩니다. 다음을 호출하여 이러한 사용자 인증 정보를 삭제해야 할 수 있습니다.gcloud auth revoke
-
gcloud auth application-default login을 호출한 경우 컴퓨터의 사용자 디렉터리에 사용자 인증 정보가 저장됩니다. 다음을 호출하여 이러한 사용자 인증 정보를 삭제해야 할 수 있습니다.gcloud auth application-default revoke