btp genai starter kit

Kit inicial SAP BTP genAI

Descrição

Este repositório deseja oferecer aos usuários do SAP Business Technology Platform (BTP) uma maneira rápida de aprender como usar IA generativa com serviços BTP.

Requisitos

• Você tem acesso a uma conta global SAP BTP ou a uma subconta SAP BTP existente.

• Visual Studio Code é instalado em sua máquina com a extensão Dev Container . Você entende o propósito e os conceitos básicos de Dev Containers no VS Code.

• Como pré-requisito para usar dev containers, Docker está instalado em sua máquina e você entende seus conceitos básicos.

• Git está disponível na sua máquina (teste com git --version ) e você sabe como clonar um projeto do github.

• A conta global SAP BTP precisa ter autorização suficiente para usar os seguintes serviços e aplicativos:

  Nome	Serviço/Aplicativo	Plano
  Núcleo de IA	aicore (serviço)	extended
  AI Launchpad (opcional)	ai-launchpad (assinatura de aplicativo)	standard
  Nuvem HANA	hana-cloud (serviço)	hana
  Ferramentas de nuvem HANA	hana-cloud-tools (assinatura de aplicativo)	tools

Download e instalação

Etapa 1: configurar a infraestrutura SAP BTP

• Clone este repositório GitHub em sua máquina local e abra-o no VS Code.
• Abra o Dev Container em sua máquina no VS Code ( Reopen in Dev Container ).
• Aguarde até que o contêiner de desenvolvimento seja construído e o projeto seja carregado dentro dele.

  Esteja ciente de que abrir o contêiner de desenvolvimento pode demorar um pouco!

• Na pasta config/secrets renomeie o arquivo btp_ai_setup.tfvars para my_btp_ai_setup.tfvars .
  • adapte o valor da globalaccount para a subconta a ser criada. Você encontra na página de destino da conta global ("Subdomínio: .....").
  • se desejar usar o IDP personalizado, forneça o valor para idp por exemplo, <your-ias-tenant>.accounts.ondemand.com .
  • adicione seu endereço de e-mail à variável admins . Deve ser semelhante a isto: admins = ["[email protected]"] .
  • salve o arquivo.
• Na pasta config/secrets renomeie o arquivo btp_credentials.tfvars para my_btp_credentials.tfvars .
  • adapte o valor da variável BTP_USERNAME ao seu endereço de e-mail.
  • salve o arquivo.
• No VS Code, abra uma sessão de terminal.
• No terminal, basta digitar ./run.sh e inserir seu BTP_PASSWORD bem como a senha do HANA DB (você será solicitado de acordo).

  Certifique-se de que a senha do banco de dados HANA corresponda aos requisitos mínimos (comprimento >= 8, 1+ caracteres maiúsculos, 2+ caracteres minúsculos, 1+ dígito)!

Caso queira autenticar via Single-Sign-On (SSO) você deve definir a variável de ambiente BTP_ENABLE_SSO como true . Você faz isso executando o seguinte comando em seu contêiner de desenvolvimento: export BTP_ENABLE_SSO=true

O script startet agora configurará o seguinte para você em sua conta global SAP BTP:

• Ele cria uma subconta com o nome configurado no arquivo my_btp_ai_setup.tfvars (pasta config/secrets ).
• Ele cria instâncias/assinaturas de serviço para os seguintes serviços
  • SAP AI Core (serviço)
  • SAP HANA Cloud (serviço) com mecanismo vetorial integrado
  • Ferramentas SAP HANA Cloud (assinatura de aplicativo)
• Ele cria um arquivo chamado .env que será copiado para a pasta config/secrets .

Etapa 2: implantar modelos de IA para seus experimentos genAI no AI Core

A segunda etapa será realizada automaticamente pela execução do comando ./run.sh da etapa 1.
Após a configuração bem-sucedida da subconta BTP, ela chama o script python poetry run python main.py na pasta scripts .

Esse script python faz o seguinte:

• Ele carrega o conteúdo do arquivo .env recém-criado da etapa 1 nas variáveis ​​de ambiente da sessão.
• Ele chama as APIs do AI Core para fornecer acesso aos modelos definidos no arquivo config/secrets/my_btp_ai_setup.tfvars (por meio da variável target_ai_core_model ).

Etapa 3: execute exemplos GenAI

Após as etapas acima, você estará pronto para seus primeiros experimentos genAI no SAP BTP.

Você pode prosseguir mudando para a pasta scripts/step03_explore_examples .

Aqui você encontrará alguns exemplos com respectivas instruções e código de exemplo.

Problemas conhecidos

❗Existe um problema que torna o token da API AI Core inválido por cerca de 1 a 2 horas após sua criação. Implementamos um mecanismo de nova tentativa, no entanto, até que o problema seja resolvido, executar ./run.sh pode resultar no seguinte erro. Como solução temporária, basta executar novamente o ./run.sh em 1 a 2 horas.

Como obter suporte

Crie um problema neste repositório se encontrar um bug ou tiver dúvidas sobre o conteúdo.

Para suporte adicional, faça uma pergunta na Comunidade SAP.

Contribuindo

Se você deseja contribuir com código, oferecer correções ou melhorias, envie uma solicitação pull. Por motivos legais, os contribuidores serão solicitados a aceitar um DCO quando criarem a primeira solicitação pull para este projeto. Isso acontece de forma automatizada durante o processo de envio. SAP usa o texto DCO padrão da Linux Foundation.

Licença

Copyright (c) 2024 SAP SE ou empresa afiliada da SAP. Todos os direitos reservados. Este projeto está licenciado sob a Licença de Software Apache, versão 2.0, exceto quando indicado de outra forma no arquivo LICENSE.