Ortamınızı ayarlama

Bu makalede, Foundry Agent Service ile ajan oluşturmak için gerekli olan altyapıyı dağıtacaksınız. Bu kurulumu tamamladıktan sonra, istediğiniz SDK'yı veya Foundry portalını kullanarak aracılar oluşturabilir ve yapılandırabilirsiniz.

İlk aracınızı oluşturmak iki adımlı bir işlemdir:

1. Ajan ortamınızı ayarlayın (bu makale).
2. Ajanınızı oluşturun ve yapılandırın.

Gerekli izinler

Eylem	Gerekli Rol
Hesap ve proje oluşturma	Azure AI Hesabı Sahibi
standart kurulum Yalnızca: Gerekli kaynaklar (Cosmos DB, Arama, Depolama vb.) için RBAC atayın	Rol Tabanlı Erişim Denetimi Yöneticisi
Ajanları oluşturma ve düzenleme	Azure AI Kullanıcısı

Aracı ortamınızı ayarlama

Başlamak için bir Microsoft Foundry kaynağına ve bir Foundry projesine ihtiyacınız vardır.
Ajanlar belirli bir proje içinde oluşturulur ve her proje izole bir çalışma alanı işlevi görür. Bu, şu anlama gelir:

• Aynı projedeki tüm aracılar aynı dosya depolama, iş parçacığı depolama (konuşma geçmişi) ve arama dizinlerine erişimi paylaşır.
• Veriler projeler arasında yalıtılır. Bir projedeki aracılar başka bir projeden kaynaklara erişemez. Projeler şu anda Foundry'de paylaşım ve yalıtımın birimidir. Foundry projeleri hakkında daha fazla bilgi için yapay zeka dökümhanesi nedir makalesine bakın.

Önkoşullar

• Azure aboneliği - Ücretsiz bir abonelik oluşturun.
• Hesabı ve projeyi oluşturan kişinin abonelik kapsamında Azure AI Hesabı Sahibi rolüne sahip olduğundan emin olun
• Standart bir kurulum yapılandırıyorsanız, aynı kişinin gerekli kaynaklara (Cosmos DB, Azure AI Search, Azure Blob Depolama) rol atama izinleri de olmalıdır. Aracı Hizmeti'ne özgü RBAC rolleri hakkında daha fazla bilgi için bkz. Aracı Hizmeti RBAC rolleri.
  • Gereken yerleşik rol, Rol Tabanlı Erişim Yöneticisi'dir.
  • Alternatif olarak, abonelik düzeyinde Sahip rolüne sahip olmak da bu gereksinimi karşılar.
  • Gereken temel izin: Microsoft.Authorization/roleAssignments/write

Kurulumunuzu seçin

Aracı Hizmeti, farklı gereksinimlere uygun üç ortam yapılandırma modu sunar:

• Temel Kurulum:

  Bu kurulum OpenAI Yardımcıları ile uyumludur ve platformun yerleşik depolama alanını kullanarak aracı durumlarını yönetir. OpenAI olmayan modeller ve Azure AI Search ve Bing gibi araçlar için ek destekle birlikte Yardımcılar API'siyle aynı araçları ve özellikleri içerir.

• Standart Kurulum:

  Kendi Azure kaynaklarınızı kullanmanıza olanak tanıyarak temel kurulumdaki her şeyi ve verileriniz üzerinde ayrıntılı denetimi içerir. Dosyalar, iş parçacıkları ve vektör depoları dahil olmak üzere tüm müşteri verileri kendi Azure kaynaklarınızda depolanır ve size tam sahiplik ve denetim sağlar.

• Kendi Sanal Ağınızı Getirin (BYO) Ile Standart Kurulum:

  Tamamen kendi sanal ağınızda çalışabilme özelliğiyle Standart Kurulum'daki her şeyi içerir. Bu kurulum Kendi Sanal Ağınızı Getir'i (BYO sanal ağı) destekleyerek veri taşıma üzerinde sıkı denetim sağlar ve trafiği ağ ortamınızla sınırlı tutarak veri sızdırmayı önlemeye yardımcı olur.

Kurulum seçeneklerini karşılaştırma

Uyarı

Aşağıdaki tabloda yer alan Özel Ağ Yalıtımı, Güvenli Aracının dışa yönelik iletişimine atıfta bulunur. Temel kurulum geçerli değildir ve Yalnızca Standart Kurulum ile Aracılarınız için Özel Ağ Yalıtımı kullanabilirsiniz.

Özel bir uç nokta eklenip Foundry Hesabınız için gelen genel erişim devre dışı bırakılarak, aşağıdaki tüm kurulumlar için gelen güvenli iletişim uygulanabilir.

Kullanım Örnekleri	Temel Kurulum	Genel Ağ ile Standart Kurulum	Özel Ağ ile Standart Kurulum
Kaynakları yönetmeden hızlı bir şekilde kullanmaya başlama	✅
Tüm konuşma geçmişi, dosya ve vektör depoları kendi kaynaklarınızda depolanır		✅	✅
Müşteri Tarafından Yönetilen Anahtarlar (CMK) desteği		✅	✅
Özel Ağ Yalıtımı (Kendi sanal ağınızı getirin)			✅

Dağıtım seçenekleri

Bu şablonları özelleştirmek için bkz. Kendi kaynaklarınızı kullanma.

Özel Ağ Yalıtımı için destek istiyorsanız, kendi sanal ağınızı getirme hakkında daha fazla bilgi için bkz. ağ güvenliğine sahip kurulum .

Açıklama ve Otomatik Dağıtım	Diyagram (yakınlaştırmak için tıklayın)
Kimlik doğrulaması için Yönetilen Kimlik kullanan temel bir aracı kurulumu dağıtın. Bir hesap ve proje oluşturulur. GPT-4.1 modeli dağıtılır. Microsoft tarafından yönetilen bir Key Vault varsayılan olarak kullanılır.
Kimlik doğrulaması için Yönetilen Kimlik kullanan standart bir aracı kurulumu dağıtın. Bir hesap ve proje oluşturulur. GPT-4.1 modeli dağıtılır. Mevcut kaynaklar sağlanmazsa müşteri verilerini depolamak için Azure kaynakları (Azure Depolama, Azure Cosmos DB ve Azure AI Search) otomatik olarak oluşturulur. Bu kaynaklar dosyaları, iş parçacıklarını ve vektör verilerini depolamak için projenize bağlanır. Microsoft tarafından yönetilen bir Key Vault varsayılan olarak kullanılır.

[İsteğe bağlı] Otomatik dağıtım şablonunda model seçimi

Önemli

modelFormat parametresini değiştirmeyin.

Şablonlar yalnızca Azure OpenAI modellerinin dağıtımını destekler. Model destek makalesinde hangi Azure OpenAI modellerinin desteklendiğine bakın.

Otomatik dağıtım şablonunda model parametrelerini düzenleyerek aracınız tarafından kullanılan modeli özelleştirebilirsiniz. Farklı bir model dağıtmak için en azından modelName ve modelVersion parametrelerini güncelleştirmeniz gerekir.

Varsayılan olarak, dağıtım şablonu aşağıdaki değerlerle yapılandırılır:

Model Parametresi	Varsayılan Değer
modelName	gpt-4.1
modelFormat	OpenAI (Azure OpenAI için)
modelVersion	2025-04-14
modelSKUAdı	GlobalStandard
modelLocation	eastus (bölge adı)

Dağıtımınızı doğrulayın

Dağıtım tamamlandıktan sonra (genellikle 5-10 dakika), kaynaklarınızın başarıyla oluşturulduğunu doğrulayın:

1. Azure portalına gidin.
2. Kaynak grubu adınızı arayın.
3. Aşağıdaki kaynakların mevcut olduğunu onaylayın:
   • Temel kurulum: Dökümhane hesabı, proje ve model dağıtımı.
   • Standart kurulum: Tüm temel kaynaklara ek olarak Azure Depolama hesabı, Azure Cosmos DB hesabı ve Azure AI Search hizmeti.

Tavsiye

Dağıtım başarısız olursa, hata ayrıntıları için kaynak grubunuzdaki Dağıtımlar bölümünü denetleyin. Sık karşılaşılan sorunlar arasında model için kota yetersiz veya eksik izinler yer alır.

Sorun giderme

Sorun	Nedeni	Çözüm
Dağıtım kota hatasıyla başarısız oluyor	Seçili bölgede GPT-4.1 için kota yetersiz	Kota artışı isteme veya farklı bir bölge seçme
Dağıtım sırasında izin reddedildi	Rol Tabanlı Erişim Yöneticisi rolü eksik	Abonelik sahibinizden size gerekli rolü vermesini isteyin
Kaynaklar oluşturuldu, ancak ajan oluşturma başarısız oldu.	Project kaynaklara düzgün bağlanmadı	Proje ayarları>Bağlı kaynaklar altındaki Döküm portalında bağlantıyı doğrulayın
Model mevcut değil	Model bölgenizde dağıtılmadı	Model bölgesi desteğini denetleyin ve kullanılabilir bir bölge seçin

Sırada ne var?

• İlk aracınızı oluşturma

• Daha fazlasını keşfedin:

  • Mevcut kaynaklarınızı kullanma
  • Ağ güvenliği aracının kurulumu