Aracı 365 CLI deploy komut başvurusu

Önemli

Microsoft Agent 365'e erken erişim elde etmek için Frontier önizleme programının bir parçası olmanız gerekir. Frontier sizi Doğrudan Microsoft'un en son yapay zeka yenilikleri ile bağlar. Sınır önizlemeleri, müşteri sözleşmelerinizin mevcut önizleme koşullarına tabidir. Bu özellikler hala geliştirme aşamasında olduğundan, bunların kullanılabilirliği ve özellikleri zaman içinde değişebilir.

Aracı 365 uygulama ikili dosyalarını yapılandırılmış Azure App Service dağıtma ve Aracı 365 Aracı izinlerini güncelleştirme deploy komutu, Aracı 365 dağıtımları oluşturma seçenekleri sağlar. Uygulama ikili dosyalarını Azure altyapınıza dağıtmak ve Aracı 365 Araçları izinleri vermek için bu komutu kullanın.

Minimum rolü gerekli: Azure Contributor + Global Administrator

Bu komutu kullanma hakkında bilgi için bkz. Deploy agent to Azure.

Sözdizimi

a365 deploy [command] [options]

Options

Seçenek	Description
-c, --config <config>	Yapılandırma dosyasının yolu (varsayılan: a365.config.json)
-v, --verbose	Ayrıntılı günlük kaydını etkinleştir
--dry-run	Yürütme olmadan neler yapılacağını göster
--inspect	Yayımlama klasörünü ve ZIP içeriğini incelemek için dağıtımdan önce duraklatma
--restart	Derlemeyi atlayın ve mevcut yayımlama klasörünü sıkıştırmaya başlayın (el ile yapılan değişikliklerden sonra hızlı yineleme için)
-?, -h, --help	Yardım ve kullanım bilgilerini gösterme

Açıklamalar

Alt komut olmadan çalıştırmak a365 deployiki aşamalı bir dağıtım çalıştırır:

• Phase 1 — Uygulama ikili dosyaları: Uygulamanızı derler ve Azure App Service dağıtır.
• 2. Aşama — MCP izinleri: Gerekli kapsamları toolingManifest.json okur ve aracı şemasını gerekli izinlerle güncelleştirir.

her iki aşama da ile --dry-runbile çalışır. Kuru çalıştırma çıkışı iki etiketli bölüme ayrılır, böylece her aşamanın ne yapacağını gözden geçirebilirsiniz.

Denetim öncesi denetimleri

Dağıtmadan önce CLI şunları doğrular:

• Azure kimlik doğrulaması ve abonelik: Azure CLI oturumunuz ve aboneliğiniz geçerli olmalıdır. Aksi takdirde dağıtım bir hatayla durdurulur. ve az login --tenant <TENANT_ID>ile az account set --subscription <SUBSCRIPTION_ID> düzeltin.
• Azure App Service varlığı: Dağıtım devam etmeden önce hedef web uygulamasının mevcut olması gerekir. Uygulama bulunamazsa içinde komutunu çalıştırın a365 setup veya düzeltin webAppNameresourceGroupa365.config.json.

Konfigürasyon

CLI iki yapılandırma dosyasını okur:

• a365.config.json — proje yapılandırmanız (kullanıcı tarafından korunan).
• a365.generated.config.json — kurulum komutları tarafından oluşturulan dinamik durum.

MCP araç kapsamları, dağıtım projesi dizininizde konumundan toolingManifest.json okunur.

CLI ayrıca yapılandırmanın ve durumun genel bir kopyasını şu konumda depolar:

• Windows: %LocalAppData%\Microsoft.Agents.A365.DevTools.Cli
• Linux/macOS: ~/.config/a365

Bayrak davranışı

--restart: Derleme adımını atlar ve doğrudan mevcut publish/ klasörü sıkıştırmaktan başlar. Yoksa publish/ , dağıtım başarısız olur. Klasörü oluşturmak --restart için önce tam dağıtımı (olmadanpublish/) çalıştırın.

--inspect: Klasörü ve oluşturulan ZIP dosyasını inceleyebilmeniz publish/ için karşıya yükleme adımından önce duraklatılır. Yalnızca uygulama aşaması için kullanılabilir.

--dry-run: Herhangi bir değişiklik yapmadan gerçekleşecek her şeyi yazdırır. Çalıştırılırken a365 deploy (iki aşamalı), çıkış aşağıdakilere bölünür:

• Bölüm 1 — Uygulama ikili dosyalarını dağıtma
• Bölüm 2 — Aracı 365 Aracı izinlerini dağıtma/güncelleştirme

deploy app

Aracı kodunuzu kurulum sırasında oluşturulan Azure Web Uygulamasına dağıtır.

a365 deploy app [options]

Yapılandırılan Azure App Service Microsoft Agent 365 uygulama ikili dosyalarını dağıtın. Bu komut, Azure'da yapılandırılan Azure uygulama hizmetinize uygulama ikili dosyalarını dağıtır.

app Seçenekler

Seçenek	Description
-c, --config <config>	Yapılandırma dosyasının yolu (varsayılan: a365.config.json)
-v, --verbose	Ayrıntılı günlük kaydını etkinleştir
--dry-run	Yürütme olmadan neler yapılacağını göster
--inspect	Yayımlama klasörünü ve ZIP içeriğini incelemek için dağıtımdan önce duraklatma
--restart	Derlemeyi atlayın ve mevcut yayımlama klasörünü sıkıştırmaya başlayın (el ile yapılan değişikliklerden sonra hızlı yineleme için)
-?, -h, --help	Yardım ve kullanım bilgilerini gösterme

deploy mcp

Aracı şemanızdaki MCP sunucusu izinlerini güncelleştirir.

a365 deploy mcp [options]

mcp Seçenekler

Seçenek	Description
-c, --config <config>	Yapılandırma dosyası yolu (varsayılan: a365.config.json)
-v, --verbose	Ayrıntılı günlük kaydını etkinleştir
--dry-run	Yürütme olmadan neler yapılacağını göster
-?, -h, --help	Yardım ve kullanım bilgilerini gösterme

Kullanım notları

MEVCUT aracı şemasında MCP sunucuları kapsamlarını ve izinlerini güncelleştirin. Bu komut aracı şemasına Aracı 365 Araçları için izinler ekler.

Aracı kodunuza MCP sunucuları ekler veya değiştirirseniz, aracı şemanızdaki izinleri güncelleştirmek için bu komutu kullanın.

Bu komut:

• KODUNUzdan MCP sunucu yapılandırmanızı okur.
• Aracı şemasını gerekli izinlerle güncelleştirir.
• MCP sunucuları için gerekli API izinlerini verir.

İzin güncelleştirmesi aşağıdaki sırayla uygulanır:

1. OAuth2 izin verme (şema hizmet sorumlusu → MCP platformu)
2. Devralınabilir izinler (aracı şeması → MCP kaynağı)
3. Yönetici onayı (aracı kimliği → MCP platformu)

ne zaman kullanılır deploy mcp?

• Aracınıza yeni MCP sunucuları ekledikten sonra.
• MCP sunucu yapılandırmalarını değiştirdikten sonra.
• MCP araçlarına temsilciniz tarafından erişilemiyorsa.

komutunu çalıştırmanız deploy mcpgerekmez:

• İlk dağıtımda. Bu, kurulum sırasında otomatik olarak işlenir.
• Yalnızca MCP değişiklikleri olmadan aracı mantığını değiştirirken.
• Araçları etkilemeyen rutin kod güncelleştirmelerinin ardından.

Uyarı

a365 deploy mcp yalnızca izinleri güncelleştirir; kodunuzu dağıtmaz. Kod değişiklikleriniz varsa önce komutunu çalıştırın a365 deploy app .

Sorun giderme

Komutuyla deploy ilgili olası sorunları çözmek için aşağıdaki bölümleri kullanın.

• Azure veya yanlış abonelikte oturum açmadı
• Web Uygulaması bulunamadı
• İzin güncelleştirmesi başarısız oluyor
• --restart Başarısız

Azure veya yanlış abonelikte oturum açmadı

az login --tenant <TENANT_ID> ve az account set --subscription <SUBSCRIPTION_ID> komutlarını çalıştırın.

Web Uygulaması bulunamadı

komutunun çalıştırıldığından emin olun veya içinde ve a365 setup doğru olduğundan webAppName emin olunresourceGroup.a365.config.json

İzin güncelleştirmesi başarısız oluyor

• , AgentBlueprintIdve ortamının içinde AgenticAppIdayarlandığını onaylayına365.config.json.
• Hesabınızın hizmet sorumlularını ve vermelerini yönetme haklarına sahip olduğundan emin olun.
• Dağıtım projesi dizininizde mevcut olduğunu toolingManifest.json ve geçerli kapsamlar içerdiğini doğrulayın.

--restart Başarısız

Klasörü oluşturmak için olmadan --restart tam dağıtım çalıştırın, ardından sonraki yinelemeler için kullanınpublish/.--restart

Kayıtlar

CLI günlük dosyaları şu konumda depolanır:

• Windows: %LocalAppData%\Microsoft.Agents.A365.DevTools.Cli\logs\
• Linux/macOS: ~/.config/a365/logs/

En son dağıtım günlük dosyasının son 80 satırlarını görüntülemek için linux/macOS üzerinde Windows veya tail üzerinde Get-Content kullanın:

# Windows
Get-Content $env:LOCALAPPDATA\Microsoft.Agents.A365.DevTools.Cli\logs\a365.deploy.log -Tail 80

# Linux/macOS
tail -80 ~/.config/a365/logs/a365.deploy.log

Çalışma zamanı uygulama günlükleri için App Service'inizden stdout/stderr için Azure portalında Log Stream kullanın.