Téléchargement btp genai starter kit - btp genai starter kit Téléchargement du code source

btp genai starter kit

Code Source AI

1.0.0

Télécharger

Kit de démarrage SAP BTP genAI

Description

Ce référentiel souhaite offrir aux utilisateurs de SAP Business Technology Platform (BTP) un moyen rapide d'apprendre à utiliser l'IA générative avec les services BTP.

Aperçu architectural

Exigences

Vous avez accès à un compte global SAP BTP ou à un sous-compte SAP BTP existant.
Visual Studio Code est installé sur votre ordinateur avec l'extension Dev Container . Vous comprenez le but et les concepts de base des conteneurs de développement dans VS Code.
Comme condition préalable à l'utilisation de conteneurs de développement, Docker est installé sur votre machine et vous comprenez ses concepts de base.
Git est disponible sur votre machine (testez avec git --version ) et vous savez comment cloner un projet depuis github.

Le compte global SAP BTP doit être suffisamment autorisé pour utiliser les services et applications suivants :

Nom	Service/Application	Plan
Noyau d'IA	`aicore` (service)	`extended`
AI Launchpad (facultatif)	`ai-launchpad` (abonnement à l'application)	`standard`
HANA-Cloud	`hana-cloud` (service)	`hana`
Outils cloud HANA	`hana-cloud-tools` (abonnement à l'application)	`tools`

Téléchargement et installation

Étape 1 : Configurer l'infrastructure SAP BTP

Clonez ce référentiel GitHub sur votre machine locale et ouvrez-le dans VS Code.
Ouvrez le conteneur de développement sur votre machine à partir de VS Code ( Reopen in Dev Container ).
Attendez que le conteneur de développement soit construit et que le projet y soit chargé.
Sachez que l’ouverture du conteneur de développement peut prendre un certain temps !
Dans le dossier config/secrets renommez le fichier btp_ai_setup.tfvars en my_btp_ai_setup.tfvars .
- adaptez la valeur du globalaccount pour le sous-compte à créer. Vous le trouvez dans la page d'accueil du compte global ("Sous-domaine : .....").
- si vous souhaitez utiliser un IDP personnalisé, fournissez la valeur pour idp par exemple <your-ias-tenant>.accounts.ondemand.com .
- ajoutez votre adresse email à la variable admins . Cela devrait ressembler à ceci : admins = ["[email protected]"] .
- enregistrez le fichier.
Dans le dossier config/secrets renommez le fichier btp_credentials.tfvars en my_btp_credentials.tfvars .
- adaptez la valeur de la variable BTP_USERNAME à votre adresse email.
- enregistrez le fichier.
Dans VS Code, ouvrez une session de terminal.
Dans le terminal, tapez simplement ./run.sh et entrez votre BTP_PASSWORD ainsi que le mot de passe de la HANA DB (vous serez invité en conséquence).
Assurez-vous que le mot de passe de la base de données HANA correspond aux exigences minimales (longueur >= 8, 1+ caractères majuscules, 2+ caractères minuscules, 1+ chiffres) !

Si vous souhaitez vous authentifier via Single-Sign-On (SSO), vous devez définir la variable d'environnement BTP_ENABLE_SSO sur true . Pour ce faire, exécutez la commande suivante dans votre conteneur de développement : export BTP_ENABLE_SSO=true

Le script startet va maintenant configurer les éléments suivants pour vous dans votre compte global SAP BTP :

Il crée un sous-compte avec le nom configuré dans le fichier my_btp_ai_setup.tfvars (dossier config/secrets ).
Il crée des instances de service/abonnements pour les services suivants
- SAP AI Core (service)
- SAP HANA Cloud (service) avec moteur vectoriel intégré
- Outils SAP HANA Cloud (abonnement à l'application)
Il crée un fichier appelé .env qui sera copié dans le dossier config/secrets .

Étape 2 : Déployez des modèles d'IA pour vos expériences genAI dans AI Core

La deuxième étape sera automatiquement prise en charge par l'exécution de la commande ./run.sh à partir de l'étape 1.
Après la configuration réussie du sous-compte BTP, il appelle le script python poetry run python main.py dans le dossier scripts .

Ce script python fait ce qui suit :

Il charge le contenu du fichier .env nouvellement créé à partir de l'étape 1 dans les variables d'environnement de la session.
Il appelle les API AI Core pour vous donner accès aux modèles que vous avez définis dans le fichier config/secrets/my_btp_ai_setup.tfvars (via la variable target_ai_core_model ).

Étape 3 : Exécuter des exemples GenAI

Après les étapes ci-dessus, vous êtes prêt pour vos premières expériences genAI sur SAP BTP.

Vous pouvez continuer en basculant vers le dossier scripts/step03_explore_examples .

Vous trouverez ici quelques exemples avec des instructions respectives et un exemple de code.

Problèmes connus

❗Il existe un problème qui rend le jeton API AI Core invalide pendant environ 1 à 2 heures après sa création. Nous avons implémenté un mécanisme de nouvelle tentative. Néanmoins, jusqu'à ce que le problème soit résolu, l'exécution de ./run.sh peut entraîner l'erreur suivante. Comme solution de contournement temporaire, réexécutez simplement le ./run.sh dans 1 à 2 heures.

Comment obtenir de l'aide

Créez un problème dans ce référentiel si vous trouvez un bug ou si vous avez des questions sur le contenu.

Pour obtenir une assistance supplémentaire, posez une question dans SAP Community.

Contribuer

Si vous souhaitez contribuer au code, proposer des correctifs ou des améliorations, veuillez envoyer une pull request. Pour des raisons juridiques, les contributeurs seront invités à accepter un DCO lorsqu'ils créeront la première pull request pour ce projet. Cela se produit de manière automatisée pendant le processus de soumission. SAP utilise le texte DCO standard de la Linux Foundation.