Aracı 365 CLI `setup` 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.

Her adım üzerinde ayrıntılı denetimle Agent 365 ortamınızı ayarlayın. Bu komut, Agent 365 şemaları için ilk kurulum iş akışını yönetir.

Minimum rolü gerekli: Azure Contributor + Global Administrator

Sözdizimi

a365 setup [command] [options]

Options

Seçenek	Description
`-?`, `-h`, `--help`	Yardım ve kullanım bilgilerini gösterir.

Önerilen yürütme sırası

# 0. Check prerequisites (optional)
a365 setup requirements

# 1. Create infrastructure (or skip if infrastructure exists)
a365 setup infrastructure

# 2. Create blueprint
a365 setup blueprint

# 3. Configure MCP permissions
a365 setup permissions mcp

# 4. Configure bot permissions
a365 setup permissions bot

# 5. Configure CopilotStudio permissions (if needed)
a365 setup permissions copilotstudio

# 6. Configure custom permissions (if needed)
a365 setup permissions custom

Veya tüm adımları aynı anda çalıştırın:

# Full setup (includes infrastructure)
a365 setup all

# Skip infrastructure if it already exists
a365 setup all --skip-infrastructure

`setup requirements`

Aracı 365 kurulumu için önkoşulları doğrulayın. Modüler gereksinim denetimlerini çalıştırır ve bulduğu sorunlar için rehberlik sağlar.

a365 setup requirements [options]

Bu komut aşağıdaki adımları çalıştırır:

Aracı 365 kurulumu için gereken tüm önkoşulları denetler.
Ayrıntılı çözüm kılavuzuyla ilgili sorunları bildirir.
Bazı denetimler başarısız olsa bile tüm gereksinimleri denetlemeye devam eder.
Sonundaki tüm denetimlerin özetini sağlar.

`requirements` Seçenekler

Seçenek	Description
`-c`, `--config <config>`	Yapılandırma dosyası yolu. Varsayılan değer: `a365.config.json`.
`-v`, `--verbose`	Tüm denetimler için ayrıntılı çıkışı gösterir.
`--category <category>`	Yalnızca `Azure`, `Authentication` veya `Configuration` gibi belirli bir kategori için denetimler çalıştırır.
`-?`, `-h`, `--help`	Yardım ve kullanım bilgilerini gösterir.

`setup infrastructure`

Azure altyapısı oluşturun.

Minimum gerekli izinler: abonelik katkıda bulunanı veya sahibi Azure

a365 setup infrastructure [options]

`infrastructure` Seçenekler

Seçenek	Description
`-c`, `--config <config>`	Yapılandırma dosyası yolu. Varsayılan değer: `a365.config.json`.
`-v`, `--verbose`	Ayrıntılı çıkışı göster.
`--dry-run`	Yürütülmeden ne yapılacağını gösterin.
`-?`, `-h`, `--help`	Yardım ve kullanım bilgilerini gösterir.

`setup blueprint`

Aracı şeması oluşturma (Entra ID uygulama kaydı).

Gerekli en düşük izinler: Aracı Kimliği Geliştirici rolü

a365 setup blueprint [options]

`blueprint` Seçenekler

Seçenek	Description
`-c`, `--config <config>`	Yapılandırma dosyası yolu. Varsayılan değer: `a365.config.json`.
`-v`, `--verbose`	Ayrıntılı çıkışı göster.
`--dry-run`	Yürütülmeden ne yapılacağını gösterin.
`--no-endpoint`	Mesajlaşma uç noktasını kaydetmeyin (yalnızca şema).
`--endpoint-only`	Yalnızca mesajlaşma uç noktasını kaydedin. Mevcut şemayı gerektirir.
`-?`, `-h`, `--help`	Yardım ve kullanım bilgilerini gösterir.

`setup permissions`

OAuth2 izin vermelerini ve devralınabilir izinleri yapılandırın.

Gerekli en düşük izinler: Genel Yönetici

a365 setup permissions [command] [options]

Options

Seçenek	Description
`-?`, `-h`, `--help`	Yardım ve kullanım bilgilerini gösterir.

Subcommands

Subcommand	Description
`mcp`	MCP sunucusu OAuth2 izinlerini ve devralınabilir izinleri yapılandırın.
`bot`	Mesajlaşma Botu API'sinde OAuth2 izinleri ve devralınabilir izinleri yapılandırın.
`custom`	Aracı şemanıza aracı işlemi için gereken standart izinleri aşan özel API izinleri uygular.
`copilotstudio`	Power Platform API'sini kullanarak Copilot Studio yardımcı pilotlarını çağırmak için aracı şeması için OAuth2 izin vermelerini ve devralınabilir izinleri yapılandırır.

`setup permissions mcp`

MCP sunucusu OAuth2 izinlerini ve devralınabilir izinleri yapılandırın.

Gerekli en düşük izinler: Genel Yönetici

a365 setup permissions mcp [options]

Bu komut:

ToolingManifest.json içinde deploymentProjectPathbelirtilen dosyasından a365.config.json okur.
Aracı şemasına her MCP sunucusu kapsamı için OAuth2 temsilci izni verir.
Aracı örneklerinin MCP araçlarına erişebilmesi için devralınabilir izinleri yapılandırır.
Bir kez etkili ve birden çok kez çalıştırılması güvenlidir.

Önemli

Bu komutu çalıştırmadan önce komutunu çalıştırarak a365 config display güncelleştirilmiş deploymentProjectPathöğesini içeren proje klasörüne işaret ettiğini ToolingManifest.json doğrulayın. Geliştirici farklı bir makineye MCP sunucuları ekliyorsa, önce güncelleştirilmiş ToolingManifest.json sunucuyu Genel Yönetici ile paylaşın. Doğru ToolingManifest.json olmadan çalıştırmak şemaya yeni MCP sunucusu izinlerini eklemez.
Geliştirici çalıştırdıktan sonra bu komutu çalıştırın a365 develop add-mcp-servers. Bildirime MCP sunucuları eklemek ve şemaya izin vermek iki ayrı adımdır. Bu komut tamamlandıktan sonra MCP sunucu izinleri aracı şemasında görünür.

`permissions mcp` Seçenekler

Seçenek	Description
`-c`, `--config <config>`	Yapılandırma dosyası yolu. Varsayılan değer: `a365.config.json`.
`-v`, `--verbose`	Ayrıntılı çıkışı göster.
`--dry-run`	Yürütülmeden ne yapılacağını gösterin.
`-?`, `-h`, `--help`	Yardım ve kullanım bilgilerini gösterir.

`setup permissions bot`

Mesajlaşma Botu API'sinde OAuth2 izinleri ve devralınabilir izinleri yapılandırın.

Gerekli en düşük izinler: Genel Yönetici

Önkoşullar: Şema ve MCP izinleri (önce çalıştır a365 setup permissions mcp )

İleri adım: Aracınızı dağıtın (Azure barındırılıyorsa a365 deploy çalıştırın)

a365 setup permissions bot [options]

`permissions bot` Seçenekler

Seçenek	Description
`-c`, `--config <config>`	Yapılandırma dosyası yolu. Varsayılan değer: `a365.config.json`.
`-v`, `--verbose`	Ayrıntılı çıkışı göster.
`--dry-run`	Yürütülmeden ne yapılacağını gösterin.
`-?`, `-h`, `--help`	Yardım ve kullanım bilgilerini gösterir.

`setup permissions custom`

Aracı şemanıza aracı işlemi için gereken standart izinleri aşan özel API izinleri uygular. Bu komutu kullanarak aracınıza İletişim Durumu, Dosyalar ve Sohbet gibi ek Microsoft Graph kapsamlarına veya kuruluşunuzun Entra Id kiracısında kayıtlı özel API'lere erişim verirsiniz.

Gerekli en düşük izinler: Genel Yönetici

Önkoşullar: önce çalıştırın a365 setup blueprint . Bu komutu çalıştırmadan önce komutunu kullanarak a365.config.json 'a a365 config permissions özel izinler ekleyin.

a365 setup permissions custom [options]

Bu komut:

Yapılandırılan her kaynak için yönetici onayıyla OAuth2 temsilci izni vermelerini yapılandırıyor.
Aracı kullanıcılarının şemadan erişimi devralabilmesi için devralınabilir izinleri ayarlar.
Yeni izinler ekleyerek ve yapılandırmadan silinmiş tüm izinleri kaldırarak Microsoft Entra geçerli yapılandırmayla mutabık tutar.
Bir kez etkili ve birden çok kez çalıştırılması güvenlidir.

`permissions custom` Seçenekler

Seçenek	Description
`-c`, `--config <config>`	Yapılandırma dosyası yolu. Varsayılan değer: `a365.config.json`.
`-v`, `--verbose`	Ayrıntılı çıkışı göster.
`--dry-run`	Yürütülmeden ne yapılacağını gösterin.
`-?`, `-h`, `--help`	Yardım ve kullanım bilgilerini gösterir.

Özel izinleri yapılandırma

Bu komutu çalıştırmadan önce yapılandırmanıza özel izinler eklemek için kullanın a365 config permissions :

# Add Microsoft Graph extended permissions
a365 config permissions `
  --resource-app-id 00000003-0000-0000-c000-000000000000 `
  --scopes Presence.ReadWrite,Files.Read.All,Chat.Read

# Add custom API permissions
a365 config permissions `
  --resource-app-id <your-api-app-id> `
  --scopes CustomScope.Read,CustomScope.Write

# Apply all configured custom permissions
a365 setup permissions custom

Kaynak adı, kurulum sırasında Azure otomatik olarak çözümlenir. Yapılandırmada belirtmeniz gerekmez.

Özel izinleri kaldırma

Hem yapılandırmadan hem de Microsoft Entra özel izinleri kaldırmak için:

# Step 1: Remove from config
a365 config permissions --reset

# Step 2: Reconcile Microsoft Entra with updated config
a365 setup permissions custom

`setup all` ile tümleştirme

Yapılandırmanız özel izinler içerdiğinde, çalıştırıldığında a365 setup all otomatik olarak yapılandırılır. Kurulum siparişinin tamamı şu şekildedir:

Altyapı
Proje çizimi
MCP izinleri
Bot API izinleri
Özel şema izinleri (yapılandırılmışsa)
Mesajlaşma uç noktası

`setup permissions copilotstudio`

Power Platform API'sini kullanarak Copilot Studio yardımcı pilotlarını çağırmak için aracı şeması için OAuth2 izin vermelerini ve devralınabilir izinleri yapılandırır.

Gerekli en düşük izinler: Genel Yönetici

Önkoşullar: önce çalıştırın a365 setup blueprint .

a365 setup permissions copilotstudio [options]

Bu komut:

Power Platform API hizmet sorumlusunun kiracınızda mevcut olduğundan emin olur.
Şemadan kapsamıyla CopilotStudio.Copilots.Invoke Power Platform API'sine OAuth2 izni oluşturur.
Aracı örneklerinin Copilot Studio yardımcı pilotlarını çağırabilmesi için devralınabilir izinleri ayarlar.

`permissions copilotstudio` Seçenekler

Seçenek	Description
`-c`, `--config <config>`	Yapılandırma dosyası yolu. Varsayılan değer: `a365.config.json`.
`-v`, `--verbose`	Ayrıntılı çıkışı göster.
`--dry-run`	Yürütülmeden ne yapılacağını gösterin.
`-?`, `-h`, `--help`	Yardım ve kullanım bilgilerini gösterir.

Aracınızın çalışma zamanında Copilot Studio yardımcı pilotlarını çağırması veya CopilotStudio izinleri gerektiren Power Platform API'lerini çağırması gerektiğinde bu komutu kullanın.

`setup all`

Agent 365 ortamınızı ayarlamak için tüm kurulum adımlarını gerçekleştirme

a365 setup all [options]

Tüm adımlar sırayla tüm Agent 365 kurulumunu çalıştırır.

Şunları içerir: Altyapı, Şema, İzinler ve Uç Nokta.

Gerekli en düşük izinler (Genel Yönetici bu izinlerin tümüne sahiptir):

Azure Abonelik Katkıda Bulunanı (altyapı ve uç nokta için)
Aracı Kimliği Geliştirici rolü (şema oluşturma için)
Genel Yönetici (izin izinleri ve yönetici onayı için)

`setup all` Seçenekler

Seçenek	Description
`-c`, `--config <config>`	Yapılandırma dosyası yolu. Varsayılan değer: `a365.config.json`.
`-v`, `--verbose`	Ayrıntılı çıkışı göster.
`--dry-run`	Yürütülmeden ne yapılacağını gösterin.
`--skip-infrastructure`	Altyapı oluşturma Azure atlayın (altyapı zaten varsa kullanın). Bu seçenek yine de şunları oluşturur: Şema, İzinler ve Uç Nokta.
`--skip-requirements`	Gereksinimler doğrulama denetimini atlayın. Dikkatli kullanın: Önkoşullar karşılanmazsa kurulum başarısız olabilir.
`-?`, `-h`, `--help`	Yardım ve kullanım bilgilerini gösterir.

Geri Bildirim

Bu sayfayı yararlı buldunuz mu?

Last updated on 2026-03-10

Aracılığıyla paylaş

Aracı 365 CLI setup komut başvurusu

Sözdizimi

Options

Önerilen yürütme sırası

setup requirements

requirements Seçenekler

setup infrastructure

infrastructure Seçenekler

setup blueprint

blueprint Seçenekler

setup permissions

Options

Subcommands

setup permissions mcp

permissions mcp Seçenekler

setup permissions bot

permissions bot Seçenekler

setup permissions custom

permissions custom Seçenekler

Özel izinleri yapılandırma

Özel izinleri kaldırma

setup all ile tümleştirme

setup permissions copilotstudio

permissions copilotstudio Seçenekler

setup all

setup all Seçenekler

Geri Bildirim

Ek kaynaklar

Aracı 365 CLI `setup` komut başvurusu

`setup requirements`

`requirements` Seçenekler

`setup infrastructure`

`infrastructure` Seçenekler

`setup blueprint`

`blueprint` Seçenekler

`setup permissions`

`setup permissions mcp`

`permissions mcp` Seçenekler

`setup permissions bot`

`permissions bot` Seçenekler

`setup permissions custom`

`permissions custom` Seçenekler

`setup all` ile tümleştirme

`setup permissions copilotstudio`

`permissions copilotstudio` Seçenekler

`setup all`

`setup all` Seçenekler