安裝及設定 ABAP 專用的 Vertex AI SDK

本文說明如何在 Compute Engine、任何雲端虛擬機器、RISE with S/4HANA Cloud Private 版或地端執行個體上，安裝及設定 SAP 主機系統的 Vertex AI SDK for ABAP。

安裝

安裝最新版的 ABAP SDK for Google Cloud (不論是地端或任何雲端版本) 時，系統會為您安裝 Vertex AI SDK for ABAP。如需安裝步驟的相關資訊，請參閱「安裝及設定 ABAP SDK for Google Cloud 的內部部署或任何雲端版本」。

如果您使用的是 1.7 以下版本的 ABAP SDK for Google Cloud (不論是地端或任何雲端版本)，請將 SDK 更新至最新版本，取得 Vertex AI SDK for ABAP。詳情請參閱「更新 ABAP 適用的 Google Cloud SDK」一文。

我們瞭解部分開發人員可能無法存取 Vertex AI 和雲端資源。如要啟用原型設計和實驗功能，並盡量減少設定，請參閱「使用 Gemini 快速設計原型」。

啟用 Vertex AI API

在 Google Cloud 專案中啟用 Vertex AI API。

Vertex AI API

如要瞭解如何啟用 API，請參閱「啟用 API」。 Google Cloud

在 Vertex AI 中啟用合作夥伴模型

如要使用合作夥伴模型，請在 Vertex AI 中啟用所需模型。

適用於 ABAP 的 Vertex AI SDK 支援下列 Anthropic Claude 模型：

如要啟用 Claude 模型，請前往適當的 Model Garden 模型資訊卡，然後按一下「啟用」：

驗證

在 ABAP SDK for Google Cloud 的地端或任何雲端版本中，設定驗證以存取 Google Cloud API 後，Vertex AI SDK for ABAP 會使用相同的驗證方法存取 Vertex AI API。如要瞭解如何在內部部署或任何雲端版本的 ABAP SDK for Google Cloud 中設定驗證，請參閱驗證總覽。

記下您在驗證設定中建立的用戶端金鑰。設定 AI 模型生成參數和搜尋參數時，您會使用這個用戶端金鑰。

IAM 權限

確認您在用戶端金鑰表格中設定的 API 存取專屬服務帳戶，有權存取 Vertex AI 資源。

Vertex AI

如要使用 Vertex AI 資源，您必須將Vertex AI 使用者 (roles/aiplatform.user) 角色授予專屬服務帳戶，並授予該帳戶存取 Vertex AI API 的權限。

如要提供建立、修改及部署構件的特定權限，請視需要授予特定 Vertex AI IAM 權限。

Vertex AI 特徵儲存庫

如要使用 Vertex AI 特徵儲存庫，必須將下列角色授予服務帳戶：

AI 功能 必要 IAM 角色
Vertex AI 特徵儲存庫

設定模型生成參數

大型語言模型 (LLM) 是以大量文字資料訓練而成的深度學習模型，模型包含參數值，用來控制模型生成回覆的方式。變更參數值即可讓模型生成不同結果。

如要定義模型的生成參數，ABAP 適用的 Vertex AI SDK 會使用 /GOOG/AI_CONFIG 資料表。

如要設定模型的生成參數，請按照下列步驟操作：

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

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

  2. 依序點選「ABAP SDK for Google Cloud」>「Basic Settings」>「Vertex AI SDK: Configure Model Generation Parameters」。

  3. 按一下「New Entries」。

  4. 選擇模型系列，然後視需要輸入值：

    Gemini

    欄位 資料類型 說明
    模型鍵 字串

    您指定的專屬名稱，用於識別模型設定，例如 Gemini。

    例項化生成模型類別或嵌入類別時，您可以使用這個模型鍵，指定要生效的生成設定。
    模型 ID 字串

    LLM 的模型 ID，例如 gemini-1.5-flash-001。

    如要瞭解 Vertex AI 模型版本，請參閱「模型版本和生命週期」。
    Google Cloud 金鑰名稱 字串 您在驗證設定期間設定的用戶端金鑰，用於驗證 Google Cloud 。
    Google Cloud 區域位置 ID 字串

    您要使用的 Vertex AI 功能所在區域的位置 ID。 Google Cloud

    一般來說，您會使用離自己或目標使用者實際位置最近的地區。詳情請參閱「Vertex AI 服務地區」。
    LLM 的發布商 ID 字串 (選用步驟) LLM 的發布者，例如 google。
    回應 MIME 類型 字串 (選用步驟) 生成候選文字的輸出回應 MIME 類型。 支援的 MIME 類型：
    • text/plain：(預設) 文字輸出。
    • application/json：候選人中的 JSON 回應。
    您必須提示模型輸出適當的回應類型，否則行為未定義。
    隨機溫度 字串

    (選用步驟) 控制預測的隨機性。詳情請參閱「溫度」。

    範圍：[0.0, 1.0]
    Top-K 取樣 浮點值

    (選用步驟) Top-K 會影響模型選取輸出詞元的方式。

    如要取得較不隨機的回覆，請指定較低的值；如要取得較隨機的回覆，請調高此值。詳情請參閱「Top-K」。

    範圍：[1, 40]
    Top-P 取樣 浮點值

    (選用步驟) Top-P 會影響模型選取輸出詞元的方式。

    如要取得較不隨機的回覆，請指定較低的值；如要取得較隨機的回覆，請調高此值。詳情請參閱「Top-P」。

    範圍：[0.0, 1.0]
    每則訊息的輸出詞元數量上限 整數

    (選用步驟) 回覆內可以生成的權杖數量上限。一個符記約為四個字元。100 個符記約等於 60 到 80 個字。

    如要取得較短的回覆，請指定較低的值；如要取得可能較長的回覆，請調高此值。
    正面處置 浮點值

    (選用步驟) 正值會懲罰出現在生成文字中的符記，因此可提高生成更多不同主題的可能性。

    範圍：[-2.0, 2.0]
    頻率處罰 浮點值

    (選用步驟) 正值會懲罰在生成文字中重複出現的符記，因此降低重複相同內容的可能性。

    範圍：[-2.0, 2.0]

    Claude

    欄位 資料類型 說明
    模型鍵 字串

    您指定的專屬名稱，用於識別模型設定，例如 Claude。

    例項化生成模型類別時，您可以使用這個模型鍵，指定要生效的生成設定。
    模型 ID 字串

    支援的 Claude 模型 ID，例如 claude-sonnet-4@20250514。

    支援的 Claude 模型如下：
    Google Cloud 金鑰名稱 字串 您在驗證設定期間設定的用戶端金鑰，用於驗證 Google Cloud 。
    Google Cloud 區域位置 ID 字串

    您要使用的 Claude 模型所在 Google Cloud 地區的 ID。

    一般來說，您會使用離自己或目標使用者實際位置最近的地區。詳情請參閱「Anthropic Claude 配額和區域供應情形」。
    LLM 的發布商 ID 字串 (選用步驟) LLM 的發布者，例如 anthropic。
    回應 MIME 類型 字串 (選用步驟) 生成候選文字的輸出回應 MIME 類型。 支援的 MIME 類型：
    • text/plain：(預設) 文字輸出。
    • application/json：候選人中的 JSON 回應。
    您必須提示模型輸出適當的回應類型，否則行為未定義。
    隨機溫度 字串

    (選用步驟) 控制預測的隨機性。詳情請參閱「溫度」。

    範圍：[0.0, 1.0]
    Top-K 取樣 浮點值

    (選用步驟) Top-K 會影響模型選取輸出詞元的方式。

    如要取得較不隨機的回覆，請指定較低的值；如要取得較隨機的回覆，請調高此值。詳情請參閱「Top-K」。

    範圍：[1, 40]
    Top-P 取樣 浮點值

    (選用步驟) Top-P 會影響模型選取輸出詞元的方式。

    如要取得較不隨機的回覆，請指定較低的值；如要取得較隨機的回覆，請調高此值。詳情請參閱「Top-P」。

    範圍：[0.0, 1.0]
    每則訊息的輸出詞元數量上限 整數

    (選用步驟) 回覆內可以生成的權杖數量上限。一個符記約為四個字元。100 個符記約等於 60 到 80 個字。

    如要取得較短的回覆，請指定較低的值；如要取得可能較長的回覆，請調高此值。
    正面處置 浮點值

    不適用
    頻率處罰 浮點值

    不適用
    如果您未提供選用參數的值，SDK 會使用 Model ID 中設定的模型版本專屬參數預設值。

  5. 儲存新項目。

設定向量搜尋參數

如要定義 Vector Search 設定，ABAP 適用的 Vertex AI SDK 會使用 /GOOG/SEARCHCONF 資料表。

如要設定向量搜尋參數，請按照下列步驟操作：

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

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

  2. 依序點選「ABAP SDK for Google Cloud」>「Basic Settings」>「Vertex AI SDK: Configure Vector Search Parameters」。

  3. 按一下「New Entries」。

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

    欄位 資料類型 說明
    搜尋鍵 字串 您指定的專屬名稱，用於識別搜尋設定。
    Google Cloud 金鑰名稱 字串 您在驗證設定期間設定的用戶端金鑰，用於驗證 Google Cloud 。
    Google Cloud 區域位置 ID 字串

    您要使用的 Vertex AI 功能所在區域的位置 ID。 Google Cloud

    一般來說，您會使用離自己或目標使用者實際位置最近的地區。詳情請參閱「Vertex AI 服務地區」。
    向量索引的部署作業 ID 字串 索引的部署作業 ID。將索引部署至端點時，您會為索引指派專屬的部署 ID。

    如要瞭解如何部署索引，請參閱「將向量索引部署至索引端點」。
    向量索引端點 ID 字串

    索引部署到的索引端點 ID。

    如要瞭解索引端點，請參閱「建立向量索引端點」。

  5. 儲存新項目。

後續步驟