組織層級配置 Gemini Code Assist

課程概述

自己一個人開發時，啟用 Gemini Code Assist 點幾下就好。但要在整個組織推動 AI 輔助開發就不一樣了，得一併考慮權限控管、使用政策、成本追蹤和程式碼自訂化。這門課會從管理員的角度，帶你在組織層級（Organization Level）把 Gemini Code Assist 部署起來、管好，讓團隊用得安全又有效率。

你將學到

• 在組織層級啟用 Gemini for Google Cloud 服務
• 透過 IAM 角色精細控管哪些團隊成員可以使用 Gemini
• 設定組織政策（Organization Policy）限制 Gemini 的使用範圍
• 啟用 Code Customization 功能讓 Gemini 學習內部程式碼庫
• 追蹤與分析組織內的 Gemini 使用量與成本

核心概念

組織層級啟用流程

在組織中啟用 Gemini Code Assist 需要以下步驟：

1. 啟用 Cloud AI Companion API — 這是 Gemini for Google Cloud 的底層 API，需在專案層級或組織層級啟用
2. 指派 IAM 角色 — 將 roles/cloudaicompanion.user 角色授予目標使用者或群組
3. 設定組織政策 — 透過 Organization Policy 控制 Gemini 功能的可用範圍
4. 驗證授權 — 確認使用者在 IDE 中能成功連線到 Gemini 服務

IAM 角色與權限

IAM 角色	權限範圍	適用對象
roles/cloudaicompanion.user	使用 Gemini 全部功能	一般開發者
roles/cloudaicompanion.codeRepositoryIndexesViewer	檢視 Code Customization 的程式碼索引設定	審核人員
roles/cloudaicompanion.admin	管理 Gemini 設定與政策	IT 管理員

建議建立 Google Groups 群組，把角色授給群組而不是個人。這樣之後有人來人去，權限管理會省事很多。

Code Customization（程式碼自訂化）

Code Customization 是 Gemini Code Assist 的進階企業功能，能讓 Gemini 參考組織的私有程式碼庫，給出更貼近實際狀況的建議。運作方式是這樣：

• 管理員透過 Developer Connect 指定內部程式碼儲存庫（支援 GitHub、GitLab、Bitbucket，包含地端 GitHub Enterprise / GitLab Enterprise / Bitbucket Data Center 版本）
• Gemini 會建立程式碼索引，但不會將程式碼用於模型訓練
• 開發者在 IDE 中使用時，Gemini 會同時參考公開知識與內部程式碼庫
• 適用場景：公司有大量自訂框架、內部 SDK 或特殊命名慣例

使用政策與資料治理

企業導入 Gemini 時，最常擔心的就是資料安全。針對這些疑慮，Google Cloud 提供的保障包括：

• 資料不用於訓練 — 使用者的 prompt 與程式碼不會被用來訓練 Google 的基礎模型
• 資料區域性 — Gemini 的請求透過 Google Cloud 區域端點處理，遵循資料在地化要求
• 稽核日誌 — 所有 Gemini 互動都會記錄在 Cloud Audit Logs 中，方便合規審計
• IP 保護 — Google 提供智慧財產權賠償保障（IP indemnification）

實作重點

• 使用 gcloud services enable cloudaicompanion.googleapis.com 在專案層級啟用 API
• 組織層級權限授予：gcloud organizations add-iam-policy-binding ORG_ID --member='group:developers@company.com' --role='roles/cloudaicompanion.user'
• 在 Cloud Console 的「Gemini for Google Cloud」設定頁面可直接管理 Code Customization 連接器
• 常見錯誤：啟用 API 後忘記授予 IAM 角色，開發者在 IDE 中會看到「Permission Denied」提示
• 成本追蹤可透過 Billing Reports 篩選 Cloud AI Companion API 的使用量

Skill Badge 指引

Lab 連結：Gemini for Google Cloud: Code Assist for Organizations — Google Cloud Skills Boost

延伸學習

• Gemini Code Assist 快速上手 — 從個人開發者角度認識 Code Assist 核心功能
• Gemini 輔助資安工程師 — 了解 Gemini 在安全領域的組織層級應用
• GCP PCA 課程：合規與稽核 — 進一步認識 Google Cloud 的合規框架與稽核機制