Mulai menggunakan Azure OpenAI dengan Asisten dan panggilan fungsi di JavaScript

Artikel ini menunjukkan cara menyebarkan dan menjalankan Panduan Mulai Cepat Asisten Azure OpenAI serverless. Sampel ini mengimplementasikan aplikasi asisten menggunakan JavaScript, asisten Layanan Azure OpenAI dengan panggilan fungsi, dan Azure Functions.

Ikhtisar arsitektur

Asisten Azure OpenAI memungkinkan Anda membuat asisten AI yang disesuaikan dengan kebutuhan Anda melalui instruksi kustom dan ditambah oleh alat tingkat lanjut seperti penerjemah kode, dan fungsi kustom. Dalam artikel ini, kami menyediakan panduan mendalam untuk memulai dengan Assistants API.

Aplikasi ini dibangun di sekitar dua komponen utama:

• Halaman HTML sederhana dengan file CSS dan JavaScript murni, yang dihosting di Azure Static Web Apps.

• API tanpa server yang dibuat dengan Azure Functions dan menggunakan OpenAI JavaScript SDK. Aplikasi tanpa server mengirimkan definisi asisten termasuk panggilan fungsi ke titik akhir OpenAI. Titik akhir merespons dengan panggilan fungsi tindak lanjut dan parameter yang diperlukan untuk menyelesaikan panggilan tersebut.

  • Pemanggilan fungsi pada sampel mensimulasikan panggilan API dengan menghasilkan nilai ticker saham acak berdasarkan simbol saham yang diteruskan ke Azure Function. Simulasi ini dapat diganti dengan API jarak jauh dalam solusi Anda.

  

Prasyarat

Tersedia lingkungan kontainer pengembangan dengan semua dependensi yang diperlukan untuk menyelesaikan artikel ini. Anda dapat menjalankan kontainer pengembangan di GitHub Codespaces (di browser) atau secara lokal menggunakan Visual Studio Code.

Untuk menggunakan artikel ini, Anda memerlukan prasyarat berikut:

Codespaces (disarankan)

1. Langganan Azure - Buat langganan secara gratis
2. Izin akun Azure - Akun Azure Anda harus memiliki izin Microsoft.Authorization/roleAssignments/write, seperti Administrator Akses Pengguna atau Pemilik.
3. Akun GitHub.

Visual Studio Code

1. Langganan Azure - Buat langganan secara gratis
2. Izin akun Azure - Akun Azure Anda harus memiliki izin Microsoft.Authorization/roleAssignments/write, seperti Administrator Akses Pengguna atau Pemilik.
3. Azure Developer CLI
4. Docker Desktop - jalankan Docker Desktop jika belum berjalan
5. Git
6. Visual Studio Code
7. Ekstensi Dev Container

Membuka lingkungan pengembangan

Gunakan instruksi berikut untuk menyebarkan lingkungan pengembangan yang telah dikonfigurasi sebelumnya yang berisi semua dependensi yang diperlukan untuk menyelesaikan artikel ini.

GitHub Codespaces (disarankan)

GitHub Codespaces menjalankan kontainer pengembangan yang dikelola oleh GitHub dengan Visual Studio Code for the Web sebagai antarmukanya. Untuk lingkungan pengembangan yang paling mudah, gunakan GitHub Codespaces sehingga Anda memiliki alat dan dependensi pengembang yang benar yang telah diinstal sebelumnya untuk menyelesaikan artikel ini.

Penting

Semua akun GitHub dapat menggunakan Codespace hingga 60 jam gratis setiap bulan dengan dua instans inti. Untuk informasi selengkapnya, lihat penyimpanan dan jam inti bulanan yang disertakan untuk GitHub Codespaces.

1. Mulai proses untuk membuat GitHub Codespace baru pada cabang main dari repositori GitHub Azure-Samples/azure-openai-assistant-javascript.

2. Klik kanan pada tombol berikut, dan pilih tautan buka di jendela baru agar lingkungan pengembangan dan dokumentasi tersedia secara bersamaan.

   

3. Pada halaman Buat codespace , tinjau pengaturan konfigurasi codespace, lalu pilih Buat codespace baru

4. Tunggu hingga Codespace berjalan. Proses startup ini dapat memakan waktu beberapa menit.

5. Masuk ke Azure dengan Azure Developer CLI di terminal di bagian bawah layar.

   azd auth login
   

6. Salin kode dari terminal lalu tempelkan ke browser. Ikuti instruksi untuk mengautentikasi dengan akun Azure Anda.

7. Tugas yang tersisa dalam artikel ini berlangsung dalam konteks kontainer pengembangan ini.

Visual Studio Code

Ekstensi Dev Containers untuk Visual Studio Code mengharuskan Docker terinstal di komputer lokal Anda. Ekstensi menghosting kontainer pengembangan secara lokal menggunakan host Docker dengan alat pengembang dan dependensi yang benar yang telah diinstal sebelumnya untuk menyelesaikan artikel ini.

1. Fork repositori sampel dengan memilih tautan Azure-Samples/azure-openai-assistant-javascript ini.

2. Klon repositori fork Anda. Ganti <github-username> dengan nama akun GitHub Anda.

   git clone https://github.com/<github-username>/azure-openai-assistant-javascript
   

3. Buka Visual Studio Code di folder baru.

   cd azure-openai-assistant-javascript
   code .
   

4. Pastikan Anda telah memasang ekstensi Dev Containers di Visual Studio Code.

5. Buka terminal baru di editor.

   Petunjuk / Saran

   Gunakan menu utama untuk menavigasi ke opsi menu Terminal lalu pilih opsi Terminal Baru .

   

6. Masuk ke Azure dengan Azure Developer CLI.

   azd auth login
   

   Salin kode dari terminal lalu tempelkan ke browser. Ikuti instruksi untuk mengautentikasi dengan akun Azure Anda.

7. Buka Palet Perintah, cari perintah Dev Containers, lalu pilih Dev Containers: Buka Ulang di Kontainer.

   Petunjuk / Saran

   Visual Studio Code mungkin secara otomatis meminta Anda untuk membuka kembali folder yang ada dalam kontainer pengembangan. Tindakan ini secara fungsional setara dengan menggunakan palet perintah untuk membuka kembali ruang kerja saat ini dalam kontainer.

8. Buka kembali jendela Terminal (Ctrl + `) dan tetap biarkan terbuka.

9. Latihan yang tersisa dalam proyek ini berlangsung dalam konteks kontainer pengembangan ini.

Terapkan dan jalankan

Repositori sampel berisi semua file kode dan konfigurasi yang Anda butuhkan untuk menyebarkan aplikasi fungsi ke Azure. Langkah-langkah berikut memandu Anda melalui proses menerapkan contoh ke Azure.

Menyebarkan aplikasi asisten ke Azure

Penting

Sumber daya Azure yang dibuat di bagian ini dikenakan biaya langsung, terutama dari sumber daya Pencarian Azure AI. Sumber daya ini mungkin mengakumulasi biaya bahkan jika Anda mengganggu perintah sebelum selesai.

1. Jalankan perintah Azure Developer CLI berikut untuk menyediakan sumber daya Azure dan menyebarkan kode sumber:

   azd up
   

2. Saat Anda diminta untuk memasukkan nama lingkungan, tetap pendekkan dan huruf kecil. Contohnya, myenv. Ini digunakan sebagai bagian dari nama grup sumber daya.

3. Saat diminta, pilih langganan untuk membuat sumber daya di dalamnya.

4. Saat Anda diminta untuk memilih lokasi untuk pertama kalinya, pilih lokasi di dekat Anda. Lokasi ini digunakan untuk sebagian besar sumber daya termasuk hosting.

5. Jika Anda dimintai lokasi untuk model OpenAI, pilih lokasi yang ada di dekat Anda. Jika lokasi yang sama tersedia sebagai lokasi pertama Anda, pilih lokasi tersebut.

6. Tunggu hingga aplikasi di-deploy. Mungkin perlu waktu 5-10 menit agar penyebaran selesai.

7. Setelah berhasil menyebarkan aplikasi, Anda akan melihat URL yang ditampilkan di terminal.

8. Pilih URL yang berlabel Deploying service web untuk membuka aplikasi asisten di browser.

Menggunakan aplikasi asisten

Gunakan aplikasi asisten untuk mendapatkan harga pasar saham .MSFT Langkah-langkah berikut memandu Anda melalui proses penggunaan aplikasi asisten. Asisten dapat mengirimi Anda jawaban dalam email. Karena fitur pengiriman email tidak dikonfigurasi, ubah perintah untuk tidak menggunakan instruksi tersebut.

1. Di peramban, salin dan tempelkan prompt berikut:

   Based on the latest financial data and current stock market trends, can you provide a detailed analysis of Microsoft's current state? Please include insights into their recent performance, market position, and future outlook. Additionally, retrieve and include the latest closing price of Microsoft's stock using its ticker symbol (MSFT).
   

2. Pilih tombol Jalankan. Hasil Anda akan terlihat mirip dengan respons berikut.

   

Membersihkan sumber daya

Membersihkan sumber daya Azure

Sumber daya Azure yang dibuat dalam artikel ini ditagihkan ke langganan Azure Anda. Jika Anda tidak mengharapkan untuk membutuhkan sumber daya ini di masa mendatang, hapus sumber daya tersebut untuk menghindari dikenakan lebih banyak biaya.

Jalankan perintah Azure Developer CLI berikut untuk menghapus sumber daya Azure dan menghapus kode sumber:

azd down --purge

Bersihkan GitHub Codespaces

GitHub Codespace

Menghapus lingkungan GitHub Codespaces memastikan bahwa Anda dapat memaksimalkan jumlah pemberian izin per jam inti gratis yang Anda dapatkan untuk akun Anda.

Penting

Untuk informasi selengkapnya tentang hak akun GitHub Anda, lihat penyimpanan dan jam inti bulanan yang disertakan untuk GitHub Codespaces.

1. Masuklah ke dasbor GitHub Codespaces.

2. Temukan Codespaces yang sedang berjalan yang berasal dari repositori GitHub Azure-Samples/azure-openai-assistant-javascript.

   

3. Buka menu konteks, ..., pada codespace, lalu pilih Hapus.

Visual Studio Code

Anda tidak perlu membersihkan lingkungan lokal, tetapi Anda dapat menghentikan kontainer pengembangan yang sedang berjalan dan kembali menjalankan Visual Studio Code dalam konteks ruang kerja lokal.

1. Buka Command Palette, cari perintah Dev Containers, lalu pilih Dev Containers: Buka Ulang Folder Secara Lokal.

   

Petunjuk / Saran

Setelah Visual Studio Code menghentikan kontainer pengembangan yang sedang berjalan, kontainer masih ada di Docker dalam status berhenti. Anda dapat menghapus instans kontainer, gambar kontainer, dan volume dari Docker untuk mengosongkan lebih banyak ruang di komputer lokal Anda.

Dapatkan bantuan

Repositori sampel ini menyediakan informasi tentang pemecahan masalah.

Jika masalah Anda belum ditangani, laporkan masalah Anda ke Issues repositori.

Konten terkait

• Apa itu Azure OpenAI Assistants API?