btp genai starter kit

SAP BTP genAI 入門套件

描述

該儲存庫希望為 SAP 業務技術平台 (BTP) 使用者提供一種快速的方法來學習如何將生成式 AI 與 BTP 服務結合使用。

要求

• 您有權存取 SAP BTP 全域帳戶或現有 SAP BTP 子帳戶。

• Visual Studio Code使用Dev Container擴充功能安裝在您的電腦上。您了解 VS Code 中開發容器的用途和基本概念。

• 作為使用開發容器的先決條件， Docker已安裝在您的電腦上，並且您了解其基本概念。

• Git在您的電腦上可用（使用git --version進行測試）並且您知道如何從 github 複製專案。

• SAP BTP 全域帳戶需要有足夠的權限才能使用下列服務和應用程式：

  姓名	服務/應用	計劃
  人工智慧核心	aicore （服務）	extended
  AI 啟動板（選購）	ai-launchpad （應用程式訂閱）	standard
  哈納雲	hana-cloud （服務）	hana
  HANA 雲端工具	hana-cloud-tools （應用程式訂閱）	tools

下載與安裝

第 1 步：設定 SAP BTP 基礎設施

• 將此 GitHub 儲存庫複製到本機電腦並在 VS Code 中開啟它。
• 從 VS Code 開啟電腦上的開發容器（ Reopen in Dev Container ）。
• 等待建置開發容器並在其中載入專案。

  請注意，打開開發容器可能需要一段時間！

• 在資料夾config/secrets中，將檔案btp_ai_setup.tfvars重新命名為my_btp_ai_setup.tfvars 。
  • 調整globalaccount的值以適應要建立的子帳戶。您可以在全域帳戶登陸頁面中找到（「子網域：.....」）。
  • 如果您想使用自訂 IDP，請提供idp的值，例如<your-ias-tenant>.accounts.ondemand.com 。
  • 將您的電子郵件地址加入變數admins 。這應該類似於： admins = ["[email protected]"] 。
  • 儲存文件。
• 在資料夾config/secrets中，將檔案btp_credentials.tfvars重新命名為my_btp_credentials.tfvars 。
  • 將變數BTP_USERNAME的值調整為您的電子郵件地址。
  • 儲存文件。
• 在 VS Code 中開啟終端會話。
• 在終端機中，只需輸入./run.sh並輸入您的BTP_PASSWORD以及HANA DB的密碼（系統將相應提示您）。

  確保 HANA DB 的密碼符合最低要求（長度 >= 8、1+ 大寫字元、2+ 小寫字元、1+ 數字）！

如果您想透過單一登入 (SSO) 進行身份驗證，您應該將環境變數BTP_ENABLE_SSO設為true 。您可以透過在開發容器中執行下列命令來執行此操作： export BTP_ENABLE_SSO=true

startet 腳本現在將為您在 SAP BTP 全域帳戶中設定以下內容：

• 它會建立一個子帳戶，其名稱在my_btp_ai_setup.tfvars檔案（資料夾config/secrets ）中配置。
• 它為以下服務建立服務實例/訂閱
  • SAP AI 核心（服務）
  • 具有整合向量引擎的 SAP HANA Cloud（服務）
  • SAP HANA Cloud 工具（應用程式訂閱）
• 它會建立一個名為.env的文件，該文件將被複製到config/secrets資料夾中。

步驟 2：在 AI Core 中為 genAI 實驗部署 AI 模型

第二步將由執行步驟 1 中的./run.sh指令自動完成。
BTP子帳戶設定成功後，會呼叫scripts資料夾下的python腳本poetry run python main.py

該 python 腳本執行以下操作：

• 它將步驟 1 中新建立的.env檔案的內容載入到會話的環境變數中。
• 它呼叫 AI Core API，讓您可以存取在檔案 config/secrets/my_btp_ai_setup.tfvars 中定義的模型（透過變數target_ai_core_model ）。

第 3 步：運行 GenAI 範例

完成上述步驟後，您就可以在 SAP BTP 上進行首次 genAI 實驗了。

您可以切換到資料夾scripts/step03_explore_examples繼續。

在這裡您將找到一些範例以及相應的說明和範例程式碼。

已知問題

❗存在一個問題，導致 AI Core API 令牌在創建後約 1-2 小時內無效。我們實作了重試機制，但是，在問題解決之前，執行./run.sh可能會導致以下錯誤。作為臨時解決方法，只需在 1-2 小時內重新運行./run.sh即可。

如何獲得支持

如果您發現錯誤或對內容有疑問，請在此儲存庫中建立問題。

如需其他支持，請在 SAP 社群中提問。

貢獻

如果您希望貢獻程式碼、提供修復或改進，請發送拉取請求。由於法律原因，貢獻者在為此專案創建第一個拉取請求時將被要求接受 DCO。這在提交過程中以自動方式發生。 SAP 使用 Linux 基金會的標準 DC 文字。

執照

版權所有 (c) 2024 SAP SE 或 SAP 附屬公司。版權所有。除非 LICENSE 檔案另有說明，該專案已根據 Apache 軟體授權 2.0 版獲得許可。