Panduan membaca yang dilokalisasi

declarative-agent-developerTujuan, penggunaan, dan sumber

Buat, bangun, sebarkan, dan lokalisasi agen deklaratif untuk M.365Copilot dan Teams. GUNAKAN KETERAMPILAN INI untuk TUGAS APA PUN yang melibatkan agen deklaratif — termasuk lokalisasi, pembuatan kerangka kerja, pengeditan manifes, penambahan kemampuan, dan penyebaran. Lokalisasi memerlukan manifes yang ditokenisasi dan file bahasa yang hanya dapat dihasilkan oleh keterampilan ini. Pemicu: "buat agen", "buat agen deklaratif", "agen deklaratif baru", "buat kerangka kerja agen", "proyek agen baru", "tambahkan kemampuan", "tambahkan plugin", "konfigurasi agen saya", "sebarkan agen saya", "perbaiki manifes agen saya", "edit agen saya", "lokalisasi agen saya", "tambahkan lokalisasi", "terjemahkan agen saya", "agen multibahasa", "tambahkan plugin API", "tambahkan plugin MCP", "tambahkan OAuth ke plugin saya", "tinjau instruksi", "tingkatkan instruksi", "perbaiki instruksi saya"

Sumber diambil: 2026-10-29

Repositori sumber: microsoft/skills
SKILL.md: .github/plugins/microsoft-365-agents-toolkit/skills/declarative-agent-developer/SKILL.md
Bintang Repositori: 3,157
Pembaruan terakhir repositori: 2026-10-31
Klasifikasi Kemampuan: Alur Kerja Agen
Waktu pengumpulan terbaru: 2026-10-31 10:38 UTC+08:00

Lisensi: MIT

SKILL.md asli

Cuplikan alur kerja adalah alat bantu baca, bukan instruksi yang dapat dieksekusi dari Codez. Tidak ada Skill pihak ketiga yang dijalankan untuk menghasilkan halaman ini.

Bagian yang menjelaskan tujuan dan alur kerja di bawah ini merupakan materi dari hulu, yang telah diorganisir dan diterjemahkan untuk dibaca. Bagian ini berbeda dari analisis editorial Codez yang diberi label secara terpisah.

Apa yang dilakukan oleh Skill ini?

Bagaimana alur kerja hulu bekerja

⛔ Pemeriksaan Ruang Kerja — LANGKAH PERTAMA YANG WAJIB DILAKUKAN

Sebelum melakukan APA PUN, periksa file ruang kerja untuk mengidentifikasi proyek: Jalankannpx -y --package @microsoft/m365agentstoolkit-cli atk --versionUntuk memastikan ATK CLI sudah terpasang. Jika tidak ditemukan → Berhenti. Beri tahu pengguna untuk menginstal ATK. Periksam365agents.ymlatauteamsApp.ymldi direktori akar proyek. PeriksaappPackage/declarativeAgent.json.

Jalur hulu · L26 ↗

6Selalu perbarui instruksi dan panduan awal setelah ada perubahan.

Menambahkan kemampuan atau plugin tanpa memperbarui petunjuk adalah tindakan yang tidak lengkap. Setelah PERUBAHAN APA PUN: Perbarui petunjuk untuk menjelaskan hal tersebut.new/changedFungsionalitas — setiap sumber data harus memiliki cakupan tujuan yang jelas (KAPAN dan MENGAPA menggunakannya) sesuai dengan standar kualitas Tinjauan Instruksi. Kemampuan bawaan tidak perlu memiliki nama yang persis sama;actions/pluginsharus diberi nama. JANGAN mencantumkan nama alat, deskripsi, atau parameter dalam instruksi — ini sudah ada di metadata plugin (ai-plugin.json(Manifest MCP, konfigurasi kemampuan). Instruksi hanya boleh berisi logika pengambilan keputusan: KAPAN menggunakan setiap alat, aturan penggabungan, dan penanganan kegagalan. Tambahkan setidaknya1Sebagai pembuka percakapan, ditambahkancapability/plugin

Jalur hulu · L158 ↗

Jalur hulu · bash ↗

export ATK_CLI_SKILL=true

Persyaratan dan pengaturan

Pengaturan CLI ATK

Sebelum menjalankan perintah ATK apa pun, periksa apakah CLI ATK tersedia dengan menjalankan perintah berikut:npx -y --package @microsoft/m365agentstoolkit-cli atk --versionJika tidak ditemukan, HENTIKAN dan beri tahu pengguna — JANGAN mencoba menginstalnya sendiri. Semua perintah menggunakannpx -y --package @microsoft/m365agentstoolkit-cli atkawalan (misalnya,npx -y --package @microsoft/m365agentstoolkit-cli atk provision --env local).

Jalur hulu · L91 ↗

3Kompatibilitas Versi Skema

Sebelum menambahkan fitur APA PUN, bacalah terlebih dahuluversionbidang dideclarativeAgent.jsondan periksa matriks fitur Skema. Jika fitur tersebut tidak didukung dalam versi tersebut, tolak dan tawarkan untuk melakukan upgrade. Gerbang versi utama:

Jalur hulu · L131 ↗

Batasan dan pemeriksaan kualitas

2Jangan pernah mengarang konten atau membuat file yang hilang.

JANGAN membuat nama, deskripsi, atau instruksi sementara. JANGAN membuatdeclarativeAgent.jsonatauappPackage/Jika hal tersebut tidak ada, ini adalah skenario PENOLAKAN, bukan skenario "bantu dengan membuat".

Jalur hulu · L123 ↗

4. Menggunakan`npx -y --package @microsoft/m365agentstoolkit-cli atk add action`Untuk Plugin API — JANGAN PERNAH Membuat File Plugin Secara Manual

Anda dilarang membuat secara manual.ai-plugin.jsonSpesifikasi OpenAPI, kartu adaptif, atau pengeditanactionsarray. Gunakan CLI: Jalankan satu perintah.npx -y --package @microsoft/m365agentstoolkit-cli atk add actionpanggilan sesuai spesifikasi OpenAPI, mencantumkan semua operasi sebagai daftar yang dipisahkan koma di--api-operationJangan pernah menjalankannya secara terpisah.npx -y --package @microsoft/m365agentstoolkit-cli atk add actionmeminta operasi berbeda dari spesifikasi yang sama — ini menciptakan beberapa plugin, bukan satu. Jikanpx -y --package @microsoft/m365agentstoolkit-cli atk add actionJika gagal, laporkan kesalahannya; JANGAN kembali ke pembuatan manual.

Jalur hulu · L141 ↗

Mulailah dengan uji coba yang aman.

Periksa host yang didukung dan petunjuk instalasi repositori. Simpan direktori Skill beserta skrip, aset, dan dokumentasi yang dirujuk di dalamnya secara bersamaan;SKILL.mdsendirian dapat menghilangkan dependensi.
Berikan input sebenarnya, output yang diinginkan, dan kriteria penerimaan kepada agen. Sintaks pemanggilan dan alat yang tersedia bergantung pada host; situs ini tidak mengasumsikan perintah instalasi universal.
Cobalah alur kerja sumber dalam proyek sementara atau pada salinannya. Tinjau operasi yang mengubah file, layanan jarak jauh, atau sumber daya yang dapat ditagih sebelum mengizinkannya.
Validasi output terhadap pemeriksaan kualitas sumber dan persyaratan Anda sendiri. Pemicu yang berhasil atau jumlah bintang repositori yang tinggi tidak menjamin hasil yang benar.

Spesifikasi format dan direktori keterampilan ↗

Baca selengkapnya di sumber aslinya.

Terjemahan dan ruang lingkup

Panduan membaca ini memilih bagian-bagian dari teks yang telah disematkan di bagian atas.SKILL.mdTerjemahan ini dibantu. Ini bukan manual lengkap atau klaim kompatibilitas yang telah diuji. Bacalah dokumen asli dan file referensinya sebelum digunakan.

Pendahuluan ini mengacu pada versi yang disematkan di bawah ini; aktivitas repositori saat ini dan waktu pengumpulan ditampilkan secara terpisah.

Sumber yang disematkan: Baca teks aslinya ↗
Sumber diambil: 2026-10-29T09:32:23Z
Komit sumber: 00d66a64919edca5bca2c673373444e36a4b5461
Sumber SHA-256: 13d2af8dd44cca049c8ebf8a8880cca304fc3dc419c926ef146dba35b14df412

Kembali ke katalog Keterampilan lengkap