btp genai starter kit 다운로드 - btp genai starter kit 소스 코드 다운로드

btp genai starter kit

AI 소스 코드

1.0.0

다운로드

SAP BTP genAI 스타터 키트

설명

이 저장소는 SAP 비즈니스 기술 플랫폼(BTP) 사용자에게 BTP 서비스와 함께 생성 AI를 사용하는 방법을 빠르게 배울 수 있는 방법을 제공하고자 합니다.

아키텍처 개요

요구사항

SAP BTP 글로벌 계정 또는 기존 SAP BTP 하위 계정에 액세스할 수 있습니다.
Visual Studio Code Dev Container 확장을 통해 컴퓨터에 설치됩니다. VS Code에서 Dev 컨테이너의 목적과 기본 개념을 이해합니다.
개발 컨테이너를 사용하기 위한 전제 조건으로 Docker 컴퓨터에 설치되어 있으며 기본 개념을 이해하고 있습니다.
Git 귀하의 컴퓨터에서 사용할 수 있으며( git --version 으로 테스트) github에서 프로젝트를 복제하는 방법을 알고 있습니다.

SAP BTP 글로벌 계정은 다음 서비스 및 애플리케이션을 사용할 수 있는 충분한 권한이 있어야 합니다.

이름	서비스/응용	계획
AI 코어	`aicore` (서비스)	`extended`
AI 런치패드 (선택사항)	`ai-launchpad` (앱 구독)	`standard`
하나클라우드	`hana-cloud` (서비스)	`hana`
HANA 클라우드 도구	`hana-cloud-tools` (앱 구독)	`tools`

다운로드 및 설치

1단계: SAP BTP 인프라 설정

이 GitHub 저장소를 로컬 머신에 복제하고 VS Code에서 엽니다.
VS Code 내에서 머신의 Dev 컨테이너를 엽니다( 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 DB의 비밀번호가 최소 요구 사항(길이 >= 8, 1+ 대문자, 2+ 소문자, 1+ 숫자)과 일치하는지 확인하세요!

SSO(Single-Sign-On)를 통해 인증하려는 경우 환경 변수 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 Cloud 도구(앱 구독)
config/secrets 폴더에 복사될 .env 라는 파일이 생성됩니다.

2단계: AI Core에서 genAI 실험을 위한 AI 모델 배포

두 번째 단계는 1단계에서 ./run.sh 명령을 실행하면 자동으로 처리됩니다.
BTP 하위 계정이 성공적으로 설정되면 scripts 폴더에서 poetry run python main.py Python 스크립트를 호출합니다.

해당 Python 스크립트는 다음을 수행합니다.

1단계에서 새로 생성된 .env 파일의 내용을 세션의 환경 변수에 로드합니다.
AI Core API를 호출하여 config/secrets/my_btp_ai_setup.tfvars 파일( 변수 target_ai_core_model )에 정의한 모델에 대한 액세스를 제공합니다.

3단계: GenAI 예제 실행

위 단계를 완료하면 SAP BTP에 대한 첫 번째 genAI 실험을 위한 모든 준비가 완료되었습니다.

scripts/step03_explore_examples 폴더로 전환하여 진행할 수 있습니다.

여기서는 해당 지침과 샘플 코드가 포함된 몇 가지 예를 찾을 수 있습니다.

알려진 문제

❗AI Core API 토큰이 생성된 후 약 1~2시간 동안 무효화되는 문제가 기존에 있습니다. 그럼에도 불구하고 재시도 메커니즘을 구현했지만 문제가 해결될 때까지 ./run.sh 를 실행하면 다음 오류가 발생할 수 있습니다. 임시 해결 방법으로 1~2시간 후에 ./run.sh 를 다시 실행하세요.

지원을 받는 방법

버그를 발견하거나 콘텐츠에 대한 질문이 있는 경우 이 저장소에서 문제를 생성하세요.

추가 지원이 필요하면 SAP 커뮤니티에 질문하세요.

기여

코드를 제공하고 수정 사항이나 개선 사항을 제공하려면 풀 요청을 보내주세요. 법적인 이유로 인해 기여자는 이 프로젝트에 대한 첫 번째 끌어오기 요청을 생성할 때 DCO를 수락하라는 요청을 받게 됩니다. 이는 제출 프로세스 중에 자동화된 방식으로 발생합니다. SAP는 Linux Foundation의 표준 DCO 텍스트를 사용합니다.