Visual Studio Code için Microsoft Foundry uzantısıyla çalışma

Bu makalede Visual Studio Code için Microsoft Foundry uzantısını 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.

Önemli

Bu makalede işaretlenen (önizleme) öğeler şu anda genel önizleme aşamasındadır. Bu önizleme, hizmet düzeyi sözleşmesi olmadan sağlanır ve üretim iş yükleri için önerilmez. Bazı özellikler desteklenmiyor olabileceği gibi özellikleri sınırlandırılmış da olabilir. Daha fazla bilgi için bkz. Microsoft Azure Önizlemeleri için Ek Kullanım Koşulları.

Ö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 için Foundry uzantısını 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.

Visual Studio Code için Foundry uzantısı sayfasını açın.
Yükle düğmesini seçin.
Visual Studio Code'da uzantıyı yüklemek için istemleri izleyin.
Yüklemeden sonra Visual Studio Code'u açın ve uzantının durum iletilerinden başarıyla yüklendiğini doğrulayın.
Foundry 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.

VS Code'i açın.
Sol bölmeden Uzantılar'ı seçin.
Uzantılar bölmesinin sağ üst köşesinden Ayarlar simgesini seçin.
Dökümhane'yi ara ve seç.
Yükle'yi seçin.
Yükleme tamamlandıktan sonra, uzantının yüklendiğini onaylayan bir durum iletisi görüntülenir. Sol gezinti çubuğunda Foundry simgesi görünür.

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.

Uyarı

Uzantıda kullanılabilen özelliklerin tam listesi için Komut Paleti'ni kullanın. Komut paletini açmak ve Foundry'de arama yapmak için F1'i seçin. Aşağıdaki ekran görüntüsünde kullanılabilir komutlardan bazıları gösterilmektedir.

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

VS Code gezinti çubuğunda Azure simgesini seçin.
Azure Kaynakları görünümünde Azure'da oturum aç... öğesini seçin.
Kaynaklar bölümünde Azure aboneliğinizi ve kaynak grubunuzu seçin.
Foundry'i seçin ve projenize sağ tıklayın.
Foundry 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

Foundry uzantısı çalışma alanınızı üç ana bölümde düzenler.

Kaynaklar, Araçlar ve Yardım ve Geri Bildirim bölümlerini gösteren Foundry uzantısı arabiriminin ekran görüntüsü.

Bölüm	Ne içerir	Kullanılması gereken durumlar
Kaynaklar	Foundry projeniz için dağıtılan modeller, deklaratif aracılar, barındırılan aracılar, bağlantılar ve vektör depoları.	Proje kaynaklarınızı görüntüleyin ve yönetin.
Tools	Model Kataloğu, Model Oyun Alanı, Temsilci Oyun Alanları (uzak ve yerel), Yerel Görselleştirici ve Barındırılan Temsilcileri Dağıtma.	Yeni modeller dağıtın, istemleri test edin ve aracılarla etkileşim kurun.
Yardım ve Geri Bildirim	Belgeler, GitHub deposu, Microsoft Gizlilik Bildirimi ve topluluk bağlantıları.	Yardım alın veya geri bildirim sağlayın.

Proje oluştur

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

Dökümhane uzantısı görünümünün Kaynaklar bölümünde Kaynaklar'ın yanındaki artı simgesini seçin.

Yeni bir kaynak grubu oluşturabilir veya var olan bir kaynak grubunu seçebilirsiniz.
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.
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.
Dökümhane proje adını Proje adı metin kutusuna yazın ve Enter tuşuna basın.

Proje dağıtımından 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

Bir projeyi Foundry uzantısında açtığınızda, bu proje varsayılan projeniz olarak ayarlanır. Varsayılan projenizi değiştirmek için:

Foundry projesine sağ tıklayın ve Azure Uzantısında Varsayılan Projeyi Değiştir seçeneğini belirleyin.
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.

Tavsiye

Proje uç noktasına veya proje API anahtarına erişmek için proje adınıza sağ tıklayın.

Modellerle çalışma

Foundry uzantısı, doğrudan VS Code'da Foundry model kataloğundaki modelleri 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 gelen modellere erişim sağlar. Model kataloğunu çeşitli yollarla açabilirsiniz:

Komut paletinden Foundry: Open Model Catalog komutunu çalıştırın.
Dökümhane uzantısı görünümünün Kaynaklar bölümünde Modeller'in yanındaki artı simgesini seçin.
Dökümhane uzantısı görünümünün Araçlar bölümünde 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.

Komut paletini açmak için F1'i seçin.
Dökümhane: Model Kataloğu'nu açın ve Enter tuşuna basın.
Model Kataloğu sayfası açılır.
Sayfanın üst kısmındaki açılan menüleri kullanarak Model KataloğunuBarındırılan,Yayımcı, Özellik veya Model türüne göre filtreleyin. İnce ayar desteğini destekleyen modelleri filtrelemek için İnce Ayar Desteği aç/kapa düğmesini seçin.
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

Dökümhane uzantısı görünümünde Modeller'in yanındaki artı simgesini seçerek model kataloğunu açın.

Tavsiye

Ayrıca Doğrudan dağıtım akışına gitmek için Modeller'e sağ tıklayıp Yeni yapay zeka modelini dağıt'ı seçebilirsiniz.

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

Dökümhane uzantısı görünümünün Araçlar bölümünde Model Kataloğu bağlantısına çift tıklayın.

Model kataloğundan model dağıtın

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

Seçili model adının yanındaki Dağıt düğmesini seçin.
Model Dağıtımı sayfası açılır.
Dağıtım adını girin metin kutusuna model dağıtım adını girin ve Enter tuşuna basın.
Dağıtım türü açılan listesinde dağıtım türünü seçin.
Model sürümünü Model sürümü açılır listesinden seçin.
(İsteğe bağlı) Dakika başına belirteçler kaydırıcısını kullanarak dakika başına belirteçleri ayarlayın.
Sol alt köşedeki Dökümhanede Dağıt düğmesini seçin.
Onay iletişim kutusunda Dağıt'ı seçin.
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

Projenizde dağıtılan tüm modelleri görmek için Dökümhane uzantısı görünümündeKi Modeller 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:

Model kartının sağ üst kısmındaki Düzenle düğmesini seçin.
Düzenlenebilir alanları güncelleştirin.
Değişiklikleri kaydetmek 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.

Dağıtılan modelinize sağ tıklayın ve Kod dosyasını aç'ı seçin.
Tercih edilen SDK'yı seçin açılan listesinde tercih ettiğiniz SDK'yı seçin.
Dil seçin açılan listesinde tercih ettiğiniz dili seçin.
Kimlik doğrulama yöntemini seçin açılan listesinde tercih ettiğiniz kimlik doğrulama yöntemini seçin.
VS Code'da yeni bir sekmede örnek kod dosyası açılır.

Aşağıdaki ekran görüntüsü, yanıtlar API'sine zaman uyumlu bir çağrı yapan oluşturulmuş bir Python örneğini gösterir:

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, Foundry uzantısı görünümünün Araçlar 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.

Oyun Alanı sayfası açılır.
İsteminizi yazın ve çıkışı gözden geçirin.
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.
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

Foundry uzantısını kullanırken sorunlarla karşılaşırsanız aşağıdaki yaygın sorunları denetleyin:

Sorun	Çözüm
Uzantı yüklemeden sonra görünmüyor	VS Code'ı yeniden başlatın ve Uzantılar görünümünde uzantının etkinleştirildiğini doğrulayın.
Oturum açma başarısız oluyor veya abonelikler yüklenemiyor	Azure hesabınızın doğru izinlere sahip olduğunu doğrulayın. Azure Kaynakları görünümünden çıkış yapıp yeniden oturum açmayı deneyin.
Model dağıtımı kota hatası nedeniyle başarısız oluyor	Abonelik kotanızı denetleyin ve bir artış isteyin veya kullanılmayan dağıtımları silin.

Kaynakları temizle

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

VS Code gezinti çubuğunda Foundry uzantısını yenileyin. Kaynaklar bölümünde Modeller alt bölümünü genişletin.
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: