運用 Gemini 快速設計出原型

Google 的生成式語言 API 可讓您使用 Gemini 模型，打造無縫的原型。您可以使用這個工具測試及探索 Gemini 模型的功能，無須設定複雜的基礎架構或管理模型部署作業。Google 的瀏覽器原型設計工具 Google AI Studio 使用生成式語言 API，可透過生成式模型進行瀏覽器原型設計。

有了 ABAP 適用的 Vertex AI SDK，您就能直接在 ABAP 環境中使用生成式語言 API (Gemini API) 開始原型設計歷程。您必須使用 Google AI Studio 產生的 API 金鑰，才能存取 Gemini 模型。您只需產生這個 API 金鑰一次。

產生 API 金鑰

您透過 Google AI Studio 產生的 API 金鑰，可提供方便的方式驗證 Gemini API。

如要產生 API 金鑰，請執行下列步驟：

  1. 在 Google AI Studio 中開啟「API 金鑰」頁面。

    取得 API 金鑰

  2. 按一下「建立 API 金鑰」。

  3. 如果有填入，請詳閱並確認法律聲明，然後按一下「繼續」。

  4. 如果已填入，請詳閱並確認安全設定提醒。

  5. 在「Create API key」對話方塊中，視情況選取下列其中一個選項：

    • 在新專案中建立 API 金鑰
    • 在現有專案中建立 API 金鑰

  6. 複製金鑰字串並妥善保存。您需要這個 API 金鑰，才能設定 Gemini API 的驗證機制。

  7. 複製產生 API 金鑰的 Google Cloud 專案編號。在後續步驟中會用到這項資訊。

設定驗證方法

如要使用 API 金鑰驗證 Gemini API，請使用下列任一方法：

使用儲存在 SAP SSF 中的 API 金鑰進行驗證

為確保 API 金鑰的安全性，您可以將產生的 API 金鑰儲存在 SAP SSF 中，並使用 SSF 驗證類別設定用戶端金鑰。您可以使用這個用戶端金鑰存取 Gemini API。如需詳細資訊，請參閱：

透過自訂驗證類別使用 API 金鑰進行驗證

或者，您也可以建立自訂驗證類別，以便保留 API 金鑰，並使用自訂驗證類別設定用戶端金鑰。

  1. 在 SAP 系統中，透過實作 Google Cloud ABAP SDK 隨附的介面 /GOOG/IF_AUTH，建立 Z 類別：

    1. 在 SAP GUI 中執行交易代碼 SE24。
    2. 在「Object type」欄位中輸入名稱 (例如 Z_TEST_GEMINI_API)，然後按一下「Create」。
    3. 確認「物件類型」為「Class」，然後按一下「OK」。
    4. 在「Description」欄位中提供類別的說明，例如 Class for authentication to Google AI Studio，然後將類別儲存為「Local Object」或「Transport Request」。
    5. 開啟「介面」分頁，新增介面 /GOOG/IF_AUTH，然後按下 Enter 鍵。
    6. 開啟「方法」分頁。介面 /GOOG/IF_AUTH 的方法會自動實作至 Z 類別。
    7. 按兩下方法 /GOOG/IF_AUTH~GET_ACCESS_TOKEN。

    8. 在 /GOOG/IF_AUTH~GET_ACCESS_TOKEN 方法中加入下列程式碼：

      ev_auth_type = /goog/if_auth=>c_auth_type_apik_ssf.
cv_token = 'API_KEY'.
GET TIME STAMP FIELD ev_logtime.

      將 API_KEY 替換為您在 Google AI Studio 中產生的 API 金鑰。

    9. 啟用 Z 類別。

  2. 在 SAP 系統中建立用戶端金鑰設定：

    1. 在 SAP GUI 中執行交易代碼 /GOOG/SDK_IMG。

      或者，您也可以執行交易代碼 SPRO，然後按一下「SAP Reference IMG」。

    2. 依序點選「ABAP SDK for Google Cloud」>「基本設定」>「設定用戶端金鑰」。

    3. 按一下「新增項目」。

    4. 在下列欄位中輸入值：

      欄位 說明
      Google Cloud 金鑰名稱 指定用戶端金鑰設定的名稱，例如 TEST_GEMINI_API。
      Google Cloud 服務帳戶名稱 請將這個欄位留空。
      Google Cloud 範圍 請將這個欄位留空。
      Google Cloud 專案 ID 指定 API 金鑰儲存位置的 Google Cloud 專案編號。
      指令名稱 請將這個欄位留空。
      授權類別 指定您在上一個步驟中建立的 Z 類別，例如 Z_TEST_GEMINI_API。
      權杖快取

      請將這個欄位留空。
      權杖重新整理秒數 請將這個欄位留空。
      授權參數 1 請將這個欄位留空。
      授權參數 2 請將這個欄位留空。

    5. 儲存新項目。

  3. 請記下用戶端金鑰。您可以使用這組用戶端金鑰進行驗證。

執行程式碼範例

您可以使用 ABAP 適用的 Vertex AI SDK 隨附的 AI Studio 示範，探索 Gemini API 功能。

如要執行 AI Studio 示範，請執行下列步驟：

  1. 在 SAP GUI 中執行交易代碼 /GOOG/SDK_IMG。

    或者，您也可以執行交易代碼 SPRO，然後按一下「SAP Reference IMG」。

  2. 前往「ABAP SDK for Google Cloud > 範例」。

  3. 開啟 Vertex AI SDK：示範：使用生成式語言 API 製作原型。

  4. 在「Client key」欄位中，輸入您在「Set up authentication」專區中建立的用戶端金鑰。

  5. 在「Model ID」欄位中，輸入要使用的 LLM 模型 ID，例如 gemini-1.5-flash。如要瞭解可用的模型，請參閱「模型變化版本」。

  6. 視需要提供下列產生參數：

    • 輸出詞元數量上限
    • 回應 MIME 類型
    • 溫度
    • TopK
    • TopP

    如要瞭解這些模型產生參數，請參閱「嘗試使用參數值」。

  7. 在「輸入系統指示」欄位中提供系統指示。

  8. 在「Enter prompt」欄位中輸入提示。

  9. 執行程式。「Response from LLM」區域會顯示系統產生的輸出內容。

使用 ABAP 製作 AI 用途的原型

您可以使用 SDK 隨附的 /GOOG/CL_GENERATIVELANGUAGE_V1 和 /GOOG/CL_GENERATIVELANG_V1BETA 類別，建構 SAP 應用程式原型。您可以使用在「設定驗證方法」一節中建立的用戶端金鑰，從 ABAP 環境叫用這些類別。

後續步驟