Aracılığıyla paylaş


Aracı 365 CLI develop 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ı geliştirme için MCP araç sunucularını yönetin. komutu, develop aracı geliştirme için MCP (Model Bağlam Protokolü) araç sunucularını yönetme seçenekleri sağlar. Kullanılabilir sunucuları listeleyebilir, yapılandırılmış sunucuları görüntüleyebilir ve aracı yapılandırmanızdan MCP sunucuları ekleyebilir veya kaldırabilirsiniz.

Gereken en düşük rol: Yok (yerel bildirim yönetimi)

Sözdizimi

a365 develop [command] [options]

Options

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
-?, -h, --help Yardım ve kullanım bilgilerini gösterin.

develop list-available

Katalogda kullanılabilen tüm MCP sunucularını listeleyin (yükleyebilecekleriniz).

a365 develop list-available [options]

Bu komut, katalogda kullanılabilen tüm MCP sunucularını görüntüler ve aracı geliştirmeniz için bunları yükleyebilirsiniz.

list-available Seçenekler

Seçenek Description
-c, --config <config> Yapılandırma dosyası yolu. Varsayılan: a365.config.json
--dry-run Komutu yürütmeden ne yapacağını gösterin.
--skip-auth Kimlik doğrulamayı atlayın. Yalnızca test için. Komut büyük olasılıkla geçerli kimlik doğrulaması olmadan başarısız olur.
-?, -h, --help Yardım ve kullanım bilgilerini gösterin.

develop list-configured

Şu anda yapılandırılmış OLAN MCP sunucularını yerel ToolingManifest.json'inizden listeleyin.

a365 develop list-configured [options]

Bu komut, yerel ToolingManifest.json dosyanızda yapılandırdığınız tüm MCP sunucularını gösterir.

list-configured Seçenekler

Seçenek Description
-c, --config <config> Yapılandırma dosyası yolu. Varsayılan: a365.config.json
--dry-run Komutu yürütmeden ne yapacağını gösterin.
-?, -h, --help Yardım ve kullanım bilgilerini gösterin.

develop add-mcp-servers

Geçerli aracı yapılandırmasına MCP Sunucuları ekleyin.

a365 develop add-mcp-servers [<servers>...] [options]

Bu komut, belirtilen MCP sunucularını proje klasörünüzde öğesine ToolingManifest.json ekler. Aracı şemasına izin vermez.

Önemli

Bu komut yalnızca güncelleştirir ToolingManifest.json ; aracı şemasına izin vermez. İzinlerin nasıl uygulanacağı, kurulum sürecinde nerede olduğunuz bağlıdır:

  • İlk kurulumdan önce: ile a365 setup alldevam edin. MCP izinleri, ilk şema oluşturma işleminin bir parçası olarak uygulanır.
  • Şema zaten var olduktan sonra: Genel Yönetici ayrı olarak çalıştırılmalıdır a365 setup permissions mcp . Yöneticinin, güncelleştirilmiş a365 config displayöğesini içeren proje klasörüne olan noktalarında bunu deploymentProjectPatha365.config.json doğrulamak için önce komutunu çalıştırması ToolingManifest.json gerekir.

add-mcp-servers Bağımsız değişken

Aracı yapılandırmanıza eklemek için bir veya daha fazla MCP sunucu adı belirtin. Boşluklarla ayrılmış birden çok sunucu adı sağlayabilirsiniz.

Argument Description
<servers> Eklenecek MCP sunucularının adları

add-mcp-servers Seçenekler

Yapılandırma dosyası seçimi ve kuru çalıştırma testi de dahil olmak üzere komutun add-mcp-servers davranışını özelleştirmek için bu seçenekleri kullanın.

Seçenek Description
-c, --config <config> Yapılandırma dosyası yolu. Varsayılan: a365.config.json
--dry-run Komutu yürütmeden ne yapacağını gösterin.
-?, -h, --help Yardım ve kullanım bilgilerini gösterin.

develop remove-mcp-servers

MCP Sunucularını geçerli aracı yapılandırmasından kaldırın.

a365 develop remove-mcp-servers [<servers>...] [options]

Bu komut, belirtilen MCP sunucularını geçerli aracı yapılandırmanızdan kaldırır.

remove-mcp-servers Bağımsız değişken

Argument Description
<servers> Kaldırılacak MCP sunucularının adları

remove-mcp-servers Seçenekler

Seçenek Description
-c, --config <config> Yapılandırma dosyası yolu. Varsayılan: a365.config.json
--dry-run Komutu yürütmeden ne yapacağını gösterin.
-?, -h, --help Yardım ve kullanım bilgilerini gösterin.

develop add-permissions

MCP sunucularına erişmek için özel uygulamalar yapılandırmanız gereken geliştirme senaryoları için Microsoft Entra uygulamalara MCP sunucusu API izinleri ekleyin.

a365 develop add-permissions [options]

add-permissions Seçenekler

Araç bildirimindeki değerlerden yararlanarak uygulama kaydınıza gerekli API izinlerini ve kapsamlarını eklemek için bu seçenekleri kullanın.

Seçenek Description
-c, --config <config> Yapılandırma dosyası yolu (varsayılan: a365.config.json)
-m, --manifest <manifest> ToolingManifest.json Yolu (varsayılan: <deploymentProjectPath>/ToolingManifest.json)
--app-id <app-id> İzin eklemek için uygulama (istemci) kimliği (varsayılan: clientAppId yapılandırmadan)
--scopes <scopes> Eklenecek belirli kapsamlar (boşlukla ayrılmış) (varsayılan: Tüm kapsamlar )ToolingManifest.json
--dry-run Değişiklik yapmadan komutun ne yapacağını göster
-v, --verbose Ayrıntılı çıkışı göster
-?, -h, --help Yardım ve kullanım bilgilerini gösterin.

Önemli

--app-id veya clientAppId tarafından belirtilen uygulamanın Microsoft Entra'de Application.ReadWrite.All izni olmalıdır. Bu komut özel istemci uygulamaları içindir. Aracı şemalarının izinlerini yapılandırmak için bunun yerine kullanın a365 setup permissions mcp .

develop get-token

Etkileşimli tarayıcı kimlik doğrulamasını kullanarak geliştirme sırasında MCP sunucularını test etme için taşıyıcı belirteçleri alın.

a365 develop get-token [options]

get-token Seçenekler

Erişim belirteci istemek, kapsamları denetlemek, davranışı yenilemek ve çıkış biçimini seçmek için bu seçenekleri kullanın.

Seçenek Description
-c, --config <config> Yapılandırma dosyası yolu (varsayılan: a365.config.json)
--app-id <app-id> Kimlik doğrulaması için uygulama (istemci) kimliği (varsayılan: clientAppId yapılandırmadan)
-m, --manifest <manifest> ToolingManifest.json Yolu (varsayılan: <deploymentProjectPath>/ToolingManifest.json)
--scopes <scopes> İstekte bulunacak belirli kapsamlar (boşlukla ayrılmış) (varsayılan: Okuma yeri ToolingManifest.json)
-o, --output <output> Çıkış biçimi: table, jsonveya raw (varsayılan: table)
--force-refresh Önbelleği atlayarak belirteci yenilemeye zorlama
--resource <resource> Belirteci almak için kaynak anahtar sözcüğü: mcp (varsayılan) veya powerplatform
--resource-id <resource-id> Anahtar sözcükler kapsamında --resource olmayan kaynaklar için özel kaynak uygulama kimliği (GUID)
-v, --verbose Tam belirteç de dahil olmak üzere ayrıntılı çıkışı göster
-?, -h, --help Yardım ve kullanım bilgilerini gösterin.

get-token kaynak seçenekleri

Farklı Azure kaynaklarının belirteçlerini almak için --resource ve --resource-id seçeneklerini kullanın:

  • --resource: Önceden tanımlanmış bir kaynağı seçmek için anahtar sözcük kullanın:
    • mcp (varsayılan): MCP sunucuları için Aracı 365 Araçları
    • powerplatform: Power Platform API'si
  • --resource-id: Anahtar sözcükler kapsamında olmayan kaynaklar için özel bir kaynak uygulama kimliği (GUID) girin

Önemli

--resource ve --resource-id birlikte kullanılamaz. Herhangi bir seçeneği kullandığınızda, öğesini ekleyin --scopes. Yalnızca varsayılan MCP akışı bildirim tabanlı kapsam çözümlemesini destekler.

develop start-mock-tooling-server

Test ve geliştirme amacıyla sahte bir araç sunucusu başlatın.

a365 develop start-mock-tooling-server [options]

Bu komut, test ve geliştirme amacıyla sahte bir araç sunucusu başlatır. Bu sunucuyu kullanarak, gerçek sunucu uygulamalarına gerek kalmadan MCP sunucu etkileşimlerinin benzetimini yapabilirsiniz.

start-mock-tooling-server Seçenekler

Komutun davranışını start-mock-tooling-server özelleştirmek için bu seçenekleri kullanın.

Seçenek Description Varsayılan
-p, --port <port> Sahte sunucu için bağlantı noktası numarası 5309
-v, --verbose Ayrıntılı günlük kaydını etkinleştir false
-?, -h, --help Yardım ve kullanım bilgilerini gösterme -
-bg Sunucuyu yeni bir terminalde çalıştırma -