如要在 Gemini Enterprise Agent Platform 使用 Gemini,請透過 Google Cloud API 金鑰或應用程式預設憑證進行驗證。測試時使用 API 金鑰,正式環境則使用應用程式預設憑證。
本頁面說明如何根據您是 Google Cloud 的新使用者或現有使用者,取得 Google Cloud API 金鑰。
選取使用者類型:
建立快捷模式 API 金鑰
如要快速取得 API 金鑰,最快的方法是透過Google Cloud 控制台中的快捷模式帳戶。這項簡化體驗旨在快速完成新手上路流程,無論您是Google Cloud 新手,還是 Google Cloud 現有使用者,系統都會自動為您建立 API 金鑰:
- 如果您是第一次使用 Google Cloud,系統會引導您快速完成免付費設定,並提供 90 天的免費試用環境。
- 如果您是 Google Cloud 使用者,可以連結現有的帳單帳戶,在 Gemini Enterprise Agent Platform 的快捷模式下,透過簡化流程立即取得 API 金鑰。
如要進一步瞭解 Agent Platform 的快捷模式,請參閱快捷模式總覽頁面。在快捷模式下傳送的要求會指定無專案端點,且不會在 Cloud Logging 中產生客戶可存取的資料存取 (DATA_READ) 稽核記錄。
使用快捷模式取得 API 金鑰:
如要查看及管理 API 金鑰,請前往 Agent Studio 的「API Keys」(API 金鑰) 頁面:
提出第一個 API 要求
取得 API 金鑰後,請參閱 API 快速入門導覽課程,瞭解如何使用 API 金鑰提出第一個要求。
選用:在本機設定 API 金鑰
在初始測試階段,您可以硬式編碼 API 金鑰,但這不安全,因此只能做為暫時做法。本節其餘部分將說明如何在不同作業系統中,將 API 金鑰設為本機環境變數。
按一下即可展開操作說明
Linux/macOS
-
執行下列指令,查看您使用的指令列殼層:
echo $SHELL
輸出結果會與下列內容相似:
/bin/bash
-
請採取下列任一做法,為 API 金鑰新增殼層匯出變數:
-
如果上一個步驟的輸出內容是
/bin/bash:-
開啟
.bashrc:touch ~/.bashrc open ~/.bashrc -
在
.bashrc中新增這一行程式碼:export GOOGLE_API_KEY=YOUR_API_KEY
-
儲存檔案,然後執行下列指令來套用變更:
source ~/.bashrc
-
-
如果上一個步驟的輸出內容是
/bin/zsh:-
開啟
.zshrc:touch ~/.zshrc open ~/.zshrc -
在
.zshrc中新增這一行程式碼:export GOOGLE_API_KEY=YOUR_API_KEY
-
儲存檔案,然後執行下列指令來套用變更:
source ~/.zshrc
-
-
Windows
- 在系統設定中搜尋「環境變數」
- 編輯「使用者變數」(適用於目前使用者) 或「系統變數」(適用於所有使用者,請謹慎使用)。
- 建立變數並新增
export GOOGLE_API_KEY=YOUR_API_KEY - 套用變更