Visual Studio Code uzantısı için Microsoft Döküm Araç Seti ile çalışma

Bu makalede, Visual Studio Code uzantısı için Microsoft Foundry Araç Seti'ni yüklemeyi ve kullanmayı öğrenin. Vs Code içinden projeler oluşturun, Foundry model kataloğundan modelleri dağıtın ve model oyun alanlarıyla etkileşime geçin.

Önkoşullar

• Azure aboneliği. Ücretsiz bir tane oluşturun.
• Visual Studio Code yüklendi.
• Bu makalede yeni bir model dağıtmak için aboneliğinizin kota sınırınızın altında olması gerekir. Kota sınırınıza zaten ulaştıysanız dağıtılan bir sohbet modeline sahip olmanız gerekir.
• Foundry kaynaklarını oluşturmak ve yönetmek için uygun RBAC izinleri. Daha fazla bilgi için bkz. Foundry için rol tabanlı erişim denetimi.

Uzantıyı yükleme

VS Code'da Foundry özelliklerini kullanmak için Visual Studio Code uzantısı için Microsoft Foundry Toolkit'i yükleyin. Visual Studio Code Market'ten veya doğrudan VS Code içinden yükleyin.

Visual Studio Code Market'ten yükleme

Önce VS Code'u açmadan uzantıyı yüklemek için marketi kullanın.

1. Microsoft Foundry Toolkit for Visual Studio Code extension sayfasını açın.
2. Yükle düğmesini seçin.
3. uzantıyı Visual Studio Code yüklemek için istemleri izleyin.
4. Yüklemeden sonra Visual Studio Code açın ve uzantının durum iletilerinden başarıyla yüklendiğini doğrulayın.
5. Foundry Araç Seti simgesi VS Code'un sol tarafındaki birincil gezinti çubuğunda görünür.

Visual Studio Code içinden yükleme

Alternatif olarak, doğrudan VS Code uzantıları görünümünden uzantıyı arayın.

1. VS Code'i açın.

2. Sol bölmeden Uzantılar'ı seçin.

3. Uzantılar bölmesinde sağ üst kısımdan Ayarlar simgesini seçin.

4. VS Code için Foundry Toolkit'i arayın ve seçin.

5. Yükle'yi seçin.

6. Yükleme tamamlandıktan sonra, uzantının yüklendiğini onaylayan bir durum iletisi görüntülenir. Sol gezinti çubuğunda Foundry Araç Seti simgesi görüntülenir.

Azure kaynaklarınıza bağlanma

Uzantıyı yükledikten sonra Azure aboneliğinizde oturum açın ve modellerle, aracılarla ve oyun alanlarıyla çalışmaya başlamak için bir Foundry projesi açın.

Kaynaklarınızda oturum açın

Uzantının Foundry projelerinize ve dağıtılan modellerinize erişebilmesi için Azure aboneliğinizde oturum açın.

1. VS Code gezinti çubuğunda Azure simgesini seçin.

2. Azure'a bağlan... öğesini seçin. Azure Resources görünümünde .

3. Kaynaklar bölümünde Azure aboneliğinizi ve kaynak grubunuzu seçin.

4. Foundry'yi seçin ve projenize sağ tıklayın.

5. Foundry Araç Seti Uzantısında Aç'ı seçin.

   Foundry proje kaynaklarınız uzantı görünümünde, Foundry simgesi ise VS Code gezinti çubuğunda görüntülenir.

Uzantı arabiriminde gezinme

Visual Studio Code uzantısı için Microsoft Foundry Toolkit çalışma alanınızı üç ana bölümde düzenler.

Proje oluşturma

Modellerinizi ve kaynaklarınızı düzenlemek için doğrudan uzantıdan yeni bir Foundry projesi oluşturun.

1. Visual Studio Code uzantı görünümü için Microsoft Döküm Araç Seti'nin My Resources bölümünde + Create Project öğesini seçin.

   Yeni bir kaynak grubu oluşturabilir veya var olan bir kaynak grubunu seçebilirsiniz.

2. Yeni bir kaynak grubu oluşturmak için:

   1. Yeni kaynak grubu oluştur'u seçin ve Enter tuşuna basın.

   2. Yeni kaynak grubu girin metin kutusuna Azure kaynak grubu adını girin ve Enter tuşuna basın.

   3. Kullanılabilir konumlar listesinden kullanmak istediğiniz konumu seçin ve Enter tuşuna basın.

3. Mevcut bir kaynak grubunu kullanmak için:

   • Kullanılabilir kaynak grupları listesinden kullanmak istediğiniz kaynak grubunu seçin ve Enter tuşuna basın.

4. Proje adını girin metin kutusuna Dökümhane projesinin adını girin ve Enter tuşuna basın.

project dağıtımdan sonra, Project başarıyla dağıtıldı iletisini içeren bir açılır pencere görüntülenir.

Modeli yeni oluşturulan projeye dağıtmak için açılır pencerede Model dağıt düğmesini seçin. Bu eylem, dağıtmak istediğiniz modeli seçebileceğiniz Model Kataloğu sayfasını açar.

Varsayılan projeyi değiştirme

Microsoft Foundry Toolkit for Visual Studio Code uzantısında bir proje açtığınızda, bu proje varsayılan projeniz olarak ayarlanır. Varsayılan projenizi değiştirmek için:

1. Foundry projesine sağ tıklayın ve Azure Uzantısı içinde Varsayılan Projeyi Değiştir seçeneğini belirleyin.

2. Kullanılabilir projeler listesinden kullanmak istediğiniz Dökümhane projesini seçin ve Enter tuşuna basın.

Seçili proje artık proje adından sonra Varsayılan değerini görüntüler.

Modellerle çalışma

Visual Studio Code için Microsoft Foundry Araç Seti, doğrudan VS Code'da Foundry model kataloğu modellerini bulmanıza, dağıtmanıza ve bunlarla etkileşim kurmanıza olanak tanır.

Model kataloğuna göz atın

Model kataloğu Microsoft, OpenAI, Meta, DeepSeek ve diğer sağlayıcılardan modellere erişim sağlar. Model kataloğunu çeşitli yollarla açabilirsiniz:

• Komut paletinden Foundry Toolkit: Show model catalog komutunu çalıştırın.
• Visual Studio Code uzantı görünümü için Microsoft Foundry Toolkit'in My Resources bölümünde Models yanındaki plus simgesini seçin.
• Visual Studio Code uzantı görünümü için Microsoft Döküm Aracı Seti'nin Geldirici Araçları bölümündeki Model Kataloğu bağlantısını seçin.

Model kataloğunu komut paletinden açma

Uzantı görünümünde gezinmeden model kataloğunu açmak için komut paletini kullanın.

1. Komut paletini açmak için F1'i seçin.

2. Foundry Toolkit: show model catalog (Model kataloğunu göster) yazın ve Enter tuşuna basın.

3. Model Kataloğu sayfası açılır.

   

4. Sayfanın üst kısmındaki açılır menüleri kullanarak Model Kataloğu'nu Barındıran, Yayıncı, Özellik veya Model Türü gibi ölçütlere göre filtreleyin. İnce ayarlamayı destekleyen modelleri filtrelemek için Fine-Tuning Destek anahtarını seçin.

5. Sayfanın üst orta kısmındaki arama çubuğunu kullanarak belirli bir modeli arayın.

Kaynaklar bölümünden model kataloğunu açma

Visual Studio Code uzantısı için Microsoft Foundry Araç Seti görünümünde, model kataloğunu açmak için Modeller yanındaki plus simgesini seçin.

Araçlar bölümünden model kataloğunu açma

Visual Studio Code uzantısı için Microsoft Döküm Araç Seti görünümünün Geldirici Araçları bölümünde Model Kataloğu bağlantısına çift tıklayın.

Model kataloğundan bir modeli dağıtın

Katalogda bir model buldukktan sonra, uygulamalarınızda kullanabilmek için bu modeli Foundry projenize dağıtın.

1. Seçili model adının yanındaki Dağıt düğmesini seçin.

2. Model dağıtımı sayfası açılır.

3. Dağıtım adını girin metin kutusuna model dağıtım adını girin ve Enter tuşuna basın.

4. "Dağıtım Türü" açılır listesinde Dağıtım türünü seçin.

5. Model sürümü açılır listesinden seçin.

6. (İsteğe bağlı) Dakika başına belirteçler kaydırıcısını kullanarak dakika başına belirteçleri ayarlayın.

7. Sol alt köşedeki Dökümhanede Dağıt düğmesini seçin.

8. Onay iletişim kutusunda Dağıt'ı seçin.

9. Dağıtım tamamlandıktan sonra model, projenizdeki Modeller bölümünün altında dağıtım adına göre görünür.

Dağıtılan modelleri görüntüleme ve yönetme

Projenizdeki tüm dağıtılmış modelleri görmek için Visual Studio Code uzantısı için Microsoft Foundry Toolkit'in Models bölümünü genişletin.

Model kartı bilgilerini görüntüleme

Dağıtılan modeli seçerek aşağıdaki ayrıntıları içeren bir panel açın:

• Dağıtım Bilgileri: Ad, sağlama durumu, dağıtım türü, hız sınırı, sürüm bilgileri, model adı ve model sürümü.
• Uç nokta bilgileri: Hedef URI bağlantısı, kimlik doğrulama türü ve anahtar.
• Yararlı bağlantılar: Yapay zeka uygulaması geliştirme için kod örneği deposu ve öğretici bağlantıları.

Model dağıtım ayarlarını güncelleştirme

Hız sınırları gibi dağıtım ayarlarını güncelleştirmek için:

1. Model kartının sağ üst kısmındaki Düzenle düğmesini seçin.
2. Düzenlenebilir alanları güncelleştirin.
3. Değişiklikleri uygulamak için Kaydet düğmesini seçin.

Model için örnek kod oluşturma

Uygulama geliştirmeyi hızlandırmak için dağıtılan modeliniz için bir başlangıç kodu dosyası oluşturun.

1. Dağıtılan modelinize sağ tıklayın ve Kod dosyasını aç'ı seçin.

2. Tercih edilen SDK'yı seçin açılan listesinde tercih ettiğiniz SDK'yı seçin.

3. Dil seçin açılan listesinde tercih ettiğiniz dili seçin.

4. Kimlik doğrulama yöntemini seçin açılan listesinde tercih ettiğiniz kimlik doğrulama yöntemini seçin.

5. VS Code'da yeni bir sekmede örnek kod dosyası açılır.

Aşağıdaki ekran görüntüsünde, yanıtlar API'sine zaman uyumlu çağrı yapan oluşturulan Python örneği gösterilmektedir:

Oluşturulan Python örnek kod dosyasının VS Code'da zaman uyumlu yanıtlar API çağrısını gösteren ekran görüntüsü.

Oyun alanında modellerle etkileşim kurma

Dağıtılan modelinizle etkileşimli sohbet etmek, ayarları ayarlamak ve sistem yönergelerini değiştirmek için model oyun alanı kullanın.

Oyun parkını açmak için, Visual Studio Code uzantı görünümü için Microsoft Foundry Toolkit'in Developer Tools bölümündeki Model Playground bağlantısına çift tıklayın. Alternatif olarak, dağıtılan modelinize sağ tıklayın ve Oyun alanında aç'ı seçin.

1. Oyun Alanı sayfası açılır.

2. İsteminizi yazın ve çıkışı gözden geçirin.

3. Model dağıtımına program aracılığıyla nasıl erişılacağını görmek için sağ üst köşedeki Kodu görüntüle'yi seçin.

4. Sohbet geçmişinizi görüntülemek için oyun alanının sol üst kısmındaki Geçmiş bağlantısını seçin.

Yaygın sorunları giderme

Visual Studio Code uzantısı için Microsoft Döküm Araç Seti'ni kullanırken sorunlarla karşılaşırsanız aşağıdaki yaygın sorunları denetleyin:

Kaynakları temizleme

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

Modellerinizi silme

1. VS Code gezinti çubuğunda, Visual Studio Code uzantısı için Microsoft Döküm Araç Seti'ni yenileyin. Kaynaklarım bölümünde Modeller alt bölümünü genişletin.

2. Kaldırmak istediğiniz dağıtılan modele sağ tıklayın ve Sil'i seçin.

Azure kaynaklarını silme

Kaynak grubunu ve içindeki tüm kaynakları silmek için:

1. Azure portal açın.
2. Foundry projenizi içeren kaynak grubuna gidin.
3. Kaynak grubunu sil'i seçin ve silme işlemini onaylayın.

Sonraki adımlar

• Foundry modellerini keşfetme
• Foundry ile modelleri dağıtın