JavaScript'te Yardımcılar ve işlev çağrısı ile Azure OpenAI'yi kullanmaya başlama

Bu makale, sunucusuz Azure OpenAI Yardımcısı Hızlı Başlangıcı'nı nasıl dağıtacağınızı ve çalıştıracağınızı gösterir. Bu örnek, JavaScript, işlev çağırma kullanan Azure OpenAI Service asistanları ve Azure İşlevleri kullanarak bir asistan uygulamasının nasıl geliştirileceğini gösterir.

Mimariye genel bakış

Azure OpenAI Yardımcıları, özel yönergelerle ihtiyaçlarınıza göre uyarlanmış ve kod yorumlayıcı ve özel işlevler gibi gelişmiş araçlarla geliştirilmiş yapay zeka yardımcıları oluşturmanıza olanak tanır. Bu makalede, Yardımcılar API'sini kullanmaya başlamaya ilişkin ayrıntılı bir kılavuz sağlıyoruz.

Bu uygulama iki ana bileşen etrafında derlenmiştir:

• Düz CSS ve JavaScript dosyalarına sahip, Azure Static Web Apps üzerinde barındırılan basit bir HTML sayfası.

• Azure İşlevleri ve OpenAI JavaScript SDK kullanılarak oluşturulmuş sunucusuz bir API. Sunucusuz uygulama, işlev çağrısı dahil olmak üzere yardımcılar tanımını OpenAI uç noktasına gönderir. Uç nokta, izleme işlev çağrısı ve bu çağrıyı tamamlamak için gereken parametrelerle yanıt verir.

  • Örnekteki işlev çağrısı, Azure İşlevi'ne gönderilen hisse senedi simgesine göre rastgele bir borsa kodu değeri üreterek bir API çağrısını simüle eder. Bu benzetimi çözümünüzde bir uzak API ile değiştirebilirsiniz.

  

Önkoşullar

Bu makaleyi tamamlamak için gereken tüm bağımlılıkları içeren bir geliştirme kapsayıcısı ortamı mevcuttur. Geliştirme kapsayıcısını GitHub Codespaces'ta (tarayıcıda) veya Visual Studio Code'u kullanarak yerel olarak çalıştırabilirsiniz.

Bu makaleyi kullanmak için aşağıdaki önkoşullara ihtiyacınız vardır:

Codespaces (önerilen)

1. Bir Azure aboneliği - Ücretsiz bir tane oluşturun
2. Azure hesabı izinleri - Azure hesabınızın, Kullanıcı Erişimi Yöneticisi veya Sahip gibi Microsoft.Authorization/roleAssignments/write izinlerine sahip olması gerekir.
3. GitHub hesabı.

Visual Studio Code

1. Bir Azure aboneliği - Ücretsiz oluşturun
2. Azure hesabı izinleri - Azure hesabınızın, Kullanıcı Erişimi Yöneticisi veya Sahip gibi Microsoft.Authorization/roleAssignments/write izinlerine sahip olması gerekir.
3. Azure Geliştirici CLI
4. Docker Desktop - Docker Desktop zaten çalışmıyorsa başlatın
5. Git
6. Visual Studio Code
7. Dev Konteyner Uzantısı

Açık geliştirme ortamı

Bu makaleyi tamamlamak için gerekli tüm bağımlılıkları içeren önceden yapılandırılmış bir geliştirme ortamı dağıtmak için aşağıdaki yönergeleri kullanın.

GitHub Codespaces (önerilen)

GitHub Codespaces, kullanıcı arabirimi olarak Visual Studio Code for the Web kullanarak GitHub tarafından yönetilen bir geliştirme kapsayıcısı çalıştırır. En basit geliştirme ortamı için GitHub Codespaces'ı kullanarak bu makaleyi tamamlamak için doğru geliştirici araçlarını ve bağımlılıklarını önceden yüklemiş olursunuz.

Önemli

Tüm GitHub hesapları Codespaces'ı iki çekirdek örneğiyle her ay 60 saate kadar ücretsiz olarak kullanabilir. Daha fazla bilgi için GitHub Codespaces aylık olarak dahil edilen depolama alanı ve çekirdek saatleri bölümüne bakın.

1. Azure-Samples/azure-openai-assistant-javascript GitHub deposunun main dalında yeni bir GitHub Codespace oluşturma işlemini başlatın.

2. Aşağıdaki düğmeye sağ tıklayın ve yeni pencerede bağlantıyı aç seçeneğini seçerek hem geliştirme ortamı hem de belgeleri aynı anda kullanın.

   

3. Codespace oluştur sayfasında codespace yapılandırma ayarlarını gözden geçirin, ardından Yeni kod alanı oluştur'u seçin

4. Kod alanının başlamasını bekleyin. Bu başlatma işlemi birkaç dakika sürebilir.

5. Ekranın alt kısmındaki terminalde Azure Geliştirici CLI'sı ile Azure'da oturum açın.

   azd auth login
   

6. Kodu terminalden kopyalayın ve bir tarayıcıya yapıştırın. Azure hesabınızla kimlik doğrulaması yapmak için yönergeleri izleyin.

7. Bu makaledeki geri kalan görevler, bu geliştirme kapsayıcısı içinde gerçekleştirilir.

Visual Studio Code

Visual Studio Code için Dev Containers uzantısı, Docker'ın yerel makinenizde yüklü olmasını gerektirir. Uzantı, bu makaledeki adımları tamamlamak için gereken doğru geliştirici araçları ve bağımlılıkları önceden yüklenmiş Docker hostunu kullanarak geliştirme kapsayıcısını yerel olarak barındırır.

1. Örnek depoyu, bu Azure-Samples/azure-openai-assistant-javascript bağlantısını seçerek çatallayın.

2. Çatal deponuzu kopyalayın. <github-username> öğesini GitHub hesap adınızla değiştirin.

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

3. Yeni klasörde Visual Studio Code'yu açın.

   cd azure-openai-assistant-javascript
   code .
   

4. Visual Studio Code’da Geliştirme Kapsayıcıları uzantısının yüklü olduğundan emin olun.

5. Düzenleyicide yeni bir terminal açın.

   İpucu

   Ana menüyü kullanarak Terminal menüsü seçeneğine gidin ve Yeni Terminal seçeneğini belirleyin.

   

6. Azure Geliştirici CLI'sı ile Azure'da oturum açın.

   azd auth login
   

   Kodu terminalden kopyalayın ve bir tarayıcıya yapıştırın. Azure hesabınızla kimlik doğrulaması yapmak için yönergeleri izleyin.

7. Komut Paleti'ni açın, Dev Containers komutlarını arayın ve ardından Dev Containers: Kapsayıcıda Yeniden Aç seçeneğini belirleyin.

   İpucu

   Visual Studio Code, geliştirme kapsayıcısı içindeki mevcut klasörü otomatik olarak yeniden açmanızı isteyebilir. Bu eylem, geçerli çalışma alanını bir kapsayıcıda yeniden açmak için komut paletini kullanmaya işlevsel olarak eşdeğerdir.

8. Terminal penceresini tekrar açın (Ctrl + `) ve açık bırakın.

9. Bu projedeki kalan alıştırmalar bu geliştirme konteyneri içinde gerçekleşir.

Dağıt ve çalıştır

Örnek depo, bir işlev uygulamasını Azure'a dağıtmak için ihtiyacınız olan tüm kod ve yapılandırma dosyalarını içerir. Aşağıdaki adımlar, örneği Azure'a dağıtma işleminde size yol gösterir.

Yardımcılar uygulamasını Azure'a dağıtma

Önemli

Bu bölümde oluşturulan Azure kaynakları, öncelikli olarak Azure Yapay Zeka Arama kaynağından anlık maliyetler doğurabilir. Bu kaynaklar, komutu tamamlanmadan kesintiye uğratsanız bile maliyet oluşturabilir.

1. Azure kaynaklarını sağlamak ve kaynak kodu dağıtmak için aşağıdaki Azure Geliştirici CLI komutunu çalıştırın:

   azd up
   

2. Bir ortam adı girmeniz istendiğinde, kısa tutun ve küçük harflerle yazın. Örneğin, myenv. Kaynak grubu adının bir parçası olarak kullanılır.

3. İstendiğinde, içinde kaynakları oluşturmak için bir abonelik seçin.

4. İlk kez bir konum seçmeniz istendiğinde, size yakın bir konum seçin. Bu konum, barındırma dahil olmak üzere kaynakların çoğu için kullanılır.

5. OpenAI modeli için bir konum istenirse size yakın bir konum seçin. İlk konumunuzla aynı konum kullanılabiliyorsa bunu seçin.

6. Uygulama dağıtılana kadar bekleyin. Dağıtımın tamamlanması 5-10 dakika sürebilir.

7. Uygulamayı başarıyla dağıttığınızda, terminalde bir URL'nin görüntülendiğini görürsünüz.

8. Yardımcı uygulamayı tarayıcıda açmak için Deploying service web etiketli URL’yi seçin.

Yardımcı uygulamasını kullanma

Borsa fiyatını öğrenmek için MSFT asistan uygulamasını kullanın. Aşağıdaki adımlar yardımcı uygulamasını kullanma işleminde size yol gösterir. Yardımcı size yanıtları e-postayla gönderebilir. E-posta gönderme özelliği yapılandırılmadığından bu yönergeyi kullanmamak için istemi değiştirin.

1. Tarayıcıda aşağıdaki istemi kopyalayıp yapıştırın:

   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. Çalıştır düğmesini seçin. Sonuçlarınız aşağıdaki yanıta benzer görünmelidir.

   

Kaynakları temizleme

Azure kaynaklarını temizleme

Bu makalede oluşturulan Azure kaynakları Azure aboneliğinize faturalandırılır. Gelecekte bu kaynaklara ihtiyaç duymayı beklemiyorsanız, daha fazla ücret ödememek için bunları silin.

Azure kaynaklarını silmek ve kaynak kodu kaldırmak için aşağıdaki Azure Geliştirici CLI komutunu çalıştırın:

azd down --purge

GitHub Codespaces'i temizleme

GitHub Codespaces

GitHub Codespaces ortamını silmek, hesabınız için elde ettiğiniz ücretsiz çekirdek başına saat yetkilendirmesi miktarını en üst düzeye çıkarmanızı sağlar.

Önemli

GitHub hesabınızın hakları hakkında daha fazla bilgi için bkz. GitHub Codespaces aylık olarak dahil edilen depolama alanı ve çekirdek saati.

1. GitHub Codespaces panosundaoturum açın.

2. Kaynağı Azure-Samples/azure-openai-assistant-javascript GitHub deposu olan şu anda çalışan Codespaces’lerinizi bulun.

   

3. codespace'in bağlam menüsünü açın, ... ve ardından Delete seçeneğini belirleyin.

Visual Studio Code

Yerel ortamınızı temizlemeniz şart değildir, ancak çalışan geliştirme kapsayıcısını durdurabilir ve Visual Studio Code’u yeniden yerel bir çalışma alanı bağlamında çalıştırmaya dönebilirsiniz.

1. Komut Paleti'ni açın, Dev Containers komutlarını arayın ve ardından Dev Containers: Reopen Folder Locally seçeneğini seçin.

   

İpucu

Visual Studio Code çalışan geliştirme kapsayıcısını durdurduktan sonra kapsayıcı docker'da durdurulmuş durumda kalır. Yerel makinenizde daha fazla alan açmak için docker'dan kapsayıcı örneğini, kapsayıcı görüntüsünü ve birimleri silebilirsiniz.

Yardım alın

Bu örnek depo, sorun giderme bilgileri sağlar.

Sorununuz ele alınmadıysa, sorununuzu deponun Sorunlar bölümüne kaydedin.

İlgili içerik

• Azure OpenAI Yardımcıları API'si nedir?
• JavaScript'te bir sohbet uygulamasında yanıtları değerlendirmeye başlayın