Memulai pengembangan Agent 365

Agent 365 mendukung berbagai implementasi agen. Agen dapat membantu pengguna sesuai permintaan, berjalan secara mandiri di latar belakang, atau beroperasi dengan identitas penggunanya sendiri di Microsoft 365. Memahami pola yang paling menggambarkan agen Anda sangat penting karena hal ini menentukan model identitas agen, akses apa yang dimilikinya ke sumber daya Microsoft 365, serta langkah-langkah siklus hidup yang berlaku.

Jenis agen

Sebelum Anda mulai, tanyakan pada diri Anda: Jenis agen apa yang sedang saya buat?

Ada dua tipe agen tergantung pada jenis akses yang mereka miliki:

Jenis agen Ikhtisar
Agen Bekerja atas nama pengguna dengan akses delegasi, atau beroperasi sebagai aplikasi dengan izin terbatas. Terdaftar sebagai aplikasi Microsoft Entra atau blueprint identitas agen.
Rekan tim AI Beroperasi dengan identitas pengguna mereka sendiri di Microsoft 365, termasuk kotak surat, status Teams, dan entri direktori. Jenis agen ini hanya tersedia untuk penyewa yang berpartisipasi dalam program pratinjau Frontier.

Agen

Agen bekerja atas nama pengguna. Agen merespons permintaan, menjalankan tugas di latar belakang, terhubung ke API, memproses data, dan menginisiasi tindakan.

Agen hadir dalam beragam bentuk. Beberapa berbasis percakapan – pengguna menanyakan sesuatu dan agen merespons. Beberapa berjalan secara otomatis di latar belakang—dipicu oleh jadwal, acara, atau pesan masuk—tanpa keterlibatan aktif siapa pun. Ada yang melakukan keduanya.

Skenario contoh:

  • Pengguna meminta agen untuk meringkas email yang belum dibaca dan menyusun draf balasan. Agen menyelesaikan tugasnya, hanya mengakses sumber daya yang dapat diakses oleh pengguna, dan mengembalikan hasilnya.
  • Seorang agen layanan pelanggan membantu insinyur dukungan teknis menelusuri basis pengetahuan internal dan menyusun respons selama sesi dukungan langsung.
  • Agen pemantauan kepatuhan berjalan setiap malam, memindai situs SharePoint yang diakses agen untuk mencari pelanggaran kebijakan, dan membuat laporan audit—tanpa pengawasan langsung.
  • Agen pemrosesan pesanan mengambil pesanan penjualan baru dari antrean, memperbarui CRM, dan mengirim email konfirmasi—semuanya tanpa campur tangan manusia.

Basis identitas:

Secara tradisional, Anda mendaftarkan agen sebagai aplikasi Microsoft Entra. Pendekatan itu masih berlaku. Ke depannya, Anda juga dapat membangun agen menggunakan ID Agen Microsoft Entra melalui blueprint identitas agen—definisi kemampuan agen, akses alat yang diizinkan, dan batasan kepatuhan yang disetujui oleh TI serta ditegakkan melalui tata kelola. Membangun berdasarkan blueprint adalah jalur yang direkomendasikan untuk agen baru. Ini membuka akses ke alat Work IQ yang diatur, perlindungan data Microsoft Purview, pemantauan ancaman Microsoft Defender, dan tata kelola Entra ID—menjadikan agen Anda identitas perusahaan yang diatur sepenuhnya sejak hari pertama. Jika pengguna agen Anda masuk melalui penyedia identitas pihak ketiga, lihat Integrasi ID Agen Microsoft Entra dengan penyedia identitas pihak ketiga.

Rekan tim AI

Penting

Untuk mendapatkan akses awal ke tipe agen ini, Anda harus menjadi bagian dari program pratinjau Frontier. Frontier menghubungkan Anda secara langsung dengan inovasi AI terbaru dari Microsoft. Pratinjau Frontier tunduk pada persyaratan pratinjau yang ada dari perjanjian pelanggan Anda. Karena fitur-fitur ini masih dalam pengembangan, ketersediaan dan kemampuannya dapat berubah seiring waktu.

Rekan tim AI beroperasi di Microsoft 365 menggunakan identitas agennya sendiri. Anda dapat memberikannya kemampuan seperti mengirim dan menerima email melalui kotak surat miliknya sendiri, berpartisipasi dalam percakapan 1:1 dan grup di Teams, serta terdaftar di direktori dan metadata organisasi dengan relasi manajer yang ditetapkan. Pengguna dapat berinteraksi dengannya melalui berbagai titik masuk Microsoft 365 yang sudah dikenal, seperti @mentions, email, undangan kalender, maupun obrolan Teams.

Buat agen-agen ini dari blueprint agen, yaitu definisi kemampuan agen, akses alat yang diizinkan, dan batasan kepatuhan yang telah disetujui dan diberlakukan oleh TI. Setiap instans agen mewarisi model identitas, izin, dan kebijakan dari blueprint identitas agen induknya.

Apa yang dilakukan agen—apakah bersifat percakapan, berjalan di latar belakang, atau keduanya—bergantung pada rancangan Anda. Sebagian agen sangat interaktif, merespons pesan dan mendukung aktivitas kerja secara waktu nyata. Yang lain memproses tugas di latar belakang, menindaklanjuti email atau acara tanpa keterlibatan pengguna langsung. Agen beroperasi dengan identitas penggunanya sendiri, dan tindakannya diatur dan dapat diaudit melalui identitas tersebut.

Jika Anda sudah memiliki agen, Anda tidak perlu memulai dari awal. Anda dapat mengembangkan agen yang ada agar beroperasi dengan identitas sendiri dengan menambahkan konfigurasi identitas dan blueprint seperti yang dijelaskan lebih lanjut dalam panduan ini.

Skenario contoh:

  • Tambahkan rekan tim AI onboarding SDM ke saluran onboarding Teams karyawan baru. Agen tersebut mengirimkan email sambutan dari kotak suratnya sendiri, menjadwalkan pertemuan orientasi di kalendernya sendiri, dan merespons pertanyaan menggunakan kemampuan yang dikonfigurasi untuk instans agen tersebut.
  • Tetapkan hubungan manajer dalam metadata direktori ke rekan tim AI pengadaan. Karyawan mengirim email permintaan pembelian ke kotak suratnya. Agen memproses permintaan, melakukan kueri ke sistem ERP dan keuangan menggunakan akses alat Work IQ yang diatur, dan merespons dengan persetujuan atau eskalasi dari identitasnya sendiri.
  • Tambahkan rekan tim AI penelitian ke situs SharePoint dan saluran Teams tim proyek. Ini dapat menampilkan dokumen yang relevan selama rapat, merespons dalam utas percakapan, dan menyusun laporan status mingguan menggunakan izin dan alat yang dikonfigurasi untuk agen tersebut.

Basis identitas:

Berdasarkan blueprint identitas agen, yang menghasilkan ID Agen Microsoft Entra dan akun pengguna terkait: selalu diperlukan.

Menambahkan kapabilitas Agent 365 secara bertahap

Agent 365 tidak harus diadopsi secara keseluruhan. Anda tidak perlu membangun rekan tim AI pada hari pertama - atau sama sekali, jika skenario Anda tidak memerlukannya. Kemampuan dapat diadopsi secara bertahap, dimulai dari kebutuhan agen Anda saat ini dan diperluas seiring berkembangnya kebutuhan.

Mengapa membangun blueprint identitas agen?

Saat Anda membuat cetak biru identitas agen, CLI Agent 365 menyediakan ID Agen Microsoft Entra untuk agen Anda - identitas kelas satu di penyewa Anda, tunduk pada kebijakan tata kelola perusahaan yang sama dengan pengguna manusia. Identitas tunggal tersebut merupakan fondasi bagi manfaat keamanan yang berlaku secara otomatis untuk setiap agen berbasis blueprint:

Keuntungan Apa artinya bagi agen Anda
Tata kelola Microsoft Entra ID Siklus hidup identitas dan akses agen dikelola melalui Akses Bersyarat, perlindungan identitas, dan tinjauan akses yang sama yang berlaku untuk pengguna manusia.
Microsoft Purview Setiap interaksi data yang dilakukan agen tunduk pada label sensitivitas, kebijakan DLP, dan kebijakan retensi penyewa Anda—secara otomatis, tanpa kode tambahan.
Microsoft Defender Perilaku agen terus dipantau untuk anomali dan ancaman. Aktivitas mencurigakan akan memicu peringatan dan alur kerja respons yang sama seperti untuk pengguna mana pun di penyewa.

Manfaat ini berlaku untuk semua agen berbasis blueprint, termasuk agen dengan akses yang didelegasikan pengguna maupun agen yang beroperasi dengan identitas mereka sendiri, segera setelah blueprint dibuat. Anda tidak perlu mengonfigurasinya secara terpisah.

Empat tingkat kemampuan di bawah ini mewakili level yang dapat Anda adopsi secara bertahap. Tabel berikut menunjukkan apa yang tersedia untuk Agent 365 berdasarkan titik awal Anda:

Kemampuan Agen mesin kustom Microsoft 365 Semua agen lain 1
Daftar ✓ 2 ✓
Observabilitas ✓ ✓
Work IQ ✓ ✓
Rekan tim AI ✓ 3 ✓ 3

1 Agen yang saat ini terdaftar sebagai aplikasi Microsoft Entra harus terlebih dahulu membuat blueprint identitas agen untuk memulai kemampuan apa pun di kolom ini.

2 Agen mesin kustom Microsoft 365 sudah terdaftar menggunakan pendaftaran aplikasi Microsoft Entra yang ada — tidak diperlukan penyiapan tambahan.

3 Rekan tim AI untuk agen mesin kustom Microsoft 365 memerlukan blueprint identitas agen. Hanya tersedia untuk peserta program Frontier.

Daftar

Saat Anda mendaftarkan agen, Anda membuatnya terlihat dan dapat dikelola di pusat admin Microsoft 365. Admin dapat menemukannya dan melihatnya di inventaris agen organisasi mereka.

Yang Anda dapatkan:

  • Agen Anda muncul di pusat admin Microsoft 365; admin dapat menemukannya dan melihatnya di inventaris agen organisasi mereka.
  • Agen berbasis Blueprint juga memperoleh manfaat tata kelola Entra ID, Purview, dan Defender secara penuh seperti yang dijelaskan dalam Mengapa membangun blueprint identitas agen?

Apa yang Anda bangun:

Daftarkan agen Anda menggunakan blueprint atau pendaftaran aplikasi Microsoft Entra yang ada.

Catatan

Jika Anda buat agen di Google Vertex AI atau Amazon Bedrock, pendaftaran tidak membutuhkan pekerjaan pengembangan sama sekali. API Google dan Amazon secara otomatis menarik agen. Tidak ada integrasi SDK, tidak ada blueprint, dan tidak diperlukan perubahan kode. Setelah pendaftaran, Anda dapat menggunakan Agent 365 SDK untuk menambahkan observabilitas, akses alat Work IQ, dan kemampuan lainnya secara bertahap. Untuk memulai, baca Mendaftarkan Agen Google Vertex AI dan Amazon Bedrock.

Cara membuat agen:

Gunakan pengaturan yang dipandu AI dan jawab pertanyaan mengenai tipe agen. Pengaturan yang dipandu AI melakukan langkah-langkah yang diperlukan untuk tingkat ini. Agen mesin kustom Microsoft 365 kini sudah dapat dikenali menggunakan pendaftaran aplikasi Microsoft Entra yang sudah ada.

Observabilitas

Setelah Anda mendaftarkan agen, berinvestasilah dalam observabilitas. Investasi ini memberi TI, tim keamanan, dan tim teknik Anda visibilitas tentang apa yang sebenarnya dilakukan agen Anda. Setiap panggilan inferensi, pemanggilan alat bantu, dan interaksi dicatat, dilacak, dan dapat diaudit.

Observabilitas adalah fondasi kepercayaan. Tanpanya, admin tidak memiliki cara untuk memverifikasi perilaku, mengaudit kepatuhan, atau mendiagnosis masalah dalam skala besar. Dengannya, agen Anda menjadi aset perusahaan, bukan sekadar kotak hitam.

Catatan

Jika agen Anda adalah agen super - artinya secara internal memanggil satu atau beberapa sub-agen untuk menyelesaikan tugas - panggilan ke sub-agen tersebut juga dapat dicatat dalam alur observabilitas. Catat sebagai panggilan alat atau panggilan agen ke agen (A2A), sebagaimana berlaku, agar seluruh rantai delegasi dapat terlihat dan diaudit.

Yang Anda dapatkan:

  • Pelacakan penuh berbasis [OpenTelemetry (OTel) (OTel)](https://opentelemetry.io/docs/specs/otel/protocol/) dari setiap interaksi agen: input, output, panggilan alat, dan pemanggilan model.
  • Aktivitas terlihat di pusat admin Microsoft 365 dan permukaan pemantauan yang terhubung.
  • Jejak audit yang dialirkan ke Microsoft Entra, Microsoft Purview, dan Microsoft Defender untuk mendukung persyaratan kepatuhan, perlindungan data, dan respons ancaman.

Apa yang Anda bangun:

Instrumentasi menggunakan API observabilitas Agent 365 SDK: baik instrumentasi otomatis (jika Anda menggunakan OpenAI, LangChain, atau Agent Framework) maupun instrumentasi manual untuk stack lain.

Catatan

Untuk sebagian besar integrasi baru, gunakan Microsoft OpenTelemetry Distro — pengaturan yang dipandu AI dapat mengonfigurasi observabilitas untuk Anda secara otomatis.

Jika Anda sudah memiliki alur OpenTelemetry, jika agent framework Anda tidak dapat menggunakan Agent 365 SDK, atau jika agen Anda dibangun dalam bahasa yang belum didukung oleh SDK (seperti Java), Anda dapat mengirim telemetri langsung ke Agent 365 melalui OTLP/HTTP mentah tanpa dependensi SDK apa pun. Lihat Integrasikan dengan observabilitas Agent 365 menggunakan OTel secara langsung.

Cara membuat agen:

Gunakan penyiapan yang dipandu AI dan jawab pertanyaan observabilitas yang sesuai. Pengaturan yang dipandu AI melakukan langkah-langkah yang diperlukan untuk kemampuan ini. Ini menggunakan Microsoft OpenTelemetry distro untuk menginstrumentasi agen Anda.

Work IQ

Setelah mendaftar dan membuat agen Anda dapat diamati, berikan akses ke data dan tindakan Microsoft 365 melalui Work IQ. Work IQ adalah seperangkat alat terkelola yang memungkinkan agen Anda berinteraksi dengan Mail, Kalender, OneDrive, SharePoint, Teams, dan lainnya.

Alat Work IQ memerlukan persetujuan admin, diaudit, dan dapat dibatalkan. Agen Anda memanggilnya menggunakan izin yang ditentukan dalam blueprint-nya—tidak diperlukan alur OAuth tambahan atau konektor kustom.

Yang Anda dapatkan:

  • Akses ke seluruh katalog alat Work IQ - Mail, Calender, OneDrive, SharePoint, Teams, dan lainnya.
  • Izin yang dikontrol dan dibatasi oleh admin sesuai dengan kebutuhan agen Anda.
  • Setiap panggilan alat dilacak dan dapat diaudit melalui alur observabilitas.

Apa yang Anda bangun:

Kode agen yang memanggil alat Work IQ menggunakan API tooling Agent 365 SDK.

Cara membuat agen:

Gunakan API tooling Agent 365 SDK untuk menambahkan panggilan alat Work IQ ke kode agen Anda secara manual. Penyiapan yang dipandu AI saat ini tidak mendukung kemampuan ini.

Rekan tim AI

Rekan tim AI tersedia untuk peserta program Frontier.

Fase terakhir memungkinkan agen Anda beroperasi di Microsoft 365 dengan identitasnya sendiri. Tergantung pada konfigurasi, agen ini dapat memiliki kotak surat, kehadiran di Teams, entri direktori, serta relasi dengan manajer. Orang dapat berinteraksi dengannya melalui pengalaman Microsoft 365 yang sudah familier seperti email, chat, rapat, dan antarmuka aplikasi.

Catatan

Pergeseran model identitas dan izin

Beralih ke rekan tim AI merupakan perubahan mendasar dalam cara agen Anda mengakses sumber daya. Agen Anda yang ada mungkin menggunakan akses pengguna delegasi, di mana agen bertindak atas nama pengguna yang masuk dan hanya dapat mengakses sumber daya yang dapat diakses pengguna tersebut, atau izin aplikasi yang diberikan kepada prinsipal layanan. Agen dengan identitas pengguna tidak mewarisi akses pengguna yang memanggil saat dijalankan. Sebaliknya, agen beroperasi dengan identitas penggunanya sendiri, beserta hak akses, kebijakan tata kelola, dan jejak auditnya sendiri.

Perubahan ini berarti:

  • Dalam akses pengguna yang didelegasikan, agen bertindak atas nama pengguna yang login dan terbatas pada akses pengguna tersebut. Dengan identitas agen sendiri, Anda memberikan akses ke sumber daya Microsoft 365 seperti kotak pesan, kalender, Teams, dan SharePoint langsung ke identitas agen.
  • Anda mengelola dan mengaudit izin yang diberikan kepada identitas agen sebagai akses milik agen tersebut. Izin tersebut tidak sama dengan izin yang didelegasikan kepada pengguna yang diteruskan dari pengguna pemanggil.
  • Jika implementasi Anda saat ini bergantung pada akses pengguna yang didelegasikan atau izin aplikasi, tinjau dan atur ulang cakupan izin tersebut untuk identitas agen sebelum mengaktifkan kemampuan ini.

Yang Anda dapatkan:

  • Semuanya mulai dari Discoverability, Observability, dan Work IQ.
  • Identitas pengguna agen dengan kotak suratnya sendiri—orang dapat mengirim email langsung kepadanya dan agen dapat mengirim email dari alamatnya sendiri.
  • Kehadiran di seluruh aplikasi Microsoft 365 - orang dapat mengobrol dengannya, @mention menambahkannya ke saluran, dan mengundangnya ke rapat di Teams; dan berinteraksi dengannya langsung di Word, Excel, PowerPoint, dan permukaan M365 lainnya.
  • Entri dalam bagan organisasi di bawah manajer yang ditunjuk—agen muncul di direktori organisasi
  • Siklus hidup yang dikendalikan admin – agen dibuat, dikelola, dan dihentikan melalui pusat admin Microsoft 365, dengan tata kelola penuh atas setiap instans.

Apa yang Anda bangun:

Semua kemampuan, ditambah pembuatan instans dan (opsional) penerbitan di Marketplace.

Cara membuat agen:

Gunakan penyiapan yang dipandu AI dan jawab pertanyaan rekan tim AI yang sesuai. Pengaturan yang dipandu AI melakukan langkah-langkah yang diperlukan untuk tingkat ini.

Penyiapan berpandu AI

Gunakan agen AI pengkodean untuk mengotomatiskan penyiapan dan konfigurasi agen Anda untuk Agent 365. Penyiapan yang dipandu AI akan memandu Anda melalui pemeriksaan prasyarat, tahap konfigurasi, dan integrasi kode yang diperlukan untuk mengaktifkan fitur seperti pendaftaran, observabilitas, akses alat Work IQ, dan fungsionalitas rekan tim AI.

Persyaratan penyiapan yang dipandu AI

Sebelum mulai, pastikan Anda memiliki item berikut:

Persyaratan Detail
Agen pengodean AI Visual Studio Code dengan ekstensi GitHub Copilot dan GitHub Copilot Chat, atau agen pengodean AI lainnya dengan akses terminal
Kode agen Proyek agen yang berjalan di Python, Node.js, atau .NET. Jika Anda tidak memilikinya, mulailah dengan sampel mulai cepat.
Peran Entra Administrator Global - menyelesaikan semua langkah, termasuk pemberian izin OAuth2. Pengembang ID Agen - menyelesaikan semua langkah kecuali pemberian izin OAuth2; penyiapan menghasilkan penyerahan untuk Administrator Global.

Langkah-langkah penyiapan yang dipandu AI

Langkah-langkah ini berlaku baik saat Anda mengaktifkan agen tunggal maupun agent factory. Agen AI memeriksa alat yang diperlukan dan mengelola instalasi, autentikasi, dan validasi secara otomatis.

Buka proyek agen Anda dan salin perintah ini ke agen AI pilihan Anda. Jika Anda menggunakan GitHub Copilot, beralih ke mode Agen terlebih dahulu — mode Tanya dan Edit tidak memiliki akses terminal.

Follow the steps at aka.ms/agent365enable to enable my agent for Agent 365.

Agen AI akan memulai dengan mengajukan tiga pertanyaan guna menentukan kapabilitas yang berlaku untuk agen Anda:

Pertanyaan 1: Apakah agen Anda sudah tersedia di Teams atau Copilot?

  • Ya
  • Tidak

Pertanyaan 2: Bagaimana agen Anda akan melakukan autentikasi saat memanggil API downstream?

  • Atas nama (OBO) — agen bertindak sebagai pengguna yang sedang masuk (izin didelegasi)
  • Layanan ke layanan (S2S) — agen bertindak sebagai identitasnya sendiri (izin aplikasi)
  • (OBO dan S2S)

Pertanyaan 3: Kemampuan Agent 365 apa yang ingin Anda aktifkan?

Penyiapan secara otomatis menyertakan semua kemampuan prasyarat untuk pilihan Anda.

Agen AI kemudian secara otomatis bekerja melalui tahapan yang relevan, berhenti hanya untuk meminta input dari Anda:

Kemampuan Apa yang dilakukan agen AI 1
Daftar Memeriksa .NET dan Agent 365 CLI (menginstal atau memperbarui jika belum tersedia), menginstal Azure CLI jika belum tersedia, menjalankan az login jika belum diautentikasi, memvalidasi pendaftaran aplikasi klien kustom Anda, mengumpulkan nama agen dan email manajer, mengonfigurasi agen Anda di Portal Pengembang Teams, dan mendaftarkan blueprint agen Anda
Observabilitas Menambahkan instrumentasi observabilitas Agent 365 SDK ke kode agen Anda
Rekan tim AI Menjalankan a365 publish dan memandu Anda melalui langkah-langkah pasca-penyebaran, termasuk pembuatan instans agen

1 Langkah-langkah yang dilakukan bergantung pada jenis agen dan fase yang Anda pilih di awal penyiapan.

Penting

Untuk Observabilitas, agen AI menulis kode langsung ke proyek Anda. Agen pengodean AI dapat membuat kesalahan. Selalu tinjau perubahan sebelum menyebarkan ke lingkungan produksi.

Informasi yang diperlukan untuk melengkapi

Agen AI menjeda untuk mengumpulkan konfigurasi selama penyiapan:

Perintah Apa yang harus disediakan
Nama agen, email manajer Metadata dasar agen
Konfirmasi nilai turunan Tinjau nama yang dibuat secara otomatis untuk identitas agen, blueprint, dan nama utama pengguna
Tinjauan manifes Pastikan manifest.json telah diperbarui dengan nama, deskripsi, dan informasi pengembang agen Anda

Langkah-langkah pasca-penyebaran

Setelah proses otomatis selesai, agen AI berhenti sejenak untuk dua langkah yang memerlukan interaksi dengan browser:

  1. Buat instans agen

    (Hanya rekan tim AI) — Di Microsoft Teams, buka Aplikasi, cari agen Anda, dan pilih Tambah. Jika persetujuan admin diperlukan, admin Microsoft 365 Anda menerima permintaan tersebut. Setelah disetujui, agen Anda muncul di bagan organisasi Anda. Untuk instans tambahan, lihat Buat instans agen. Diperlukan waktu beberapa menit agar agen yang baru diterbitkan muncul di pencarian Teams.

  2. Menguji agen

    Kirim pesan ke agen Anda di Teams untuk memastikan agen tersebut berfungsi.

Selesai — agen Anda disebarkan, dipublikasikan, dan ditayangkan. Lihat Buat instans agen jika Anda memerlukan instans tambahan.

Jika ada yang tidak berhasil, agen AI menyediakan pemecahan masalah yang ditargetkan. Anda juga dapat merujuk ke Panduan Pemecahan Masalah Agent 365.

Referensi jalur manual

Gunakan referensi ini hanya jika Anda memecahkan masalah pada suatu langkah, membangun otomatisasi CI/CD, atau bekerja tanpa agen pengodean AI.

Langkah Apa fungsinya Panduan
Konfigurasi pengaturan Membuat a365.config.json dengan detail penyewa, langganan, dan proyek Anda. Jika Anda memiliki penyebaran yang ada, atur titik akhir olahpesan di sini. Siapkan konfigurasi Agent 365
Penyiapan blueprint Mendaftarkan identitas agen Anda di Entra dan menyediakan sumber daya Azure (grup sumber daya, Paket App Service, Aplikasi Web) Penyiapan blueprint agen
Menyebarkan Menyebarkan kode agen Anda ke Azure App Service. Opsional jika sudah di-host di tempat lain. Azure · AWS · GCP
Penerbitan Membuat manifest.zip dan mengunggah ke pusat admin Microsoft 365 Publikasikan agen

Untuk instalasi, perintah, dan pemecahan masalah CLI, lihat CLI Agent 365.

Terbitkan agen Anda di Microsoft Marketplace

Setelah Anda sepenuhnya mengembangkan dan menguji agen Anda di penyewa Anda sendiri, publikasikan agen tersebut di Microsoft Marketplace.

Untuk melakukannya, Anda memerlukan akun Program Mitra Microsoft AI Cloud di Pusat Mitra. Jika Anda tidak memilikinya, buat akun untuk mendapatkan PartnerID Anda. Selanjutnya, daftar dalam program Microsoft 365 dan Copilot, yang memberi Anda akses ke sumber daya dan dukungan yang diperlukan untuk menerbitkan penawaran agen. Setelah terdaftar, tinjau daftar periksa pengiriman dan pedoman validasi, lalu kirimkan agen Anda melalui panduan pengiriman langkah demi langkah di Pusat Mitra.

Pelajari cara mengajukan agen Anda ke Microsoft Marketplace menggunakan Pusat Mitra.

Setelah selesai, agen Anda diterbitkan ke Microsoft Marketplace dan tersedia untuk ditemukan dan disebarkan pelanggan.

Memecahkan masalah penyiapan yang dipandu AI

Jika Anda mengalami masalah selama penyiapan yang dipandu AI, lihat masalah umum berikut dan solusinya.

Masalah Deskripsi
Agen AI tidak menjalankan perintah terminal Agen AI menjelaskan perintah tetapi tidak menjalankannya
Agen AI melewatkan langkah-langkah Penyiapan tampaknya melewati langkah-langkah yang diperlukan
Perintah CLI gagal dengan kesalahan izin Kesalahan otorisasi saat menjalankan perintah a365 CLI
Nilai konfigurasi salah Perlu mengubah konfigurasi setelah membuat a365.config.json

Agen AI tidak menjalankan perintah terminal

Jika agen AI menjelaskan perintah tetapi tidak menjalankannya, pastikan Anda menggunakan mode Agen di GitHub Copilot Chat. Mode Tanya dan Edit tidak memiliki akses terminal.

Agen AI melewatkan langkah-langkah

File instruksi memberlakukan urutan langkah yang ketat. Jika agen AI tampaknya melewatkan satu langkah, minta untuk memulai dari awal:

Please start from Step 1 in the setup instructions and work through each step in order.

Perintah CLI gagal dengan kesalahan izin

Jika perintah CLI a365 gagal dengan kesalahan otorisasi, penyebab paling umum adalah pendaftaran aplikasi klien kustom yang hilang atau tidak lengkap. Agen AI memvalidasi pendaftaran ini selama penyiapan, tetapi jika validasi dilewati, lihat Pendaftaran aplikasi klien kustom.

Untuk pemecahan masalah umum, lihat Panduan Pemecahan Masalah Agent 365.

Nilai konfigurasi salah

Jika Anda perlu mengubah nilai konfigurasi setelah membuat a365.config.json, salah satu:

  • Edit file secara langsung dan jalankan ulang a365 config init -c ./a365.config.json
  • Mintalah agen AI untuk memperbarui nilai tertentu
  • Last updated on