btp genai starter kit

Стартовый комплект SAP BTP genAI

Описание

Цель этого репозитория — предоставить пользователям SAP Business Technology Platform (BTP) быстрый способ научиться использовать генеративный искусственный интеллект с сервисами BTP.

Требования

• У вас есть доступ к глобальной учетной записи SAP BTP или существующей дополнительной учетной записи SAP BTP.

• Visual Studio Code устанавливается на ваш компьютер с расширением Dev Container . Вы понимаете назначение и основные концепции Dev-контейнеров в 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 соответствует минимальным требованиям (длина >= 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 Core (сервис)
  • SAP HANA Cloud (сервис) со встроенным векторным механизмом
  • Облачные инструменты SAP HANA (подписка на приложение)
• Он создает файл с именем .env , который будет скопирован в папку config/secrets .

Шаг 2. Разверните модели ИИ для экспериментов по генИИ в AI Core.

Второй шаг будет автоматически выполнен запуском команды ./run.sh из шага 1.
После успешной настройки субаккаунта BTP он вызывает poetry run python main.py в папке scripts .

Этот скрипт Python делает следующее:

• Он загружает содержимое вновь созданного файла .env из шага 1 в переменные среды сеанса.
• Он вызывает API-интерфейсы AI Core, чтобы предоставить вам доступ к моделям, которые вы определили в файле config/secrets/my_btp_ai_setup.tfvars (через переменную target_ai_core_model ).

Шаг 3. Запустите примеры GenAI

После описанных выше шагов все готово для первых экспериментов по genAI в SAP BTP.

Вы можете продолжить, перейдя в папку scripts/step03_explore_examples .

Здесь вы найдете несколько примеров с соответствующими инструкциями и примером кода.

Известные проблемы

❗Существует проблема, из-за которой токен AI Core API становится недействительным в течение примерно 1–2 часов после его создания. Тем не менее, мы реализовали механизм повтора, пока проблема не будет решена, запуск ./run.sh может привести к следующей ошибке. В качестве временного решения просто перезапустите ./run.sh через 1–2 часа.

Как получить поддержку

Создайте проблему в этом репозитории, если обнаружите ошибку или у вас возникнут вопросы по содержанию.

Для получения дополнительной поддержки задайте вопрос в сообществе SAP.

Содействие

Если вы хотите добавить код, предложить исправления или улучшения, отправьте запрос на включение. По юридическим причинам участникам будет предложено принять DCO при создании первого запроса на включение в этот проект. Это происходит автоматически во время процесса подачи. SAP использует стандартный текст DCO Linux Foundation.

Лицензия

Авторские права (c) принадлежат SAP SE или аффилированной компании SAP, 2024 г. Все права защищены. Этот проект лицензируется по лицензии Apache Software License версии 2.0, если иное не указано в файле LICENSE.