RAG kullanarak JavaScript kurumsal sohbet örneğini kullanmaya başlama

  • Makale

Bu makalede JavaScript için Kurumsal sohbet uygulaması örneğinin nasıl dağıtılacağı ve çalıştırılacağı gösterilmektedir. Bu örnek, kiralama özellikleri hakkında yanıtlar almak için Azure AI Search'te JavaScript, Azure OpenAI Hizmeti ve Alma Artırılmış Nesil (RAG) kullanan bir sohbet uygulaması uygular. Kiralama özellikleri sohbet uygulaması, gizlilik ilkesi, hizmet koşulları ve destek dahil olmak üzere markdown dosyalarından (*.md) alınan verilerle gösterilir.

Şimdi başlayın

Bu makaledeki yönergeleri izleyerek şunları yapacaksınız:

  • Azure'a bir sohbet uygulaması dağıtma.
  • Kiralama özellikleri web sitesi bilgileri hakkında yanıtlar alın.
  • Yanıtların davranışını değiştirmek için ayarları değiştirin.

Bu makaleyi tamamladıktan sonra, özel kodunuz ve verilerinizle yeni projeyi değiştirmeye başlayabilirsiniz.

Bu makale, Azure OpenAI Hizmeti ve Azure AI Search kullanarak nasıl sohbet uygulaması oluşturabileceğinizi gösteren makale koleksiyonunun bir parçasıdır. Koleksiyondaki diğer makaleler şunlardır:

Mimariye genel bakış

Aşağıdaki diyagramda sohbet uygulamasının basit bir mimarisi gösterilmiştir:

İstemciden arka uç uygulamasına mimariyi gösteren diyagram.

Sohbet örneği uygulaması Contoso Real Estate adlı kurgusal bir şirket için oluşturulmuş ve akıllı sohbet deneyimi, müşterilerinin ürünlerinin kullanımı hakkında destek soruları sormasına olanak tanır. Örnek veriler hizmet koşullarını, gizlilik ilkesini ve destek kılavuzunu açıklayan bir belge kümesi içerir. Belgeler dağıtım sırasında mimariye alınır

Uygulama, aşağıdakiler dahil olmak üzere birden çok bileşenden yapılır:

  • Arama hizmeti: Arama ve alma özelliklerini sağlayan arka uç hizmeti.
  • Dizin oluşturucu hizmeti: Verileri dizinleyen ve arama dizinlerini oluşturan hizmet.
  • Web uygulaması: Kullanıcı arabirimi sağlayan ve kullanıcı ile arka uç hizmetleri arasındaki etkileşimi düzenleyen ön uç web uygulaması.

Ön uç uygulaması, arama ve belge alımı için Azure hizmetlerini ve bunların tümleştirme akışını gösteren diyagram.

Maliyet

Bu mimarideki kaynakların çoğu temel veya tüketim fiyatlandırma katmanını kullanır. Tüketim fiyatlandırması kullanımı temel alır ve bu da yalnızca kullandığınız kadar ödeme yaptığınız anlamına gelir. Bu makaleyi tamamlamak için ücret tahsil edilecektir ancak çok az olacaktır. Makaleyi tamamladığınızda, ücretlendirmeyi durdurmak için kaynakları silebilirsiniz.

Örnek depoda maliyet hakkında daha fazla bilgi edinin.

Önkoşullar

Bu makaleyi tamamlamak için gereken tüm bağımlılıklarla birlikte bir geliştirme kapsayıcısı ortamı sağlanır. 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:

  1. Azure aboneliği - Ücretsiz bir abonelik oluşturun
  2. Azure hesabı izinleri - Azure Hesabınızın Kullanıcı Erişimi Yönetici istrator veya Sahip gibi Microsoft.Authorization/roleAssignments/write izinlerine sahip olması gerekir.
  3. İstenen Azure aboneliğinde Azure OpenAI'ye erişim izni verilir. Şu anda bu hizmete erişim yalnızca uygulama tarafından sağlanmaktadır. adresinden formu https://aka.ms/oai/accesstamamlayarak Azure OpenAI'ye erişim için başvurabilirsiniz. Sorun yaşıyorsanız bizimle iletişime geçmek için bu depoda bir sorun açın.
  4. GitHub hesabı

Açık geliştirme ortamı

Bu makaleyi tamamlamak için tüm bağımlılıkların yüklü olduğu bir geliştirme ortamıyla hemen başlayın.

GitHub Codespaces, Kullanıcı arabirimi olarak Web için Visual Studio Code ile 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'ı her ay 2 çekirdek örneğiyle 60 saate kadar ücretsiz olarak kullanabilir. Daha fazla bilgi için bkz . GitHub Codespaces aylık dahil depolama ve çekirdek saatler.

  1. GitHub deposunun dalında Azure-Samples/azure-search-openai-javascript yeni bir GitHub Codespace main oluşturmak için işlemi başlatın.

  2. Hem geliştirme ortamının hem de belgelerin aynı anda kullanılabilir olması için aşağıdaki düğmeye sağ tıklayın ve Bağlantıyı yeni pencerelerde aç'ı seçin.

    Bu projeyi GitHub Codespaces'ta açın

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

    Yeni bir kod alanı oluşturmadan önce onay ekranının ekran görüntüsü.

  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 kalan görevler bu geliştirme kapsayıcısı bağlamında gerçekleşir.

Dağıtma ve çalıştırma

Örnek depo, Bir sohbet 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.

Sohbet uygulamasını Azure'a dağıtma

Önemli

Bu bölümde oluşturulan Azure kaynakları, öncelikli olarak Azure AI Search kaynağından anlık maliyetler doğurabilir. Bu kaynaklar, komutu tam olarak yürütülmeden önce kesintiye uğratsanız bile maliyetleri tahakkuk ettirebilir.

  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 ve küçük harfle tutun. Ö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. Uygulama başarıyla dağıtıldıktan sonra terminalde bir URL görüntülenir.

  8. Sohbet uygulamasını tarayıcıda açmak için etiketli Deploying service web URL'yi seçin.

    Tarayıcıdaki sohbet uygulamasının, sohbet girişi için birkaç öneriyi ve soru girmek için sohbet metin kutusunu gösteren ekran görüntüsü.

Markdown dosyalarından yanıt almak için sohbet uygulamasını kullanma

Sohbet uygulaması, markdown dosya kataloğundan kiralama bilgileriyle önceden yüklenir. Kiralama işlemiyle ilgili sorular sormak için sohbet uygulamasını kullanabilirsiniz. Aşağıdaki adımlar, sohbet uygulamasını kullanma işleminde size yol gösterir.

  1. Tarayıcıda, sayfanın en altındaki metin kutusuna Para iadesi ilkesi nedir?'i seçin veya girin.

    Sohbet uygulamasının ilk yanıtının ekran görüntüsü.

  2. Yanıttan Düşünce sürecini göster'i seçin.

    Düşünce işlemini göster seçeneğinin kırmızı kutuda vurgulandığı sohbet uygulamasının ilk yanıtının ekran görüntüsü.

  3. Sağ bölmede, yanıtın nasıl oluşturulduğunu anlamak için sekmeleri kullanın.

    Sekme Açıklama
    Düşünce süreci Bu, sohbetteki etkileşimlerin betiğidir. Sistem istemini (content) ve kullanıcı sorunuzu (content ) görüntüleyebilirsiniz.
    Destekleyici içerik Bu, sorunuzu ve kaynak malzemeyi yanıtlamaya yönelik bilgileri içerir. Kaynak malzeme alıntılarının sayısı Geliştirici ayarlarında not edilir. Varsayılan değer 3'dür.
    Alıntı Bu, alıntıyı içeren özgün sayfayı görüntüler.

  4. İşiniz bittiğinde, sekmelerin üzerindeki X işaretiyle belirtilen gizle düğmesini seçin.

Yanıtların davranışını değiştirmek için sohbet uygulaması ayarlarını kullanma

Sohbet uygulamasının zekası, OpenAI modeline ve modelle etkileşime geçmek için kullanılan ayarlara göre belirlenir.

Sohbet geliştirici ayarlarının ekran görüntüsü

Ayar Açıklama
Geçersiz kılma istemi şablonu Bu, yanıtı oluşturmak için kullanılan istemdir.
Bu kadar çok arama sonucunu alın Bu, yanıtı oluşturmak için kullanılan arama sonuçlarının sayısıdır. Bu kaynakların alıntının Düşünce süreci ve Destekleyici içerik sekmelerinde döndürülmüş olduğunu görebilirsiniz.
Kategoriyi dışla Bu, arama sonuçlarından dışlanan belgelerin kategorisidir.
Alma için semantik dereceleyici kullanma Bu, arama sonuçlarının ilgi düzeyini artırmak için makine öğrenmesini kullanan bir Azure AI Search özelliğidir.
Tüm belgeler yerine sorgu bağlamsal özetleri kullanma Hem hem de Use semantic rankerUse query-contextual summaries işaretlendiğinde, LLM en yüksek dereceli belgelerde tüm pasajlar yerine anahtar geçitlerden ayıklanan başlık kullanır.
İzleme soruları önerin Sohbet uygulamasının yanıta göre takip soruları önermesini sağlayın.
Alma modu Vektörler + Metin , arama sonuçlarının belgelerin metnine ve belgelerin eklemelerine dayandığı anlamına gelir. Vektörler , arama sonuçlarının belgelerin eklemelerine dayandığı anlamına gelir. Metin , arama sonuçlarının belgelerin metnine dayalı olduğu anlamına gelir.
Sohbet tamamlama yanıtlarını akışla aktarın Yanıt için tam yanıt kullanılabilir olana kadar beklemek yerine yanıt akışı yapın.

Aşağıdaki adımlar, ayarları değiştirme işleminde size yol gösterir.

  1. Tarayıcıda Geliştirici Ayarlar sekmesini seçin.

  2. Sorgu bağlamı özetleri yerine kullan onay kutusunu işaretleyin ve aynı soruyu yeniden sorun.

    What happens if the rental doesn't fit the description?

    Sohbet aşağıdaki gibi daha kısa bir yanıtla döndürüldü.

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 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 yetkilendirmeleri hakkında daha fazla bilgi için bkz . GitHub Codespaces aylık dahil depolama ve çekirdek saatler.

  1. GitHub Codespaces panosunda (https://github.com/codespaces ) oturum açın.

  2. GitHub deposundan Azure-Samples/azure-search-openai-javascript alınan şu anda çalışan kod alanlarınızı bulun.

    Durumları ve şablonları da dahil olmak üzere çalışan tüm kod alanları ekran görüntüsü.

  3. Codespace bağlam menüsünü açın ve sil'i seçin.

    Silme seçeneğinin vurgulandığı tek bir kod alanının bağlam menüsünün ekran görüntüsü.

Yardım alın

Bu örnek depo sorun giderme bilgileri sunar.

Verilen sorununuz giderildiyse sorununuzu deponun Sorunları'na kaydedin.

Sonraki adımlar