Masalah Umum dalam Pengembangan Plugin Karyawan AI
Alat tidak terdaftar
Periksa dalam urutan berikut:
- Apakah file tersebut terletak di
src/ai/**/tools/dalam cakupan pembuatan plugin - Apakah akan menggunakan file
.tsatau.js - Apakah
export default defineTools(...) - Apakah file Alat salah diberi nama
.d.ts - Apakah Alat dengan nama yang sama muncul, menyebabkan item pendaftaran selanjutnya diabaikan
- Apakah plugin telah dibuat ulang dan dimuat
Keterampilan tidak muncul
Nama file diperiksa terlebih dahulu. Saat ini harus:
Konfirmasikan juga bahwa frontmatter berisi name dan description yang stabil, dan bahwa file tersebut berlokasi di src/ai/**/skills/<skill-name>/SKILLS.md.
Keterampilan dapat dimuat, tetapi Alat tidak dapat dipanggil
Periksa item berikut:
- Apakah daftar
toolsKeterampilan berisi nama Alat - Apakah Alat ditempatkan di direktori
tools/Keterampilan saat ini - Apakah nama file Alat,
definition.name, dan referensi Keterampilan konsisten? scopecocok untuk metode pengikatan saat ini- Apakah Alat tidak terdaftar karena nama duplikat?
Mengikat Alat hanya berarti model dapat menggunakannya. Jika Alat sudah muncul di Skill, namun model masih belum dipanggil, Anda perlu menuliskan dengan jelas waktu pemanggilan, persyaratan parameter, dan langkah menunggu hasil di alur kerja SKILLS.md.
Kartu front-end tidak ditampilkan
Nama registrasi front-end harus sama persis dengan nama Alat akhir di server:
Periksa juga:
- Apakah plugin khusus menggunakan runtime
src/client-v2/ - Apakah kartu terdaftar di
load()plugin klien - Apakah ToolCall telah memasuki keadaan yang didukung oleh kartu
- Apakah kartu dinonaktifkan karena penilaian
invokeStatus - Apakah plugin klien telah dibuat ulang dan dimuat
Alat tidak melanjutkan eksekusi setelah mengklik kartu
Verifikasi bahwa salah satu dari approve(), edit(), atau reject() telah dipanggil. Saat Anda perlu menulis kembali pilihan pengguna ke parameter, gunakan:
Konfirmasikan juga bahwa skema server mengizinkan bidang ini dan invoke() akan membacanya.
Modifikasi definition.name tidak berlaku
Nama Alat yang dimuat secara otomatis ditentukan oleh nama file atau nama direktori. Misalnya:
Nama akhirnya adalah developerChoice. Jika Anda ingin mengubah nama, Anda perlu menyinkronkan file yang diubah namanya, referensi Keterampilan, konfigurasi staf AI, dan nama registrasi front-end.
Tautan terkait
- Pengembangan Plug-in Staf AI — Kembali ke Ikhtisar Panduan Pengembangan
- Mendefinisikan Tool server — Periksa penamaan Alat dan metode pendaftaran
- Tentukan Keterampilan — Periksa pengikatan Keterampilan dan Alat
- Tambahkan kartu front-end untuk Alat — Periksa ToolCall dan registrasi front-end

