btp genai starter kitダウンロード - btp genai starter kitソースコードダウンロード

btp genai starter kit

AI ソースコード

1.0.0

ダウンロード

SAP BTP genAI スターターキット

説明

このリポジトリは、SAP Business Technology Platform (BTP) のユーザーに、BTP サービスで生成 AI を使用する方法を学ぶための簡単な方法を提供したいと考えています。

アーキテクチャの概要

要件

SAP BTP グローバルアカウントまたは既存の SAP BTP サブアカウントにアクセスできます。
Visual Studio Code 、 Dev Container拡張機能とともにマシンにインストールされます。 VS Code の開発コンテナの目的と基本概念を理解している。
開発コンテナを使用するための前提条件として、 Dockerがマシンにインストールされており、その基本概念を理解している必要があります。
Gitマシン上で利用可能であり ( git --versionでテスト)、github からプロジェクトをクローンする方法を知っています。

SAP BTP グローバルアカウントには、次のサービスとアプリケーションを使用するための十分な資格が必要です。

名前	サービス・アプリケーション	プラン
AIコア	`aicore` （サービス）	`extended`
AI ランチパッド(オプション)	`ai-launchpad` (アプリのサブスクリプション)	`standard`
HANAクラウド	`hana-cloud` （サービス）	`hana`
HANAクラウドツール	`hana-cloud-tools` (アプリのサブスクリプション)	`tools`

ダウンロードとインストール

ステップ 1: SAP BTP インフラストラクチャをセットアップする

この GitHub リポジトリのクローンをローカルマシンに作成し、VS Code で開きます。
VS Code 内からマシン上の Dev Container を開きます ( 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 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 コアでの genAI 実験用の AI モデルのデプロイ

2 番目のステップは、ステップ 1 で./run.shコマンドを実行することによって自動的に処理されます。
BTP サブアカウントのセットアップが成功すると、 scriptsフォルダー内の Python スクリプトpoetry run python main.pyが呼び出されます。

この Python スクリプトは次のことを行います。

ステップ 1 で新しく作成された.envファイルの内容がセッションの環境変数にロードされます。
AI コア API を呼び出して、(変数target_ai_core_modelを介して) ファイル config/secrets/my_btp_ai_setup.tfvars で定義したモデルにアクセスできるようにします。

ステップ 3: GenAI サンプルを実行する

上記の手順を完了すると、SAP BTP での最初の genAI 実験の準備が完了しました。

scripts/step03_explore_examplesフォルダーに切り替えて続行できます。

ここでは、それぞれの手順とサンプルコードを含むいくつかの例を示します。

既知の問題

❗AI Core API トークンが作成されてから約 1 ～ 2 時間無効になるという既存の問題があります。再試行メカニズムを実装しましたが、問題が解決されるまで./run.sh実行すると次のエラーが発生する可能性があります。一時的な回避策として、1 ～ 2 時間後に./run.sh再実行します。

サポートを受ける方法

バグを見つけた場合、またはコンテンツについて質問がある場合は、このリポジトリに問題を作成してください。

追加のサポートが必要な場合は、SAP コミュニティで質問してください。

貢献する

コードに貢献したい場合、修正や改善を提供したい場合は、プルリクエストを送信してください。法的な理由により、コントリビューターは、このプロジェクトへの最初のプルリクエストを作成するときに DCO を受け入れるように求められます。これは、送信プロセス中に自動的に行われます。 SAP は、Linux Foundation の標準 DCO テキストを使用します。