Aracıyı Microsoft yönetim merkezinde yayımlama

a365 publish komutunu kullanarak aracınızı paketleyin ve paketi Microsoft 365 yönetim merkezine yükleyin. Yayınladıktan sonra, kurumunuzda aracı örnekleri oluşturabilir ve aracıyı yönetebilirsiniz.

Ön koşullar

Başlamadan önce, aşağıdaki malzemelere sahip olduğunuzdan emin olun.

Gerekli hesaplar ve izinler

  • Microsoft 365 kiracısı, aşağıdaki rollerden birine sahip (Admin Center yükleme adımı için gereklidir):

    • Genel Yönetici

Gerekli araçlar

Gerekli kurulum adımları

Yayınlamadan önce şu adımları tamamlayın:

  1. Aracı taslağı oluşturun - Aracı taslağınızı oluşturmak için kurulum adımını takip edin.
  2. Aracıyı yerelde test et – Agent Playground'u kullanarak aracınızın doğru çalıştığından emin olun (bkz. Aracıları yerelde test etme).
  3. Yapılandırma dosyalarını hazırlayın - a365.config.json ve a365.generated.config.json dosyalarının güncel olduğundan emin olun.

Yayımla komutu

a365 publish komutunu çalıştırın:

a365 publish

Not

a365 publish -h komutu çalıştırıldığında, bu komutun desteklediği tüm seçenekler gösterilir.

Bu komut ne yapar:

  1. Manifestoyu güncelle - Aracı şablonu kimliğinizle manifest.json güncellenir.
  2. Paket oluştur - Paketler manifest.json ve simgeler manifest.zip içine.
  3. Yazdırma talimatları - Microsoft 365 yönetim merkezi üzerinden yükleme için adım adım talimatları gösterir.

Not

a365 publish komutu hem aracılar hem de yapay zeka takım arkadaşları için çalışır. --agent-name (config-free) yöntemiyle sağlanan aracılar için, a365 publish komutunu çalıştırmadan önce, a365.generated.config.json dosyasının çalışma dizininizde mevcut olduğundan emin olun; çünkü komut, blueprint kimliğini bu dosyadan okur.

Yönetici merkezine yükleme

a365 publish tamamlandıktan sonra, aracınızı yüklemek için ekranda gösterilen talimatları izleyin:

  1. Microsoft 365 yönetici merkezi'ne gidin.
  2. Aracılar>Tüm Aracılar bölümüne gidin.
  3. Özel aracı yükle'yi seçin.
  4. Projenizdeki manifest klasöründen manifest.zip dosyasını yükleyin.

Daha fazla bilgi için Microsoft 365 yönetim merkezine aracı yükleme sayfasına bakın.

Başarılı yayınlamayı doğrulayın

Aracınızın başarıyla yayınlandığını doğrulamak için aşağıdaki kontrol listesini kullanın:

✅ CLI yayınlama başarılı
✅ manifest klasörü, manifest.json ve manifest.zip ile oluşturuldu
✅ Aracı Microsoft 365 yönetim merkezinde görünür

CLI çıktısı

Yayınlama komutu başarılı olduğunda bu çıkış mesajlarını görürsünüz:

✅ Manifest updated successfully
✅ manifest.zip created successfully
✅ Adım adım yükleme talimatları ekrana yazdırıldı

Komut başarısız olursa, hata mesajlarını inceleyin ve blueprint kurulumunu tamamladığınızdan emin olun.

Olası hatalar:

Hata Çözüm adımları
Agent blueprint ID not found Blueprint kurulumunu tamamlamak için a365 setup komutunu çalıştırın.
Permissions missing Kurulumu a365 setup permissions komutu ile yeniden çalıştırın.

Yayınlama başarısız olduğunda bu adımları izleyin.

Bildirim dosyaları

manifest klasöründeki aşağıdaki dosyaları Test-Path PowerShell komutunu kullanarak test edebilirsiniz.

# Check manifest folder and contents exists
Test-Path <deploymentProjectPath>/manifest/
Test-Path <deploymentProjectPath>/manifest/manifest.json
Test-Path <deploymentProjectPath>/manifest/manifest.zip
# All should return: True

Not

Eğer bu dosyaları görmüyorsanız, a365 publish komutunu tekrar çalıştırmayı deneyin.

Aracı yönetim merkezinde görünür

Not

Yüklemeden sonra, aracınızın yönetim merkezinde ve Teams'te görünmesi 5-10 dakika sürebilir. Bu gecikme normaldir.

Aracının var olduğunu aşağıdaki adımlarla doğrulayın:

  1. Microsoft 365 yönetim merkezine gidin.
  2. Aracılar>Tüm Aracılar bölümüne gidin.
  3. Aracınız listede yer alıyor.

Aşağıdaki tablo bulabileceğiniz ayrıntıları göstermektedir:

Alan Denetlenmesi Gerekenler
Ad Aracınızın adı (şuradan: manifest.json)
Sürüm Sürüm numarası (örneğin, 1.0.0)
Yayıncı Kuruluşunuzun adı
Uygunluk Kullanılabilir/Tüm Kullanıcılar

Ayrıca bakın

Sonraki adımlar

Aracınızı yayınladıktan sonra, kiracınızda yapılandırıp kullanabilmeniz için bir örnek oluşturun.

Aracı örneği oluştur

Sorun giderme

Microsoft 365 yönetim merkezine aracı yayınlarken karşılaşılan yaygın sorunlar.

İpucu

Agent 365 Sorun Giderme Kılavuzu yüksek seviyeli sorun giderme önerileri, en iyi uygulamalar ve Agent 365 geliştirme yaşam döngüsünün her aşamasına yönelik sorun giderme içeriğine bağlantılar sunar.

Yayımla komutu başarısız olur

Belirtiler:

  • a365 publish işlemi sırasında hata oluştu
  • manifest.zip oluşturulmamıştır

Temel nedenler:

  • Kurulum tamamlandı
  • Manifest doğrulama hataları
  • Yetersiz izinler

Çözüm:

  1. Kurulumun tamamlandığını doğrulayın.

    Get-Content a365.generated.config.json | ConvertFrom-Json | Select-Object agentBlueprintId

  2. publish komutunu çalıştırın ve istemleri takip edin.

Yönetim merkezinde yükleme başarısız

Belirtiler:

  • Microsoft 365 yönetim merkezinde manifest.zip yüklenirken hata
  • Yüklemeden sonra aracı görünmüyor

Temel nedenler:

  • Yönetim merkezinde yetersiz izinler
  • Geçersiz veya güncel olmayan manifest.zip

Çözüm:

  1. Genel Yönetici rolüne sahip olduğunuzdan emin olun.
  2. a365 publish komutunu tekrar çalıştırarak yeni bir manifest.zip oluşturun.
  3. Yükleme adımlarını takip ederek tekrar yüklemeyi deneyin.

Daha fazla yardım için Microsoft 365 yönetim merkezine aracı yükleme sayfasına bakın.

  • Last updated on