Aracılığıyla paylaş

Geliştirme ortamınızı hazırlama

Geliştirme ortamınızı Microsoft Foundry SDK'sını kullanacak şekilde ayarlayın. Ayrıca kodunuzun kullanıcı kimlik bilgilerinize erişebilmesi için kimlik doğrulaması için Azure CLI gerekir.

Bu makalede dil çalışma zamanlarını, Azure CLI'yı, Azure Geliştirici CLI'sını, Dökümhane VS Code uzantısını ve Git'i yüklersiniz.

Önemli

Bu makale yalnızca dil çalışma zamanları, genel araçlar, VS Code ve uzantı kurulumu gibi genel önkoşulları kapsar.
SDK yüklemesi veya kimlik doğrulaması gibi senaryoya özgü adımları kapsamaz.
Ortamınız hazır olduğunda, bu yönergeler için hızlı başlangıca geçin.

Önkoşullar

  • Aktif bir aboneliğe sahip bir Azure hesabı. Hesabınız yoksa ücretsiz deneme aboneliği içeren ücretsiz bir Azure hesabı oluşturun.

  • Visual Studio Code'u veya seçtiğiniz IDE'yi indirin, yükleyin ve yapılandırın. Daha fazla bilgi için bkz . Visual Studio Code'ı indirme.

  • Foundry kaynaklarını oluşturmak ve yönetmek için aşağıdaki Azure RBAC rollerinden biri

    • Azure AI Proje Yöneticisi (Dökümhane projelerini yönetmek için)
    • Sahip (abonelik düzeyi izinleri için). Sahip, Foundry'deki diğer senaryolar için gereken ek rol atamaları için gereklidir. Foundry'deki tüm senaryolarda engelin kaldırıldığından emin olmak için gereken rol ataması, Owner rolüdür.

  • Projeyi kullanmak, ancak yeni kaynaklar oluşturmadan en azından şunlara ihtiyacınız vardır:

    • Kullandığınız projelerde Azure AI Kullanıcısı (geliştirme için en az ayrıcalıklı rol)

    Her rolün izinleri hakkında ayrıntılı bilgi için bkz. Microsoft Foundry için rol tabanlı erişim denetimi.

Programlama dilinizi yükleme

Visual Studio Code'da projeniz için yeni bir klasör oluşturun. Bu klasörde bir terminal penceresi açın.

İlk olarak yeni bir Python ortamı oluşturun. Paketleri genel Python yüklemenize yüklemeyin. Python paketlerini yüklerken her zaman bir sanal veya conda ortamı kullanın. Aksi takdirde Python'ın genel yüklemesini bozabilirsiniz.

Gerekirse Python'ı yükleyin

Python 3.10 veya üzerini kullanın, ancak en az Python 3.9 gereklidir. Python'ın uygun bir sürümü yüklü değilse, işletim sisteminize Python yüklemenin en kolay yolu için VS Code Python Öğreticisi'ndeki yönergeleri izleyin.

Sanal ortam oluşturma

Python 3.10 veya üzeri yüklüyse aşağıdaki komutları kullanarak bir sanal ortam oluşturun:

py -3 -m venv .venv
.venv\scripts\activate

Python ortamını etkinleştirdiğinizde, komut satırından veya python çalıştırıldığında pip uygulamanızın klasöründeki .venv Python yorumlayıcısı kullanılır.

Uyarı

Komutunu kullanarak deactivate Python sanal ortamından çıkın. Daha sonra gerektiğinde yeniden etkinleştirebilirsiniz.

Visual Studio Code için Python uzantısını yükleme

Visual Studio Code için Python uzantısı IntelliSense, hata ayıklama, biçimlendirme, lint, kod gezintisi, yeniden düzenleme, değişken gezgini, test gezgini ve ortam yönetimi ile Python'ı destekler.

Visual Studio Code için Python Uzantısı'nı yükleyin.

Yüklemek:

Java için Visual Studio Code Uzantı Paketi'ni yükleme

Java için Uzantı Paketi, Visual Studio Code'da Java uygulamaları yazmanıza, test edip hatalarını ayıklamanıza yardımcı olabilecek popüler uzantılardan oluşan bir koleksiyondur.

Java için Visual Studio Code Uzantı Paketi'ni yükleyin.

Node.js yükleyin (sürüm 18 veya üzeri önerilir).

.NET geliştirmesi için gerekli araçların yüklü olduğundan emin olun.

.NET SDK'sını yükleme

.NET uygulamaları oluşturmak, derlemek ve çalıştırmak için .NET SDK'sına (Yazılım Geliştirme Seti) ihtiyacınız vardır. Projeniz için gerekliyse en son LTS (Uzun Vadeli Destek) sürümünü veya sonraki bir sürümü yüklemenizi öneririz.

  1. Resmi .NET indirme sayfasından .NET SDK'sını indirin. İşletim sisteminiz (Windows, Linux veya macOS) için uygun yükleyiciyi seçin.

  2. İşletim sisteminiz için yükleme yönergelerini izleyin.

  3. Bir terminal veya komut istemi açıp çalıştırarak yüklemeyi doğrulayın:

    dotnet --version

    Yanıt yüklü SDK sürümü olmalıdır.

Visual Studio Code için C# Geliştirme Seti'ni yükleme

VS Code'daki en iyi C# geliştirme deneyimi için resmi C# Dev Kit uzantısını yükleyin:

  1. Visual Studio Code'u açın.
  2. Uzantılar görünümüne gidin (Ctrl+Shift+X veya Cmd+Shift+X).
  3. C# Dev Kit'i arayın.
  4. Microsoft tarafından yayımlanan uzantıyı yükleyin. Bu, henüz sahip değilseniz temel C# uzantısını da yükler.

Yeni bir .NET Projesi oluşturma

Visual Studio Code ile tümleşik terminali (Terminal > Yeni Terminal) kullanarak yeni bir .NET projesi oluşturabilirsiniz.

Örneğin, yeni bir konsol uygulaması oluşturmak için:

# Navigate to the directory where you want to create your project
# cd path/to/your/projects

# Create a new console application in a subfolder named MyConsoleApp
dotnet new console -o MyConsoleApp

# Navigate into the newly created project folder
cd MyConsoleApp

Artık C# projenizde çalışmaya başlamak için bu MyConsoleApp klasörü VS Code'da (Dosya > Klasör Aç...) açabilirsiniz. C# Dev Kit uzantısıyla VS Code projeyi otomatik olarak algılar ve IntelliSense, hata ayıklama ve derleme görevleri gibi özellikleri etkinleştirir.

Azure CLI'yi yükleyin ve oturum açın

Microsoft Foundry Modellerinde Azure OpenAI'yi çağırmak için kullanıcı kimlik bilgilerinizi kullanabilmek için Azure CLI'yı yükler ve yerel geliştirme ortamınızdan oturum açarsınız.

Çoğu durumda, aşağıdaki komutu kullanarak terminalinizden Azure CLI yükleyebilirsiniz:

winget install -e --id Microsoft.AzureCLI

Bu komutlar belirli bir işletim sisteminiz veya kurulumunuz için çalışmıyorsa Azure CLI'yı yükleme yönergelerini izleyebilirsiniz.

Azure CLI'yı yükledikten sonra az login komutunu kullanarak ve tarayıcı üzerinden oturum açın.

az login

Alternatif olarak, tarayıcı üzerinden bir cihaz koduyla el ile oturum açabilirsiniz.

az login --use-device-code

Oturum açtıktan sonra betikleri çalıştırmak için bu terminali açık tutun.

Azure Geliştirici CLI'sını yükleme

Azure Geliştirici CLI'sı (azd), Azure'da uygulama kaynaklarını ayarlamanıza ve dağıtmanıza yardımcı olan açık kaynaklı bir araçtır. İster terminal, IDE ister CI/CD işlem hatları kullanın, geliştirmenin temel aşamaları için basit komutlar sağlar. Platformunuz için Azure Geliştirici CLI'sini yükleyin.

Yapay zeka çözümü şablonlarının çoğu, kullanan azdbir dağıtım seçeneği içerir.

Foundry VS Code uzantısını yükleme

Visual Studio Code için Foundry uzantısı modelleri dağıtmanıza, yapay zeka uygulamaları oluşturmanıza ve doğrudan VS Code arabiriminden Aracılarla çalışmanıza olanak tanır. Foundry VS Code uzantısını yükleyin.

Git'i yükleme

Foundry SDK örneklerini kopyalamak için Git gereklidir. Git yüklü değilse , platformunuzun yönergelerini izleyin ve işletim sisteminizi seçin.

Sorun giderme

Sorun Çözüm
Yüklemeden sonra komut bulunamadı PATH değişikliklerinin etkili olması için terminalinizi kapatıp yeniden açın veya VS Code'ı yeniden başlatın.
az login tarayıcı hatasıyla başarısız oluyor Bunun yerine bir cihaz kodu akışı kullanarak kimlik doğrulaması yapmak için komutunu çalıştırın az login --use-device-code .
Python bulunamadı macOS/Linux'te python3 yerine python kullanın veya desteklenen bir sürüm (3.9 ya da üstü) yükleyin.
Yükleme sırasında izin reddedildi macOS/Linux'ta kullanmaktan kaçının sudo pip install. Bunun yerine bir sanal ortam kullanın.

İlgili içerik

  • Last updated on