개발자용 Duet AI는 2024년 5월 11일까지 무료로 사용해 볼 수 있으며 결제 계정당 사용자 수는 1명으로 제한됩니다. 조직은 여기에서 라이선스를 구매할 수 있습니다.

프로젝트에 개발자용 Duet AI 설정

지원되는 Google Cloud 제품에서 개발자용 Duet AI를 사용하려면 먼저 팀에서 이 문서에 설명된 단계를 수행해야 합니다.

하나 이상의 Duet AI 제품 구독을 구매합니다.
Google Cloud 프로젝트에서 Duet AI를 활성화합니다. 이 단계는 일반적으로 관리자가 수행합니다.
IDE에서 Duet AI를 사용하려면 Cloud Code 플러그인을 설치합니다.

Duet AI 구독 구매

BigQuery, Spanner 또는 Colab Enterprise용 Duet AI만 사용하는 경우 이 섹션을 건너뛸 수 있습니다.

개발자용 Duet AI는 2024년 5월 11일까지 무료로 사용해 볼 수 있으며 결제 계정당 사용자 수는 1명으로 제한됩니다. 결제 계정당 여러 사용자가 있는 조직은 이 섹션에 설명된 대로 구독을 구매해야 합니다. Google Cloud와 기존 계약이 있는 경우 구독을 구매하기 전에 영업팀에 문의하세요.

Google Cloud 콘솔에서 Duet AI 관리자 페이지로 이동합니다.

Duet AI 관리자로 이동
시작하기 전에 메시지를 검토하고 확인합니다.
이 결제 계정에 대한 기존 구독이 없는 경우 프로모션 페이지가 표시됩니다. Duet AI 시작하기를 클릭합니다.
메시지가 표시되면 결제 계정을 선택하고 Duet AI 관리자 페이지 계속을 클릭합니다.
구독 페이지에서 새 구독 구매를 클릭합니다.
선택적 구독 이름, 약정 기간(월간 또는 연간), 구독 라이선스 수 등의 필드를 작성하여 구독을 구성합니다.

참고: 연간 구독은 일회성 결제가 아니며 매달 할인된 연간 가격을 청구합니다.

약정 기간(월간 또는 연간) 이후 구독을 자동 갱신할지 여부를 선택합니다. 이렇게 하면 구독 및 라이선스가 활성 상태로 유지됩니다. 구독이 자동 갱신되지 않는 경우 현재 기간이 끝나면 구독이 종료되며, 라이선스를 다시 획득하려면 구매 프로세스를 다시 진행해야 합니다.
계속을 클릭하여 구독 세부정보를 검토합니다. 구매 약관을 검토하고 동의합니다.
구매 완료를 클릭한 후 구독을 확인합니다.

이제 Duet AI에 결제가 사용 설정되었습니다. 그런 다음 이 결제 계정과 연결된 하나 이상의 프로젝트에서 Duet AI를 활성화합니다. 하나 이상의 프로젝트에서 활성화하기 전까지는 사용자에게 Duet AI가 표시되지 않습니다.

Google Cloud 프로젝트에서 Duet AI 활성화

Google Cloud 프로젝트에서 Duet AI를 활성화하려면 관리자가 Cloud AI Companion API를 사용 설정하고 Cloud AI 컴패니언 사용자 및 서비스 사용량 뷰어 Identity and Access Management(IAM) 역할을 사용자에게 부여해야 합니다.

콘솔

API를 사용 설정하려면 Google Cloud 콘솔에서 Cloud AI Companion API 페이지로 이동합니다.

Cloud AI Companion API로 이동
프로젝트 선택기에서 프로젝트를 선택합니다.
사용 설정을 클릭합니다.

페이지가 업데이트되고 사용 설정됨 상태가 표시됩니다. 이제 선택한 Google Cloud 프로젝트에서 필요한 IAM 역할을 가진 모든 사용자가 Duet AI를 사용할 수 있습니다.
Duet AI를 사용하는 데 필요한 IAM 역할을 부여하려면 IAM 페이지로 이동합니다.

IAM으로 이동
주 구성원 열에서 Duet AI에 대한 액세스를 사용 설정하려는 주 구성원 열을 찾은 후 해당 행에서 주 구성원 수정을 클릭합니다.
액세스 수정 창에서 다른 역할 추가를 클릭합니다.
역할 선택에서 Cloud AI 컴패니언 사용자를 선택합니다.
다른 역할 추가를 클릭하고 서비스 사용량 뷰어를 선택합니다.
저장을 클릭합니다.

gcloud

Google Cloud 콘솔에서 Cloud Shell을 활성화합니다.

Cloud Shell 활성화
프로젝트 선택기 드롭다운 목록에서 프로젝트를 선택합니다.
gcloud services enable 명령어를 사용하여 Duet AI용 Cloud AI Companion API를 사용 설정합니다.
```
gcloud services enable cloudaicompanion.googleapis.com
```
다른 Google Cloud 프로젝트에 Cloud AI Companion API를 사용 설정하려면 --project 매개변수를 추가합니다.
```
gcloud services enable cloudaicompanion.googleapis.com --project PROJECT_ID
```
PROJECT_ID를 Google Cloud 프로젝트 ID로 바꿉니다.

출력은 다음과 비슷합니다.
```
Waiting for async operation operations/acf.2e2fcfce-8327-4984-9040-a67777082687 to complete...
Operation finished successfully.
```
이제 지정한 Google Cloud 프로젝트에서 필요한 IAM 역할을 가진 모든 사용자가 Duet AI를 사용할 수 있습니다.
Duet AI를 사용하는 데 필요한 두 가지 IAM 역할을 부여합니다.
1. Cloud AI 컴패니언 사용자 역할을 부여합니다.
```
gcloud projects add-iam-policy-binding  PROJECT_ID \
--member=PRINCIPAL --role=roles/cloudaicompanion.user
```
  PRINCIPAL을 주 구성원 식별자로 바꿉니다. 식별자는 user|group|serviceAccount:email 또는domain:domain 형식을 취합니다(예:user:cloudysanfrancisco@gmail.com, group:admins@example.com, serviceAccount:test123@example.domain.com 또는 domain:example.domain.com).
  
  다음을 포함하는 정책 바인딩 목록이 출력됩니다.
```
- members:
  - user:PRINCIPAL
  role: roles/cloudaicompanion.user
```
2. 서비스 사용량 뷰어 역할을 부여합니다.
```
gcloud projects add-iam-policy-binding  PROJECT_ID \
--member=PRINCIPAL --role=roles/serviceusage.serviceUsageViewer
```
  다음을 포함하는 정책 바인딩 목록이 출력됩니다.
```
- members:
  - user:PRINCIPAL
  role: roles/serviceusage.serviceUsageViewer
```
자세한 내용은 단일 역할 부여 및 gcloud projects add-iam-policy-binding을 참조하세요.

이러한 역할이 부여된 모든 사용자가 지정된 프로젝트 내에서 Google Cloud 콘솔의 Duet AI 기능에 액세스할 수 있습니다. 자세한 내용은 Google Cloud의 Duet AI 개요를 참조하세요.

IDE에서 Duet AI 사용

IDE에서 Duet AI를 사용하려는 개발자라면 Cloud Code 플러그인을 설치해야 합니다. 자세한 내용은 다음을 참조하세요.

Cloud Workstations: Duet AI 지원 코드
Cloud Shell 편집기: Duet AI 지원 코드
VS Code용 Cloud Code: Duet AI 지원 코드
IntelliJ 및 기타 JetBrains IDE용 Cloud Code: Duet AI 지원 코드

고급 설정 태스크

Google Cloud 콘솔 또는 gcloud CLI를 사용하여 사전 정의된 IAM 역할을 부여하는 대신 다음 중 하나를 수행할 수 있습니다.

IAM REST API 또는 IAM 클라이언트 라이브러리를 사용하여 역할을 부여합니다.

이러한 인터페이스를 사용하는 경우 정규화된 역할 이름을 사용하세요.
- roles/cloudaicompanion.user
- roles/serviceusage.serviceUsageViewer
역할 부여에 대한 상세 설명은 프로젝트, 폴더, 조직에 대한 액세스 관리를 참조하세요.
커스텀 역할을 만들고 부여합니다.

자신이 만든 모든 커스텀 역할에서 Duet AI에 액세스하려면 다음 권한이 필요합니다.
- cloudaicompanion.companions.generateChat
- cloudaicompanion.companions.generateCode
- serviceusage.services.get