설정 및 삭제

이 가이드에서는 대화형 에이전트(Dialogflow CX) 사용을 시작하는 데 필요한 모든 설정 절차에 대하여 설명합니다. 또한 대화형 에이전트(Dialogflow CX)를 시도하거나 테스트한 후 가능한 삭제 단계에 대한 안내를 제공합니다.

시작하기 전에

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

흐름 기본사항 읽기
버전 읽기

Google Cloud 콘솔 정보

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

프로젝트 만들기

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

In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

Go to project selector

결제 사용 설정

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

Make sure that billing is enabled for your Google Cloud project.

API 사용 설정

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

Enable the Dialogflow API.

Enable the API

Vertex AI Agents 생성 기능을 사용하는 경우 Vertex AI Agent Builder 서비스도 활성화해야 합니다.

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 명령줄 사용자 계정 인증

참고: Cloud Shell을 사용하는 경우 gcloud에 자동으로 로그인되므로 gcloud auth login을 실행할 필요가 없습니다.

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

API 호출에는 Google 지원 클라이언트 라이브러리, REST, gRPC의 세 가지 옵션이 있습니다.

클라이언트 라이브러리는 많이 사용되는 여러 언어로 제공됩니다. 설치 안내는 클라이언트 라이브러리에서 원하는 언어를 참조하세요.

삭제

Dialogflow 설정 및 시험 사용 또는 테스트 후 생성한 리소스를 삭제해야 할 수 있습니다.

에이전트를 삭제합니다.
프로젝트를 종료합니다.
gcloud auth login을 호출한 경우 컴퓨터의 사용자 디렉터리에 사용자 인증 정보가 저장됩니다. 다음을 호출하여 이러한 사용자 인증 정보를 삭제해야 할 수 있습니다.
```
gcloud auth revoke
```
gcloud auth application-default login을 호출한 경우 컴퓨터의 사용자 디렉터리에 사용자 인증 정보가 저장됩니다. 다음을 호출하여 이러한 사용자 인증 정보를 삭제해야 할 수 있습니다.
```
gcloud auth application-default revoke
```

흐름 기본사항

플로우를 사용하여 에이전트 빌드