경우에 따라 Dialogflow를 사용하기 위해 Google Cloud 프로젝트를 여러 개 만들어야 할 수도 있습니다.
- 인증, 할당량, 결제용 프로젝트 하나를 만들고 에이전트 데이터용 프로젝트를 추가로 만드는 것이 유용할 수 있습니다.
- 각 프로젝트에는 리전별로 최대 1개의 에이전트가 있을 수 있습니다. 동일한 리전에 여러 에이전트가 필요한 경우 프로젝트가 여러 개 필요합니다.
소비자 및 리소스 프로젝트
API를 호출할 때 일반적으로 인증을 위한 서비스 계정 키를 제공합니다. 각 서비스 계정은 특정 프로젝트에 의해 소유되지만 서비스 계정에는 다른 프로젝트를 위한 리소스에 액세스하는 역할이 제공될 수 있습니다. API 호출에 제공하는 서비스 계정과 연결된 프로젝트를 소비자 프로젝트라고 합니다.
API를 호출할 때 요청은 에이전트의 프로젝트를 지정합니다. 이 프로젝트를 리소스 프로젝트라고 합니다.
예를 들어 다음 REST curl 요청에서 AGENT_ID
와 연결된 프로젝트는 리소스 프로젝트이고 TOKEN
을 생성하는 데 사용된 서비스 계정과 연결된 프로젝트입니다. 소비자 프로젝트입니다.
curl -X GET -H "Authorization: Bearer TOKEN" "https://dialogflow.googleapis.com/v2/projects/PROJECT_ID/agent/AGENT_ID"
하나의 프로젝트가 소비자 프로젝트와 리소스 프로젝트 역할을 모두 수행할 수 있습니다. 에이전트 데이터, 요금, 할당량은 이 프로젝트와만 연결됩니다.
소비자 프로젝트와 리소스 프로젝트가 서로 다른 두 프로젝트이면 요금, 할당량 제약조건, 에이전트 정보, API 사용 설정 요구사항이 둘 중 하나 또는 둘 모두에 적용됩니다. 다음 표에서는 API 호출과 두 프로젝트의 연결을 보여줍니다.
설명 | 소비자 프로젝트(서비스 계정 프로젝트) | 리소스 프로젝트(에이전트 프로젝트) | 참고 |
---|---|---|---|
요금이 발생하는 프로젝트 | ✔ | ||
할당량에 제한되는 프로젝트 | ✔ | ||
평가판 또는 Essentials Dialogflow 버전을 결정하는 에이전트가 포함된 프로젝트 | ✔ | 소비자 프로젝트에 에이전트가 없으면 빈 에이전트를 만들어 Essentials 버전으로 업그레이드합니다. | |
모든 에이전트 데이터 및 Trial 또는 Essentials Dialogflow 버전이 포함된 프로젝트 | ✔ | ||
Dialogflow API를 사용 설정해야 하는 프로젝트 | ✔ | ✔ | 두 프로젝트 유형 모두에 Dialogflow API를 사용 설정해야 합니다. |
Cloud 콘솔 API 대시보드에서 API 사용량을 표시하는 프로젝트 | ✔ |