Microsoft 365 Aracıları Araç Seti ile Visual Studio Code'da JavaScript aracıları oluşturma

Bu makalede, Microsoft 365 Aracılar Araç Seti'ni kullanarak Visual Studio'da yeni bir Aracılar SDK JavaScript projesi oluşturmayı öğreneceksiniz.

Önkoşullar

• Visual Studio Code için Aracılar Araç Seti uzantısını yükleyin.

• Azure AI Foundry portalından bir Azure modeline ihtiyacınız vardır. Modelle ilgili bu verilere ihtiyacınız vardır:

  • İsim
  • Hedef URI
  • Anahtar

  Azure AI Foundry Modellerine model eklemeyi ve yapılandırmayı öğrenin

Yeni proje oluşturma

Aracılar Araç Seti, aracı oluşturmaya başlamanıza yardımcı olacak bir proje şablonu sağlar. Araç setindeki bir şablondan veya Aracılar SDK'sı içindeki örneklerden başlayabilirsiniz.

Uyarı

Aşağıdaki yordam şu anda yalnızca JavaScript ve TypeScript için çalışır. Python için destek planlanıyor.

Microsoft 365 Aracılar Araç Seti'nde Yeni Aracı/Uygulama Oluştur'u seçerek yeni bir aracı projesi oluşturabilirsiniz. Araç setindeki bir şablondan veya Aracılar SDK'sı içindeki örneklerden başlayabilirsiniz. Bu kılavuzda Aracılar Araç Seti'ni kullanmaya başlamayla ilgili bilgiler yer alır.

Aracılar SDK'sı ile aracı oluşturmaya başlamak için ilk menüden Özel Altyapı Aracısı'nı seçin:

Yeni aracı oluşturma

Özel motor aracısı bir seçenek olarak seçildiğinde, kendi yapay zeka hizmetlerinizi eklemek için bir dizi talimatla yönlendirilirsiniz.

1. Seçmeniz gereken iki şablon vardır: Temel Özel Altyapı Aracısı veya Hava Durumu Aracısı. Temel özel altyapı aracısı, önceden oluşturulmuş öğelerin bulunmadığı bir aracıdır. Semantic Kernel veya LangChain gibi bir AI düzenleyici ve bilgilerinizi eklemeniz gerekir.

   

2. Bu örnekte, seçtiğiniz dile bağlı olarak LangChain ve Azure AI Foundry kullanan bir aracı oluşturmak için Weather Agent'ı seçin.

3. Modeliniz için Azure OpenAI'yi seçin.

   

   Azure AI Foundry portalından Anahtarınız, Hedef URI'niz ve Azure modelinizin adı istenir. Bu bilgi parçalarını Dökümhane portalındaki Varlıklarım ve Modellerim ve uç noktalar altında bulabilirsiniz.

4. Anahtar ile başlayarak ayrıntıları girin:

   

5. JavaScript veya TypeScript'i seçin, Varsayılan klasörü seçin ve proje kök klasörünüzü varsayılan konumda depolamak için bir Uygulama Adı girin.

   Yeni projeniz açılır.

   

6. Visual Studio Code'daki araç çubuğunda Microsoft 365 logosunu seçerek uzantıyı kullanarak oturum açtığınızı onaylayın. Bağlanmak istediğiniz kiracıda oturum açtığınızdan emin olun.

   

Agents Playground'da ajanın hatalarını ayıklayın ve test edin.

Araç setinde bulunan yeni Microsoft 365 Agent Playground ile kodunuzun hatalarını ayıklayabilir ve test edebilirsiniz. Oyun alanı, tam dağıtım döngüsünden geçmek zorunda kalmadan kodunuzun hatalarını kolayca ayıklamanıza yardımcı olur.

1. Microsoft 365 Aracıları Deneme Alanında Hata Ayıkla seçeneğini belirleyin.

Deneme alanını seçtikten sonra yerel makinenizin gerekli bileşenlerle hazırlanması için kısa bir süre bekleyin. Hazırlık birkaç dakika sürer.

1. Dağıtımı beklerken, kodun bulunduğu klasörü kontrol edin ve kodu inceleyerek alıştırma yapın.

   

2. Hata ayıklama ve test için oyun alanı yüklemeyi tamamladıktan sonra bir tarayıcı açılır ve oyun alanı kullanarak temsilcinizle etkileşime geçmek için hazırsınız demektir. Kılavuzu izlediyseniz ve önceden oluşturulmuş şablonu LangChain ve Azure AI Foundry ile kullandıysanız" "Yarın {konumunuz} konumunda hava durumu nedir?" sorusunu sorabilirsiniz. Aracı, seçtiğiniz yapay zeka hizmetini kullanarak hava durumuyla uyarlamalı bir kartla yanıt verir.

   

   

Microsoft 365 Copilot'ta ajanın hata ayıklama ve test etme

Agents Playground'da test işlemini yerel olarak tamamladığınızda Azure Bot Hizmeti'ne dağıtabilir ve Microsoft 365 Copilot kanalı için yapılandırabilirsiniz. Microsoft 365 Copilot erişimi olan bir kiracıda oturum açtığınızdan emin olun.

1. Microsoft 365 Copilot kullanarak hata ayıklamak için hata ayıklama hedefini Copilot olarak değiştirin. Test etmek için F5 tuşuna basın veya Hata Ayıklama'yı seçin. Aracıyı Microsoft 365'in kullanımına açmak birkaç dakika sürer. Araç seti arka planda Azure Bot Hizmeti'nde bir Uygulama Kaydı ve Bot Hizmeti kaydı oluşturur ve projenizi bir bildirimle birlikte kiracınıza dağıtır.

   

2. Bunu yaptıktan sonra Microsoft 365 Copilot yüklemesini görmeniz ve doğrudan Microsoft 365 Copilot'ta soru sorabilmeniz, kesme noktaları ekleyebilmeniz ve hata ayıklayabilmeniz gerekir:

   

Özet

Artık başarılı bir şekilde tamamladınız:

• Aracılar Araç Seti'ni kullanarak yeni bir Microsoft 365 Aracıları projesi ve aracısı başlatıldı
• Microsoft 365 Agents Playground kullanarak aracıyı yerel olarak test etti
• Doğrudan Microsoft 365 Kanalı'nda hata ayıklama için aracı dağıtıldı