Menerbitkan agen ke pusat admin Microsoft

Gunakan perintah a365 publish untuk mengemas agen Anda, lalu unggah paket tersebut ke pusat admin Microsoft 365. Setelah penerbitan, Anda dapat membuat instans agen di organisasi Anda dan mengelola agen tersebut.

Prasyarat

Sebelum mulai, pastikan Anda menyiapkan item berikut.

Akun dan izin yang diperlukan

  • Penyewa Microsoft 365 dengan salah satu peran berikut (diperlukan untuk langkah pengunggahan Pusat Admin):

    • Administrator Global

Alat yang diperlukan

Langkah-langkah penyiapan yang diperlukan

Sebelum memublikasikan, selesaikan langkah-langkah berikut:

  1. Buat cetak biru agen - Ikuti langkah penyiapan untuk membuat cetak biru agen Anda.
  2. Uji agen secara lokal - Verifikasi agen Anda berfungsi dengan baik dengan menggunakan Agents Playground (lihat Uji agen secara lokal).
  3. Siapkan file konfigurasi - Pastikan a365.config.json dan a365.generated.config.json sudah terbaru.

Perintah menerbitkan

Jalankan a365 publish perintah:

a365 publish

Catatan

Menjalankan a365 publish -h akan menampilkan semua opsi yang didukung oleh perintah ini.

Apa yang dilakukan perintah ini:

  1. Memperbarui manifes - Memperbarui manifest.json dengan ID cetak biru agen Anda.
  2. Buat paket: - Mengemas manifest.json dan ikon ke dalam manifest.zip.
  3. Tampilkan instruksi - Menampilkan petunjuk langkah demi langkah untuk mengunggah melalui pusat admin Microsoft 365.

Catatan

Perintah ini a365 publish berfungsi untuk agen dan rekan tim AI. Untuk agen yang disediakan dengan menggunakan --agent-name (config-free), pastikan a365.generated.config.json ada di direktori kerja Anda sebelum menjalankan a365 publish, karena perintah membaca ID cetak biru dari file ini.

Unggah pusat admin

Setelah a365 publish selesai, ikuti instruksi yang muncul untuk mengunggah agen Anda:

  1. Buka pusat admin Microsoft 365.
  2. Arahkan ke Agen>Semua agen.
  3. Pilih Unggah agen kustom.
  4. Unggah file manifest.zip dari folder manifest pada proyek Anda.

Untuk informasi selengkapnya, lihat Mengunggah agen ke pusat admin Microsoft 365.

Verifikasi publikasi berhasil

Gunakan daftar periksa berikut untuk memverifikasi agen Anda berhasil dipublikasikan:

✅ Publikasi melalui CLI berhasil
✅ manifest dibuat dengan manifest.json dan manifest.zip
✅ Agen ditampilkan di pusat admin Microsoft

Output CLI

Pesan keluaran berikut akan muncul jika perintah publikasi berhasil:

✅ Manifest updated successfully
✅ manifest.zip created successfully
✅ Instruksi unggahan langkah demi langkah ditampilkan

Jika perintah gagal, tinjau pesan kesalahan dan pastikan Anda telah menyelesaikan penyiapan blueprint.

Kemungkinan kesalahan:

Error Langkah untuk menangani
Agent blueprint ID not found Jalankan a365 setup untuk menyelesaikan penyiapan cetak biru.
Permissions missing Jalankan kembali penyiapan dengan a365 setup permissions perintah.

Ikuti langkah-langkah ini saat penerbitan gagal.

File manifes

Anda dapat menguji file berikut di folder manifest dengan menggunakan perintah PowerShell Test-Path.

# 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

Catatan

Jika Anda tidak melihat file-file ini, coba jalankan a365 publish perintah lagi.

Agen muncul di pusat admin

Catatan

Setelah mengunggah, diperlukan waktu 5-10 menit agar agen Anda muncul di pusat admin dan Teams. Penundaan ini normal.

Konfirmasikan bahwa agen hadir dengan menggunakan langkah-langkah berikut:

  1. Buka Pusat admin Microsoft 365.
  2. Arahkan ke Agen>Semua agen.
  3. Agen Anda muncul dalam daftar.

Berikut adalah tabel yang menunjukkan detail yang dapat Anda temukan:

Bidang Apa yang harus diperiksa
Nama Nama agen Anda (dari manifest.json)
Versi Nomor versi (misalnya, 1.0.0)
Penerbit Nama organisasi Anda
Ketersediaan Tersedia/Semua Pengguna

Lihat juga

Langkah berikutnya

Setelah Anda menerbitkan agen, buatlah sebuah instance agar Anda dapat mengonfigurasi dan menggunakannya di tenant Anda.

Buat instans agen

Pemecahan masalah

Masalah umum saat menerbitkan agen ke pusat admin Microsoft 365.

Kiat

Panduan Pemecahan Masalah Agent 365 berisi rekomendasi pemecahan masalah tingkat tinggi, praktik terbaik, dan tautan ke konten pemecahan masalah untuk setiap bagian dari siklus hidup pengembangan Agent 365.

Perintah penerbitan gagal

Gejala:

  • Kesalahan selama a365 publish
  • manifest.zip tidak dibuat

Penyebab akar:

  • Penyiapan tidak selesai
  • Kesalahan validasi manifes
  • Izin tidak memadai

Solusi:

  1. Verifikasi bahwa penyiapan telah selesai.

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

  2. Jalankan perintah publikasi dan ikuti perintahnya.

Unggahan gagal di pusat admin

Gejala:

  • Kesalahan saat mengunggah manifest.zip di pusat admin Microsoft 365
  • Agen tidak muncul setelah diunggah

Penyebab akar:

  • Hak akses tidak memadai di pusat admin
  • Tidak valid atau kedaluwarsa manifest.zip

Solusi:

  1. Pastikan Anda memiliki peran Administrator Global.
  2. Jalankan a365 publish lagi untuk menghasilkan manifest.zip.
  3. Coba unggah kembali dengan mengikuti langkah-langkah unggah.

Untuk bantuan selengkapnya, lihat Mengunggah agen ke pusat admin Microsoft 365.

  • Last updated on