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​​O 文本。

执照

版权所有 (c) 2024 SAP SE 或 SAP 附属公司。版权所有。除非 LICENSE 文件中另有说明，该项目已根据 Apache 软件许可证 2.0 版获得许可。