btp genai starter kit

Kit pemula SAP BTP genAI

Keterangan

Repo ini ingin memberikan pengguna SAP Business Technology Platform (BTP) cara cepat untuk mempelajari cara menggunakan AI generatif dengan layanan BTP.

Persyaratan

• Anda memiliki akses ke akun global SAP BTP atau sub akun SAP BTP yang sudah ada.

• Visual Studio Code diinstal pada mesin Anda dengan ekstensi Dev Container . Anda memahami tujuan dan konsep dasar Dev Containers di VS Code.

• Sebagai prasyarat untuk menggunakan wadah dev, Docker diinstal pada mesin Anda dan Anda memahami konsep dasarnya.

• Git tersedia di mesin Anda (uji dengan git --version ) dan Anda tahu cara mengkloning proyek dari github.

• Akun global SAP BTP harus cukup berhak untuk menggunakan layanan dan aplikasi berikut:

  Nama	Layanan/ Aplikasi	Rencana
  Inti AI	aicore (layanan)	extended
  Landasan Peluncuran AI (opsional)	ai-launchpad (langganan aplikasi)	standard
  Awan HANA	hana-cloud (layanan)	hana
  Alat Cloud HANA	hana-cloud-tools (langganan aplikasi)	tools

Unduh dan Instalasi

Langkah 1: Siapkan infrastruktur SAP BTP

• Kloning repositori GitHub ini ke mesin lokal Anda dan buka di VS Code.
• Buka Dev Container di mesin Anda dari dalam VS Code ( Reopen in Dev Container ).
• Tunggu hingga wadah dev dibuat dan proyek dimuat di dalamnya.

  Perlu diketahui bahwa membuka wadah dev dapat memakan waktu cukup lama!

• Di folder config/secrets ganti nama file btp_ai_setup.tfvars menjadi my_btp_ai_setup.tfvars .
  • sesuaikan nilai globalaccount untuk sub-akun yang akan dibuat di dalamnya. Anda temukan di halaman arahan akun global ("Subdomain: .....").
  • jika Anda ingin menggunakan IDP khusus, berikan nilai untuk idp misalnya <your-ias-tenant>.accounts.ondemand.com .
  • tambahkan alamat email Anda ke variabel admins . Seharusnya terlihat seperti ini: admins = ["[email protected]"] .
  • simpan filenya.
• Di folder config/secrets ganti nama file btp_credentials.tfvars menjadi my_btp_credentials.tfvars .
  • sesuaikan nilai variabel BTP_USERNAME dengan alamat email Anda.
  • simpan filenya.
• Dalam VS Code buka sesi terminal.
• Di terminal cukup ketik ./run.sh dan masukkan BTP_PASSWORD Anda serta kata sandi untuk HANA DB (Anda akan diminta untuk melakukannya).

  Pastikan kata sandi untuk HANA DB sesuai dengan persyaratan minimum (panjang >= 8, 1+ karakter huruf besar, 2+ karakter huruf kecil, 1+ digit)!

Jika Anda ingin mengautentikasi melalui Single-Sign-On (SSO), Anda harus mengatur variabel lingkungan BTP_ENABLE_SSO ke true . Anda melakukan ini dengan menjalankan perintah berikut dalam wadah dev Anda: export BTP_ENABLE_SSO=true

Skrip permulaan sekarang akan menyiapkan hal-hal berikut untuk Anda di akun global SAP BTP Anda:

• Ini membuat sub-akun dengan nama yang dikonfigurasi di file my_btp_ai_setup.tfvars (folder config/secrets ).
• Ini menciptakan contoh layanan/langganan untuk layanan berikut
  • SAP AI Core (layanan)
  • SAP HANA Cloud (layanan) dengan mesin vektor terintegrasi
  • Alat SAP HANA Cloud (langganan aplikasi)
• Ini membuat file bernama .env yang akan disalin ke folder config/secrets .

Langkah 2: Terapkan Model AI untuk eksperimen genAI Anda di AI Core

Langkah kedua secara otomatis akan ditangani oleh perintah ./run.sh yang sedang berjalan dari langkah 1.
Setelah pengaturan sub-akun BTP berhasil, ia memanggil poetry run python main.py di folder scripts .

Skrip python itu melakukan hal berikut:

• Ini memuat konten file .env yang baru dibuat dari langkah 1 ke dalam variabel lingkungan sesi.
• Ini memanggil AI Core API untuk memberi Anda akses ke model yang telah Anda tetapkan dalam file config/secrets/my_btp_ai_setup.tfvars (melalui variabel target_ai_core_model ).

Langkah 3: Jalankan contoh GenAI

Setelah langkah-langkah di atas, Anda siap untuk eksperimen genAI pertama Anda di SAP BTP.

Anda dapat melanjutkan dengan beralih ke folder scripts/step03_explore_examples .

Di sini Anda akan menemukan beberapa contoh dengan instruksi dan kode contoh masing-masing.

Masalah yang Diketahui

❗Ada masalah yang membuat token AI Core API tidak valid sekitar 1-2 jam setelah dibuat. Kami menerapkan mekanisme percobaan ulang, namun hingga masalah terselesaikan, menjalankan ./run.sh mungkin mengakibatkan kesalahan berikut. Sebagai solusi sementara, jalankan kembali ./run.sh dalam 1-2 jam.

Cara mendapatkan dukungan

Buat masalah di repositori ini jika Anda menemukan bug atau memiliki pertanyaan tentang konten.

Untuk dukungan tambahan, ajukan pertanyaan di Komunitas SAP.

Berkontribusi

Jika Anda ingin menyumbangkan kode, menawarkan perbaikan atau peningkatan, silakan kirim permintaan penarikan. Karena alasan hukum, kontributor akan diminta untuk menerima DCO ketika mereka membuat pull request pertama untuk proyek ini. Hal ini terjadi secara otomatis selama proses penyerahan. SAP menggunakan teks DCO standar dari Linux Foundation.

Lisensi

Hak Cipta (c) 2024 SAP SE atau perusahaan afiliasi SAP. Semua hak dilindungi undang-undang. Proyek ini dilisensikan di bawah Lisensi Perangkat Lunak Apache, versi 2.0 kecuali sebagaimana dinyatakan lain dalam file LISENSI.