Cara mulai menggunakan Azure AI SDK

  • Artikel

Catatan

Azure AI Studio saat ini dalam pratinjau publik. Pratinjau ini disediakan tanpa perjanjian tingkat layanan, dan kami tidak merekomendasikannya untuk beban kerja produksi. Fitur tertentu mungkin tidak didukung atau mungkin memiliki kemampuan terbatas. Untuk mengetahui informasi selengkapnya, lihat Ketentuan Penggunaan Tambahan untuk Pratinjau Microsoft Azure.

Azure AI SDK adalah keluarga paket yang menyediakan akses ke layanan Azure AI seperti Azure OpenAI.

Dalam artikel ini, Anda akan mempelajari cara memulai Azure AI SDK untuk aplikasi AI generatif. Anda dapat:

Menginstal SDK ke lingkungan pengembangan yang ada

Pasang Python

Pertama, instal Python 3.10 atau yang lebih tinggi, buat lingkungan virtual atau lingkungan conda, dan instal paket Anda ke lingkungan virtual atau conda tersebut. JANGAN instal SDK AI Generatif ke dalam penginstalan python global Anda. Anda harus selalu menggunakan lingkungan virtual atau conda saat menginstal paket python, jika tidak, Anda dapat memutuskan penginstalan sistem Python Anda.

Menginstal Python melalui lingkungan virtual

Ikuti instruksi dalam Tutorial Python Visual Studio Code untuk cara term mudah menginstal Python dan membuat lingkungan virtual pada sistem operasi Anda.

Jika Anda sudah menginstal Python 3.10 atau yang lebih tinggi, Anda dapat membuat lingkungan virtual menggunakan perintah berikut:

py -3 -m venv .venv
.venv\scripts\activate

Menginstal Python melalui lingkungan Conda

Pertama, instal miniconda dengan mengikuti instruksi di sini.

Kemudian, buat dan aktifkan lingkungan Python 3.10 baru:

conda create --name ai_env python=3.10
conda activate ai_env

Menginstal Azure AI Generative SDK

Saat ini untuk menggunakan paket generatif Azure AI SDK, Anda menginstal sekumpulan paket seperti yang dijelaskan di bagian ini.

Perhatian

Disarankan untuk menginstal SDK baik di lingkungan virtual, lingkungan conda, atau kontainer docker. Jika Anda tidak melakukan ini, Anda mungkin mengalami masalah dependensi dengan paket yang telah Anda instal pada sistem Anda. Untuk informasi selengkapnya, lihat Menginstal Python.

Opsi 1: Instal melalui pip

pip install azure-ai-generative[index,evaluate,promptflow]
pip install azure-identity

Opsi 2: Instal melalui requirements.txt

  1. Buat file teks baru bernama requirements.txt di direktori proyek Anda.

  2. Salin konten dari repositori requirements.txt Azure/aistudio-copilot-sample di GitHub ke dalam file Anda requirements.txt .

  3. Masukkan perintah berikut untuk menginstal paket dari requirements.txt file:

    pip install -r requirements.txt

Azure AI SDK sekarang harus diinstal dan siap digunakan!

Menggunakan Azure AI SDK tanpa menginstalnya

Anda dapat menginstal Azure AI SDK secara lokal seperti yang dijelaskan sebelumnya, atau menjalankannya melalui browser internet atau kontainer Docker.

Opsi 1: Menggunakan Visual Studio Code (web) di Azure AI Studio

VISUAL Code (web) di Azure AI Studio membuat dan menjalankan kontainer pengembangan pada instans komputasi. Untuk mulai menggunakan pendekatan ini, ikuti instruksi dalam Bekerja dengan proyek Azure AI di Visual Studio Code.

Lingkungan pengembangan bawaan kami didasarkan pada kontainer docker yang memiliki Azure AI Generative SDK, Azure AI CLI, SDK alur perintah, dan alat lainnya. Ini dikonfigurasi untuk menjalankan Visual Studio Code dari jarak jauh di dalam kontainer. Kontainer docker didefinisikan dalam Dockerfile ini, dan didasarkan pada Gambar Kontainer Pengembangan Python 3.10 Microsoft.

OPSI 2: Kontainer Dev Visual Studio Code

Anda dapat menjalankan Azure AI SDK dalam kontainer Docker menggunakan Kontainer Dev Visual Studio Code:

  1. Ikuti instruksi penginstalan untuk Kontainer Dev Visual Studio Code.
  2. Kloning repositori aistudio-copilot-sample dan buka dengan Visual Studio Code:
    git clone https://github.com/azure/aistudio-copilot-sample
code aistudio-copilot-sample
  3. Pilih tombol Buka kembali di Kontainer Dev. Jika tidak muncul, buka palet perintah (Ctrl+Shift+P di Windows dan Linux, Cmd+Shift+P di Mac) dan jalankan Dev Containers: Reopen in Container perintah .

OPSI 3: Ruang Kode GitHub

Sampel kode Azure AI di GitHub Codespaces membantu Anda memulai dengan cepat tanpa harus menginstal apa pun secara lokal.

Open in GitHub Codespaces

Langkah berikutnya