取得 Google Cloud API 金鑰

如要在 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 金鑰

如要查看及管理 API 金鑰,請前往 Agent Studio 的「API Keys」(API 金鑰) 頁面:

前往「API Keys」(API 金鑰) 頁面

提出第一個 API 要求

取得 API 金鑰後,請參閱 API 快速入門導覽課程,瞭解如何使用 API 金鑰提出第一個要求。

選用:在本機設定 API 金鑰

在初始測試階段,您可以硬式編碼 API 金鑰,但這不安全,因此只能做為暫時做法。本節其餘部分將說明如何在不同作業系統中,將 API 金鑰設為本機環境變數。

按一下即可展開操作說明

Linux/macOS

  1. 執行下列指令,查看您使用的指令列殼層:

    echo $SHELL

    輸出結果會與下列內容相似:

    /bin/bash
  2. 請採取下列任一做法,為 API 金鑰新增殼層匯出變數:

    • 如果上一個步驟的輸出內容是 /bin/bash:

      1. 開啟 .bashrc:

        touch ~/.bashrc
                open ~/.bashrc
      2. 在 .bashrc 中新增這一行程式碼:

        export GOOGLE_API_KEY=YOUR_API_KEY
      3. 儲存檔案,然後執行下列指令來套用變更:

        source ~/.bashrc
    • 如果上一個步驟的輸出內容是 /bin/zsh:

      1. 開啟 .zshrc:

        touch ~/.zshrc
                open ~/.zshrc
      2. 在 .zshrc 中新增這一行程式碼:

        export GOOGLE_API_KEY=YOUR_API_KEY
      3. 儲存檔案,然後執行下列指令來套用變更:

        source ~/.zshrc

Windows

  1. 在系統設定中搜尋「環境變數」
  2. 編輯「使用者變數」(適用於目前使用者) 或「系統變數」(適用於所有使用者,請謹慎使用)。
  3. 建立變數並新增 export GOOGLE_API_KEY=YOUR_API_KEY
  4. 套用變更