Aracı 365 CLI `setup` komut başvurusu

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 + Agent ID Developer

Note

Sahip olduğunuz rol, kurulumun ne kadarının tek bir çalıştırmada tamamlanmasını belirler. Genel Yönetici tüm adımları aynı anda tamamlayabilir. Ajan ID Yöneticisi ve Ajan ID Geliştiricisi , OAuth2 izin vermeleri (yönetici onayı) hariç tüm adımları tamamlayabilir; bu işlemler Küresel Yönetici tarafından işlem gerektirir. Kurulum tamamlandığında, CLI Global Administrator için sonraki adımları doğrudan çıktıya yazdırır.

Syntax

a365 setup [command] [options]

Options

Option	Description
`-?`, `-h`, `--help`	Yardım ve kullanım bilgilerini gösterin.

Önerilen yürütme sırası

# 0. Check prerequisites (optional)
a365 setup requirements

# 1. Create blueprint
a365 setup blueprint

# 2. Configure MCP permissions
a365 setup permissions mcp

# 3. Configure bot permissions
a365 setup permissions bot

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

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

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

# Full setup using config file (a365.config.json)
a365 setup all

# Config-free: no a365.config.json needed
a365 setup all --agent-name "MyAgent"

Aracı Kimliği Yöneticisi veya Aracı Kimliği Geliştiricisi (Genel Yönetici değil) olarak çalıştırıyorsanız, a365 setup all OAuth2 izin vermeleri dışındaki tüm adımları tamamlar. Bittiğinde, çıktı bir Küresel Yöneticinin hibeleri tamamlaması için sonraki adımları içerir — doğrudan bir bağlantı veya açabileceği onay URL'si dahil.

`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.

Tip

Eğer Global Yöneticiyseniz ve bilinen Agent 365 CLI istemci uygulaması kiracınızda bulunmuyorsa, setup requirements otomatik olarak oluşturmanızı ister. Mevcut bir uygulama kimliği veya tipi C girerek uygulama oluşturun ve tek adımda yönetici izni verin—manuel Entra kaydı gerekmez.

`requirements` Seçenekler

Option	Description
`-v`, `--verbose`	Ayrıntılı günlük kaydını etkinleştirin.
`--category <category>`	Sadece belirli bir kategori için kontroller yapın, örneğin `Azure`, `Authentication`, `PowerShell` veya `Tenant Enrollment`.
`-?`, `-h`, `--help`	Yardım ve kullanım bilgilerini gösterin.

Note

setup requirements yapılandırma dosyası gerektirmez - herhangi bir dizinde çalıştırın.

`setup blueprint`

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

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

a365 setup blueprint [options]

`blueprint` Seçenekler

Option	Description
`-n`, `--agent-name <name>`	Ajan üs adı. Bu seçeneği sağladığınızda, yapılandırma dosyasına ihtiyacınız olmuyor. Komut, kiracı kimliğini otomatik olarak tespit eder.`az account show` Bunu ile `--tenant-id`geçersiz kıl.
`--tenant-id <tenantId>`	Azure AD kiracı kimliği. Overrides auto-detection. ile kullanın `--agent-name`.
`-v`, `--verbose`	Ayrıntılı çıkışı göster.
`--dry-run`	Komutu yürütmeden ne yapacağını gösterin.
`--skip-requirements`	Gereksinimler doğrulama denetimini atlayın. Dikkatli kullanın.
`--no-endpoint`	Mesajlaşma uç noktasını kaydetmeyin (yalnızca şema).
`--endpoint-only`	Yalnızca mesajlaşma uç noktasını kaydedin. Mevcut şemayı gerektirir.
`--update-endpoint <url>`	Mevcut mesajlaşma uç noktasını silin ve belirtilen URL'ye sahip yeni bir uç nokta kaydedin.
`--m365`	Bu ajanı M365 ajanı gibi gör. Üzerinde `a365 setup blueprint`, sadece veya `--endpoint-only--update-endpoint`ile etki gösterir. Mesajlaşma uç noktasını tam kurulumun bir parçası olarak kaydetmek için `a365 setup all --m365`. Varsayılan (opt-in) şeklindedir `false` .
`--show-secret`	Saklanan blueprint istemcisi gizli sırrını açık metin olarak gösterin. Kurulum adımı yapılmaz. Windows'ta, kurulumu çalıştıran aynı makine ve kullanıcı hesabını gerektirir.
`-?`, `-h`, `--help`	Yardım ve kullanım bilgilerini gösterin.

`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

Option	Description
`-?`, `-h`, `--help`	Yardım ve kullanım bilgilerini gösterin.

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ı ç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]

This command:

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.

Important

Bu komutu çalıştırmadan önce, güncellenmiş deploymentProjectPathdosyayı içeren proje klasörüne işaret ettiğini doğrulayınToolingManifest.json. 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

Option	Description
`-n`, `--agent-name <name>`	Ajan üs adı. Bu seçeneği sağladığınızda, yapılandırma dosyasına ihtiyacınız olmuyor.
`--tenant-id <tenantId>`	Azure AD kiracı kimliği. Overrides auto-detection. ile kullanın `--agent-name`.
`-v`, `--verbose`	Ayrıntılı çıkışı göster.
`--dry-run`	Komutu yürütmeden ne yapacağını gösterin.
`--remove-legacy-scopes`	Sunucu başına izinlere () geçirildikten sonra şemadan eski paylaşılan kapsamları (`McpServers.*.AllTools.ListInvoke.All`biçim) kaldırır. V2 SDK'nın canlı olarak onaylanmasından sonra sadece kullanın - V1 SDK'daki ajanlar erken çıkarılırsa araç erişimini kaybeder.
`-?`, `-h`, `--help`	Yardım ve kullanım bilgilerini gösterin.

Sunucu başına MCP izinlerine geçiş

Eski paylaşılan izinler modelinden sunucu başına izinlere geçiş yaparken kullanın --remove-legacy-scopes :

Eski paylaşılan model: ve ea9ffc3e-8a23-4a7d-836d-234d7c7565c1gibi McpServers.Mail.All paylaşılan kapsamlara sahip tek bir kaynak uygulaması kimliği (McpServers.Teams.All).
Sunucu başına model: Her MCP sunucusunun kapsamına Tools.ListInvoke.Allsahip kendi uygulama kimliği vardır.

Aşağıdaki örnekte şema uygulandıktan sonra sunucu başına izinlerin Microsoft Entra yönetim merkezi nasıl göründüğü gösterilmektedir. Work IQ Calendar MCP ve Work IQ Mail MCP gibi her MCP sunucusunun kendi temsilci Tools.ListInvoke.All kapsamı vardır. Paylaşılan McpServersMetadata.Read.All kapsam, MCP sunucusu meta verilerine erişim sağlar.

Sunucu başına API izinlerini gösteren Microsoft Entra yönetim merkezi ekran görüntüsü. İş IQ Takvimi MCP ve İş IQ Posta MCP'lerinin her birinin temsili bir Tools.ListInvoke.All kapsamı vardır. İş IQ Araçları'nın temsili bir McpServersMetadata.Read.All scope.

`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 )

a365 setup permissions bot [options]

`permissions bot` Seçenekler

Option	Description
`-n`, `--agent-name <name>`	Ajan üs adı. Bu seçeneği sağladığınızda, yapılandırma dosyasına ihtiyacınız olmuyor.
`--tenant-id <tenantId>`	Azure AD kiracı kimliği. Overrides auto-detection. ile kullanın `--agent-name`.
`-v`, `--verbose`	Ayrıntılı çıkışı göster.
`--dry-run`	Komutu yürütmeden ne yapacağını gösterin.
`-?`, `-h`, `--help`	Yardım ve kullanım bilgilerini gösterin.

`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 Microsoft 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 .

a365 setup permissions custom [options]

This command:

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 sildiğiniz 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

Option	Description
`-n`, `--agent-name <name>`	Ajan üs adı. Bu seçeneği sağladığınızda, yapılandırma dosyasına ihtiyacınız olmuyor.
`--tenant-id <tenantId>`	Azure AD kiracı kimliği. Overrides auto-detection. ile kullanın `--agent-name`.
`-v`, `--verbose`	Ayrıntılı çıkışı göster.
`--dry-run`	Komutu yürütmeden ne yapacağını gösterin.
`--resource-app-id <guid>`	Bir iç özel izin için kaynak uygulama kimliği (GUID). ile kullanın `--scopes`.
`--scopes <scopes>`	Satır içi özel izin için virgülle ayrılmış delege edilmiş kapsamlar. ile kullanın `--resource-app-id`.
`-?`, `-h`, `--help`	Yardım ve kullanım bilgilerini gösterin.

Özel izinleri inline olarak yapılandırma

Düzenleme olmadan doğrudan özel izinleri --resource-app-idkullanmak --scopes ve a365.config.json uygulamak için :

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

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

Kaynak adı Microsoft Entra'dan otomatik olarak çözülür. Bunu belirtmenize gerek yok.

Özel izinleri config dosyası üzerinden yapılandırma

Alternatif olarak, komutu customBlueprintPermissions satır içi bayrak olmadan ekleyin a365.config.json ve çalıştırın:

a365 setup permissions custom

Bu komut, Microsoft Entra'yı yapılandırılmış izinlerle uzlaştırır - yeni izinler ekler ve yapılandırmadan sildiğiniz tüm izinleri kaldırır.

`setup all`'le Tümleştirme

Yapılandırmanız özel izinler içerdiğinde, çalıştırma a365 setup all işlemi bunları tek bir toplu iş izin aşamasının parçası olarak otomatik olarak yapılandırılır. Kurulum siparişinin tamamı şu şekildedir:

Blueprint
İzinler toplu işlemi (MCP, Bot API, Özel şema izinleri — hepsi birlikte yapılandırılmış)

`setup permissions copilotstudio`

Power Platform API'sini kullanarak Copilot Studio yardımcı pilotları ç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]

This command:

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ı çağırabilmesi için devralınabilir izinleri ayarlar.

`permissions copilotstudio` Seçenekler

Option	Description
`-n`, `--agent-name <name>`	Ajan üs adı. Bu seçeneği sağladığınızda, yapılandırma dosyasına ihtiyacınız olmuyor.
`--tenant-id <tenantId>`	Azure AD kiracı kimliği. Overrides auto-detection. ile kullanın `--agent-name`.
`-v`, `--verbose`	Ayrıntılı çıkışı göster.
`--dry-run`	Komutu yürütmeden ne yapacağını gösterin.
`-?`, `-h`, `--help`	Yardım ve kullanım bilgilerini gösterin.

Aracınızın çalışma zamanında Copilot Studio yardımcı pilotları ç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: Şema ve İzinler.

Tamamlanan adımlar rolünüze bağlıdır:

Step	Global Administrator	Temsilci Kimliği Yöneticisi	Ajan Kimliği Geliştiricisi
Prerequisites check	Yes	Yes	Yes
Aracı şeması oluşturma	Yes	Yes	Yes
Miras alınabilir izinler (sadece yapay zeka takım arkadaşı)	Yes	Yes	Yes
OAuth2 izin izinleri (yönetici onayı)	Yes	GA adımı gerektirir	GA adımı gerektirir
Ajan kimlik verimleri (`--authmode s2s` veya `both`)	Yes	PowerShell fallback	PowerShell fallback

Genel Yönetici olmadan çalıştırdığınızda a365 setup all , CLI:

Mümkün olan tüm adımları (şema oluşturma ve devralınabilir izinler) tamamlar.
Kaynak başına yönetici onayı URL'leri oluşturur ve bunları öğesine a365.generated.config.jsonkaydeder.
Bir Küresel Yöneticinin OAuth2 hibelerini tamamlaması için çıktıda sonraki adımları gösterir; doğrudan bağlantı veya onay URL'si dahil.

Tip

Genel Yöneticiyseniz, a365 setup all her şeyi tek bir çalıştırmada teslime gerek olmadan tamamlar.

Gerekli en düşük izinler:

Aracı Kimliği Geliştirici rolü (şema oluşturma için)
Küresel Yönetici (OAuth2 izin verilmesi için - eğer mevcut değilse, CLI çıktıda sonraki adımları yazdırır)
Uygulama Yöneticisi veya Küresel Yönetici (S2S (Sunucudan Sunucuya) ajan kimliği için - --authmode s2s veya both; mevcut değilse, CLI kurulum özetinde PowerShell yedek bir geri dönüş yazdırır)

`setup all` Seçenekler

Option	Description
`-v`, `--verbose`	Ayrıntılı çıkışı göster.
`--dry-run`	Komutu yürütmeden ne yapacağını gösterin.
`--skip-requirements`	Gereksinimler doğrulama denetimini atlayın. Dikkatli kullanın: Önkoşullar karşılanmazsa kurulum başarısız olabilir.
`--aiteammate`	Bu parametreyi kullanarak yapay zeka takım arkadaşı ajanının akışını yalnızca planı ve izinleri sağlamaya yönlendirin. Bu parametre olmadan, blueprint ajan akışı otomatik olarak Entra kullanıcısı olmadan ajan kimlik hizmet prensibini oluşturur. Bu parametre `aiteammate` , içindeki `a365.config.json`alanı geçersiz kılanır.
`--authmode <mode>`	Ajan kimliği izni verilmesi için kimlik doğrulama deseni (sadece blueprint ajanları). `obo` (varsayılan) — ana kapsamda devredilen hibeler, yönetici rolü gerekmiyor. `s2s` — ajan kimliği SP'de uygulama rol atamaları, Uygulama Yöneticisi veya Küresel Yönetici gerektirir; Rol yoksa PowerShell geri dönüşü bastırılır. `both` — OBO (On-Bemain-Of) ve S2S hibelerini uygular. Desteklenmiyor `--aiteammate`. Ayrıca olarak da `authModea365.config.json`ayarlanabilir.
`--agent-registration-only`	Blueprint ve izinler adımlarını atlayın ve sadece temsilci kaydını çalıştırın. Başarısız kayıt adımlarını yeniden denemek için kullanın.
`--m365`	Bu ajanı M365 ajanı gibi gör. MCP Platform üzerinden mesajlaşma uç noktasını kaydeder. Varsayılan (opt-in) şeklindedir `false` .
`-n`, `--agent-name <name>`	Aracı temel adı (örneğin, `"MyAgent"`). Sağlandığında yapılandırma dosyası gerekmez. Görünen adları ve `"<name> Identity"`olarak `"<name> Blueprint"` türetir. TenantId ile otomatik olarak algılanır `az account show` (ile `--tenant-id`geçersiz kılın). ClientAppId, kiracınıza bakılarak `Agent 365 CLI` çözümlenir.
`--tenant-id <tenantId>`	Azure AD kiracı kimliği. 'den otomatik algılamayı `az account show`geçersiz kılar. Etkileşimli olmayan bir ortamda çalışırken veya belirli bir kiracıyı hedeflemek için ile kullanın `--agent-name` .
`-?`, `-h`, `--help`	Yardım ve kullanım bilgilerini gösterin.

Agent setup

Varsayılan olarak, a365 setup all blueprint ajanı akışını çalıştırır. Bu akış, Dataverse veya AI ekip arkadaşı bağımlılığı olmayan bir aracı oluşturur. Agent 365 platformuyla doğrudan iletişim kuran ajanlar için çalışır.

# Default: uses a365.config.json
a365 setup all

# Or explicitly (same result)
a365 setup all --aiteammate false

Bunun yerine yapay zeka takım arkadaşı ajan akışını çalıştırmak için --aiteammategeçin.

Bu akış aşağıdaki adımları sırayla gerçekleştirir:

Requirements validation — rolleri ve önkoşulları Azure denetler.
Blueprint creation — Entra ID Agent Blueprint uygulamasını oluşturur veya yeniden kullanır.
Batch izinleri — Microsoft Graph, Agent 365 Araçları, Mesajlaşma Botu API'si, Gözlemlenebilirlik API'si, Power Platform ve tüm özel kaynaklar için şema üzerinde temsilci izinleri yapılandırılır.
Agent Identity creation — Aracı Kimliği Graph API aracılığıyla Entra ID'de bir Aracı Kimliği oluşturur.
Aracı kaydı — Aracıyı AgentX V2 Aracı Kayıt API'sini kullanarak kaydeder.
Yapılandırma eşitleme — çalışma zamanı bağlantı ayarlarını ve gözlemlenebilirlik yapılandırmasını proje dosyalarınıza (appsettings.json, .env) yazar.

Note

AI Teammate ajanı akışı, temel setin ötesinde özel istemci uygulamanızda ek beta API izinleri gerektirir. Tam gerekli izin listesi için Özel istemci uygulaması kaydı'na bakınız.

ile yapılandırmasız kurulum `--agent-name`

Dosyanız yoksa, kurulumu tek bir a365.config.json dosya olmadan çalıştırmak için kullanın --agent-name . CLI, kiracınızı otomatik olarak algılar ve kiracınızdaki iyi bilinen Agent 365 CLI uygulama kaydını arayarak istemci uygulamasını çözümler.

# Preview what would happen (no changes made)
a365 setup all --agent-name "MyAgent" --dry-run

# Run the full setup
a365 setup all --agent-name "MyAgent"

kullanırken --agent-name:

TenantId , içinden az account showotomatik olarak algılanır. Geçersiz kılmaya geçir --tenant-id .
ClientAppId , kiracınızda adlı Agent 365 CLI bir Entra uygulaması aranarak çözülür. Bulunamazsa, CLI bir hatayla çıkar. Bu uygulamanın nasıl kaydedildiğini öğrenmek için bkz. Özel istemci uygulaması kaydı .
Görünen adlar (kimlik) ve "<name> Agent" (şema) olarak "<name> Blueprint" türetilir.
Altyapı her zaman atlanır (dış barındırma varsayılır).
Yapılandırılmış proje yolu olmadığından yapılandırma eşitlemesi (yazmaappsettings.json) atlanır.

İstemci uygulamanız gerekli izinler için yönetici onayına sahip AllPrincipals değilse, CLI bunu algılar ve etkileşimli olarak onay vermenizi ister:

The following permissions require admin consent:
  AgentIdentity.ReadWrite.All
  AgentIdentity.Create.All
  ...
Grant admin consent for these permissions now? [y/N]:

Satır içinde onay vermek için girin y . Eğer Global Administrator değilseniz, reddedin — CLI, kurulum özetinde bir Küresel Yönetici için sonraki adımları yazdırır.

Ajan kimlik verimleri (`--authmode`)

Varsayılan olarak, a365 setup all ajan kimlik hizmeti anaobo (mod) üzerinde principal kapsamlı delege edilmiş grantlar oluşturur. Bu hibeler yönetici rolü gerektirmez.

Hibe türünü kontrol etmek için kullanım --authmode :

Value	Behavior	Minimum role
`obo` (varsayılan)	Ajanı kimliği SP üzerine ana kapsamlı delegasyonlu hibeler	Hiçbiri (herhangi bir kimlik doğrulaması yapılmış kullanıcı)
`s2s`	Ajan kimliği SP'de uygulama rol atamaları	Uygulama Yöneticisi veya Küresel Yönetici
`both`	Hem OBO hem hibeleri hem de S2S uygulama rol atamalarını devretti	S2S kısmı için S2S rolü (yukarıda)

# Default — OBO delegated grants (no admin role needed)
a365 setup all

# S2S app role assignments
a365 setup all --authmode s2s

# Both OBO and S2S
a365 setup all --authmode both

Giriş yapan kullanıcı S2S bağışları için gerekli rolü karşılamadığında, CLI kurulum özetinde bir PowerShell yedek blok yazdırır. Bir yönetici bu uygulamayı çalıştırarak atamaları tamamlayabilir.

Bayraksız her koşuda uygulanacak şekilde ayarlandı authModea365.config.json :

{
  "authMode": "s2s"
}

Note

--authmode desteklenmiyor --aiteammate. Yapay zeka takım arkadaşı ajanlar, ajan kullanıcı kimliği üzerinden otomatik olarak OBO kullanır.

Config sync

Başarılı bir çalıştırmanın ardından CLI, çalışma zamanı ayarlarını proje dosyalarınıza otomatik olarak yazar:

Setting	Written to	Description
`Connections.ServiceConnection`	`appsettings.json` / `.env`	Şema istemci kimliği, istemci gizli anahtarı, kiracı kimliği ve belirteç uç noktası
`Agent365Observability`	`appsettings.json` / `.env`	Telemetri dışarı aktarma için Aracı Kimliği (Aracı Kimliği), şema kimliği, kiracı kimliği, istemci kimliği ve istemci gizli dizisi
`TokenValidation`	`appsettings.json`	Belirteç doğrulama ayarları (DW olmayanlar için varsayılan olarak devre dışı)
`ConnectionsMap`	`appsettings.json` / `.env`	Bağlantı eşleme için varsayılan hizmet URL'si

CLI, mevcut değilse dosyayı oluşturur ve yapılandırmanızın geri kalanının üzerine yazmadan tek tek alanları güncelleştirir.

Başarısız bir kaydı yeniden deneme

Kurulum şemayı ve izinleri başarıyla tamamlarsa ancak aracı kaydı sırasında başarısız olursa, önceki çalışmayı yinelemeden yalnızca bu adımı yeniden denemek için kullanın --agent-registration-only :

a365 setup all --agent-registration-only

Geri Bildirim

Bu sayfayı yararlı buldunuz mu?

Last updated on 2026-05-07

Aracı 365 CLI setup komut başvurusu

Syntax

Options

Önerilen yürütme sırası

setup requirements

requirements Seçenekler

setup blueprint

blueprint Seçenekler

setup permissions

Options

Subcommands

setup permissions mcp

permissions mcp Seçenekler

Sunucu başına MCP izinlerine geçiş

setup permissions bot

permissions bot Seçenekler

setup permissions custom

permissions custom Seçenekler

Özel izinleri inline olarak yapılandırma

Özel izinleri config dosyası üzerinden yapılandırma

setup all'le Tümleştirme

setup permissions copilotstudio

permissions copilotstudio Seçenekler

setup all

setup all Seçenekler

Agent setup

ile yapılandırmasız kurulum --agent-name

Kurulum sırasında yönetici onayı

Ajan kimlik verimleri (--authmode)

Config sync

Başarısız bir kaydı yeniden deneme

Geri Bildirim

Ek kaynaklar

Aracı 365 CLI `setup` komut başvurusu

`setup requirements`

`requirements` 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`'le Tümleştirme

`setup permissions copilotstudio`

`permissions copilotstudio` Seçenekler

`setup all`

`setup all` Seçenekler

ile yapılandırmasız kurulum `--agent-name`

Ajan kimlik verimleri (`--authmode`)