btp genai starter kit

SAP BTP genAI Starterkit

Beschreibung

Dieses Repo soll Benutzern der SAP Business Technology Platform (BTP) eine schnelle Möglichkeit bieten, den Einsatz generativer KI mit BTP-Diensten zu erlernen.

Anforderungen

• Sie haben Zugriff auf ein SAP BTP-Globalkonto oder ein bestehendes SAP BTP-Unterkonto.

• Visual Studio Code wird mit der Dev Container Erweiterung auf Ihrem Computer installiert. Sie verstehen den Zweck und die grundlegenden Konzepte von Entwicklungscontainern in VS Code.

• Als Voraussetzung für die Verwendung von Entwicklungscontainern ist Docker auf Ihrem Computer installiert und Sie verstehen die Grundkonzepte.

• Git ist auf Ihrem Computer verfügbar (Testen Sie mit git --version ) und Sie wissen, wie Sie ein Projekt von Github klonen.

• Das SAP BTP-Globalkonto muss über ausreichende Berechtigungen zur Nutzung der folgenden Dienste und Anwendungen verfügen:

  Name	Service/Anwendung	Planen
  KI-Kern	aicore (Dienstleistung)	extended
  AI Launchpad (optional)	ai-launchpad (App-Abonnement)	standard
  HANA-Cloud	hana-cloud (Dienst)	hana
  HANA-Cloud-Tools	hana-cloud-tools (App-Abonnement)	tools

Download und Installation

Schritt 1: Richten Sie die SAP BTP-Infrastruktur ein

• Klonen Sie dieses GitHub-Repository auf Ihren lokalen Computer und öffnen Sie es in VS Code.
• Öffnen Sie den Dev-Container auf Ihrem Computer in VS Code ( Reopen in Dev Container ).
• Warten Sie, bis der Entwicklungscontainer erstellt und das Projekt darin geladen ist.

  Beachten Sie, dass das Öffnen des Entwicklungscontainers eine Weile dauern kann!

• Benennen Sie im Ordner config/secrets die Datei btp_ai_setup.tfvars in my_btp_ai_setup.tfvars um.
  • Passen Sie den Wert für globalaccount für das Unterkonto an, das darin erstellt werden soll. Sie finden es auf der globalen Konto-Landingpage („Subdomain: …“).
  • Wenn Sie benutzerdefiniertes IDP verwenden möchten, geben Sie den Wert für idp an, z. B. <your-ias-tenant>.accounts.ondemand.com .
  • Fügen Sie Ihre E-Mail-Adresse zur Variable admins hinzu. Dies sollte etwa so aussehen: admins = ["[email protected]"] .
  • Speichern Sie die Datei.
• Benennen Sie im Ordner config/secrets die Datei btp_credentials.tfvars in my_btp_credentials.tfvars um.
  • Passen Sie den Wert für die Variable BTP_USERNAME an Ihre E-Mail-Adresse an.
  • Speichern Sie die Datei.
• Öffnen Sie in VS Code eine Terminalsitzung.
• Geben Sie im Terminal einfach ./run.sh ein und geben Sie Ihr BTP_PASSWORD sowie das Passwort für die HANA DB ein (Sie werden entsprechend aufgefordert).

  Stellen Sie sicher, dass das Passwort für die HANA DB den Mindestanforderungen entspricht (Länge >= 8, 1+ Großbuchstaben, 2+ Kleinbuchstaben, 1+ Ziffer)!

Wenn Sie sich über Single-Sign-On (SSO) authentifizieren möchten, sollten Sie die Umgebungsvariable BTP_ENABLE_SSO auf true setzen. Sie tun dies, indem Sie den folgenden Befehl in Ihrem Entwicklungscontainer ausführen: export BTP_ENABLE_SSO=true

Das gestartete Skript richtet nun die folgenden Dinge für Sie in Ihrem globalen SAP BTP-Konto ein:

• Es erstellt ein Unterkonto mit dem Namen, der in der Datei my_btp_ai_setup.tfvars (Ordner config/secrets ) konfiguriert ist.
• Es erstellt Dienstinstanzen/Abonnements für die folgenden Dienste
  • SAP AI Core (Dienstleistung)
  • SAP HANA Cloud (Dienst) mit integrierter Vektor-Engine
  • SAP HANA Cloud-Tools (App-Abonnement)
• Es erstellt eine Datei namens .env , die in den Ordner config/secrets kopiert wird.

Schritt 2: Stellen Sie KI-Modelle für Ihre genAI-Experimente in AI Core bereit

Der zweite Schritt wird automatisch durch den ausgeführten Befehl ./run.sh aus Schritt 1 erledigt.
Nach der erfolgreichen Einrichtung des BTP-Unterkontos ruft dieses das Python-Skript „ poetry run python main.py im Ordner scripts auf.

Dieses Python-Skript führt Folgendes aus:

• Es lädt den Inhalt der neu erstellten .env Datei aus Schritt 1 in die Umgebungsvariablen der Sitzung.
• Es ruft die AI Core-APIs auf, um Ihnen Zugriff auf die Modelle zu gewähren, die Sie in der Datei config/secrets/my_btp_ai_setup.tfvars definiert haben (über die Variable target_ai_core_model ).

Schritt 3: GenAI-Beispiele ausführen

Nach den oben genannten Schritten sind Sie bereit für Ihre ersten genAI-Experimente auf SAP BTP.

Sie können fortfahren, indem Sie zum Ordner scripts/step03_explore_examples wechseln.

Hier finden Sie einige Beispiele mit entsprechender Anleitung und Beispielcode.

Bekannte Probleme

❗Es besteht ein Problem, das dazu führt, dass das AI Core API-Token nach seiner Erstellung etwa 1–2 Stunden lang ungültig ist. Wir haben einen Wiederholungsmechanismus implementiert. Bis das Problem behoben ist, kann die Ausführung von ./run.sh jedoch zu dem folgenden Fehler führen. Als vorübergehende Problemumgehung führen Sie einfach ./run.sh in 1–2 Stunden erneut aus.

So erhalten Sie Unterstützung

Erstellen Sie in diesem Repository ein Problem, wenn Sie einen Fehler finden oder Fragen zum Inhalt haben.

Wenn Sie weitere Unterstützung benötigen, stellen Sie eine Frage in der SAP-Community.

Mitwirken

Wenn Sie Code beisteuern, Korrekturen oder Verbesserungen anbieten möchten, senden Sie bitte eine Pull-Anfrage. Aus rechtlichen Gründen werden Mitwirkende gebeten, einen DCO zu akzeptieren, wenn sie den ersten Pull-Request für dieses Projekt erstellen. Dies geschieht automatisiert während des Einreichungsprozesses. SAP verwendet den Standard-DCO-Text der Linux Foundation.

Lizenz

Copyright (c) 2024 SAP SE oder ein SAP-Konzernunternehmen. Alle Rechte vorbehalten. Dieses Projekt ist unter der Apache-Softwarelizenz, Version 2.0, lizenziert, sofern in der LIZENZdatei nichts anderes angegeben ist.