btp genai starter kit

Kit de inicio SAP BTP genAI

Descripción

Este repositorio quiere brindar a los usuarios de SAP Business Technology Platform (BTP) una forma rápida de aprender a utilizar la IA generativa con servicios BTP.

Requisitos

• Tiene acceso a una cuenta global de SAP BTP o a una subcuenta de SAP BTP existente.

• Visual Studio Code está instalado en su máquina con la extensión Dev Container . Comprende el propósito y los conceptos básicos de Dev Containers en VS Code.

• Como requisito previo para utilizar contenedores de desarrollo, Docker está instalado en su máquina y usted comprende sus conceptos básicos.

• Git está disponible en su máquina (pruebe con git --version ) y sabe cómo clonar un proyecto desde github.

• La cuenta global de SAP BTP debe tener derechos suficientes para utilizar los siguientes servicios y aplicaciones:

  Nombre	Servicio/Aplicación	Plan
  Núcleo de IA	aicore (servicio)	extended
  Plataforma de lanzamiento de IA (opcional)	ai-launchpad (suscripción a la aplicación)	standard
  Nube HANA	hana-cloud (servicio)	hana
  Herramientas en la nube de HANA	hana-cloud-tools (suscripción a la aplicación)	tools

Descarga e instalación

Paso 1: configurar la infraestructura SAP BTP

• Clona este repositorio de GitHub en tu máquina local y ábrelo en VS Code.
• Abra el contenedor de desarrollo en su máquina desde VS Code ( Reopen in Dev Container ).
• Espere a que se cree el contenedor de desarrollo y se cargue el proyecto en él.

  ¡Tenga en cuenta que abrir el contenedor de desarrollo puede llevar un tiempo!

• En la carpeta config/secrets cambie el nombre del archivo btp_ai_setup.tfvars a my_btp_ai_setup.tfvars .
  • adapte el valor de globalaccount para la subcuenta que se creará dentro. Lo encontrará en la página de inicio de la cuenta global ("Subdominio: .....").
  • Si desea utilizar un IDP personalizado, proporcione el valor de idp por ejemplo, <your-ias-tenant>.accounts.ondemand.com .
  • agregue su dirección de correo electrónico a la variable admins . Esto debería verse similar a este: admins = ["[email protected]"] .
  • guarde el archivo.
• En la carpeta config/secrets cambie el nombre del archivo btp_credentials.tfvars a my_btp_credentials.tfvars .
  • adapta el valor de la variable BTP_USERNAME a tu dirección de correo electrónico.
  • guarde el archivo.
• Dentro de VS Code abra una sesión de terminal.
• En la terminal simplemente escriba ./run.sh e ingrese su BTP_PASSWORD así como la contraseña de HANA DB (se le solicitará en consecuencia).

  ¡Asegúrese de que la contraseña para HANA DB coincida con los requisitos mínimos (longitud >= 8, 1+ caracteres en mayúsculas, 2+ caracteres en minúsculas, 1+ dígitos)!

En caso de que desee autenticarse mediante inicio de sesión único (SSO), debe configurar la variable de entorno BTP_ENABLE_SSO en true . Para ello, ejecute el siguiente comando dentro de su contenedor de desarrollo: export BTP_ENABLE_SSO=true

El script de inicio ahora configurará las siguientes cosas en su cuenta global de SAP BTP:

• Crea una subcuenta con el nombre configurado en el archivo my_btp_ai_setup.tfvars (carpeta config/secrets ).
• Crea instancias de servicio/suscripciones para los siguientes servicios.
  • Núcleo de IA de SAP (servicio)
  • SAP HANA Cloud (servicio) con motor vectorial integrado
  • Herramientas SAP HANA Cloud (suscripción a la aplicación)
• Crea un archivo llamado .env que se copiará en la carpeta config/secrets .

Paso 2: Implemente modelos de IA para sus experimentos genAI en AI Core

El segundo paso se realizará automáticamente ejecutando el comando ./run.sh del paso 1.
Después de la configuración exitosa de la subcuenta BTP, llama al script de Python poetry run python main.py en la carpeta scripts .

Ese script de Python hace lo siguiente:

• Carga el contenido del archivo .env recién creado desde el paso 1 en las variables de entorno de la sesión.
• Llama a las API de AI Core para brindarle acceso a los modelos que ha definido en el archivo config/secrets/my_btp_ai_setup.tfvars (a través de la variable target_ai_core_model ).

Paso 3: ejecutar ejemplos de GenAI

Después de los pasos anteriores, estará listo para sus primeros experimentos genAI en SAP BTP.

Puede continuar cambiando a la carpeta scripts/step03_explore_examples .

Aquí encontrará algunos ejemplos con las respectivas instrucciones y código de muestra.

Problemas conocidos

❗Existe un problema que hace que el token AI Core API no sea válido durante aproximadamente 1 a 2 horas después de su creación. Implementamos un mecanismo de reintento; sin embargo, hasta que se resuelva el problema, ejecutar ./run.sh podría generar el siguiente error. Como solución temporal, simplemente vuelva a ejecutar ./run.sh en 1 o 2 horas.

Cómo obtener apoyo

Cree una incidencia en este repositorio si encuentra un error o tiene preguntas sobre el contenido.

Para obtener soporte adicional, haga una pregunta en SAP Community.

Contribuyendo

Si desea contribuir con código, ofrecer correcciones o mejoras, envíe una solicitud de extracción. Por razones legales, se pedirá a los contribuyentes que acepten un DCO cuando creen la primera solicitud de extracción para este proyecto. Esto sucede de forma automatizada durante el proceso de envío. SAP utiliza el texto DCO estándar de la Fundación Linux.

Licencia

Copyright (c) 2024 SAP SE o una empresa filial de SAP. Reservados todos los derechos. Este proyecto tiene la licencia de software Apache, versión 2.0, salvo que se indique lo contrario en el archivo de LICENCIA.