0Pricing
MCP Academy · Pelajaran

Kesalahan Alat yang Dapat Dilihat Model

Kembalikan error yang dapat dibaca dan dipulihkan oleh kecerdasan buatan.

Kesalahan Alat yang Dapat Dilihat Model adalah pelajaran MCP Academy gratis di CoddyKit. Ini adalah pelajaran 1 dari 4. Kamu bisa membaca pelajaran lengkapnya di bawah secara gratis — lalu praktikkan langsung di browser dengan editor kode bawaan dan tutor AI 24/7. Ini adalah bagian dari jalur belajar MCP Academy, dan progresmu tersinkronisasi di web dan aplikasi CoddyKit. Kursus MCP Academy mencakup 4 pelajaran total.

Kesalahan Hanyalah Konteks Tambahan

Saat sebuah alat gagal, AI tidak mengalami kerusakan. AI cukup membaca kesalahan Anda sebagai konteks lalu menentukan tindakan berikutnya, sama seperti pada hasil apa pun.

Kesalahan yang Baik Dapat Ditindaklanjuti

Tulislah kesalahan untuk pembaca yang dapat mengambil tindakan. City not found lebih baik daripada Exception karena model dapat meminta pengguna memperbaiki kotanya.

Kembalikan String Kesalahan

Pola paling sederhana adalah mengembalikan string pesan yang jelas saat terjadi masalah, sehingga model dapat membaca secara tepat apa yang gagal.

@mcp.tool()
def get_user(uid: int) -> str:
    if uid < 1:
        return "Error: uid must be positive."

Ajukan Pengecualian untuk Menandai Kesalahan Alat

Anda juga dapat raise pengecualian Python biasa. FastMCP akan menangkapnya dan melaporkan kesalahan alat kepada model, bukan menyebabkan server berhenti.

@mcp.tool()
def divide(a: float, b: float) -> float:
    if b == 0:
        raise ValueError("b cannot be zero")
    return a / b

isError Menandai Hasil

Di balik layar, pemanggilan alat yang gagal mengembalikan konten dengan isError yang disetel ke true. Penanda tersebut memberi tahu klien bahwa hasil ini menjelaskan suatu kegagalan.

Model Dapat Memulihkan Diri

Kesalahan yang mudah dibaca memungkinkan AI mencoba lagi dengan masukan yang lebih baik atau menjelaskan masalah kepada pengguna, sehingga kegagalan berubah menjadi langkah berikutnya yang membantu. 🔁

Sampaikan Apa dan Mengapa

Kesalahan yang baik menyebutkan apa yang gagal dan alasannya. File missing: report.csv jauh lebih berguna bagi model daripada Not found yang berdiri sendiri.

Sarankan Perbaikan

Jika memungkinkan, berikan petunjuk perbaikan di dalam kesalahan. Date must be YYYY-MM-DD memungkinkan model memperbaiki dirinya sendiri pada pemanggilan berikutnya.

if not iso_date:
    raise ValueError("Date must be in YYYY-MM-DD format")

Jangan Pernah Membocorkan Detail Internal

Kesalahan sampai kepada model dan sering kali juga kepada pengguna, jadi jangan sertakan rahasia, pelacakan tumpukan mentah, atau string koneksi dalam pesan yang Anda kembalikan.

Validasi, Lalu Laporkan Kesalahan Sejak Awal

Periksa argumen terlebih dahulu dan kembalikan kesalahan sebelum melakukan pekerjaan sebenarnya. Gagal dengan cepat membuat alat Anda mudah diprediksi dan dipahami.

Kesalahan adalah Bagian dari Kontrak

Perlakukan kegagalan sebagai keluaran yang dirancang. Alat yang menyebutkan kemungkinan kesalahannya sama bergunanya bagi model seperti alat yang mendokumentasikan keberhasilannya.

Pemeriksaan Singkat

Mengapa kesalahan alat harus ditulis sebagai pesan yang jelas dan mudah dibaca?

Rangkuman

Kesalahan alat adalah konteks yang dibaca model: buatlah jelas, sampaikan apa dan mengapa, sarankan perbaikan, dan jangan pernah membocorkan detail internal. ✅

Pertanyaan yang Sering Diajukan

Apakah pelajaran “Kesalahan Alat yang Dapat Dilihat Model” gratis?

Ya — teks lengkap “Kesalahan Alat yang Dapat Dilihat Model” gratis dibaca di sini di web. Untuk praktiknya secara interaktif (editor kode bawaan dan tutor AI 24/7) dan buka sisa kursus MCP Academy, upgrade ke CoddyKit PRO. Kursus MCP Academy mencakup 4 pelajaran total.

Apa yang akan aku pelajari di “Kesalahan Alat yang Dapat Dilihat Model”?

Kembalikan error yang dapat dibaca dan dipulihkan oleh kecerdasan buatan. Kamu berlatih MCP Academy dengan kode praktik yang langsung kamu jalankan di browser, dan tutor AI 24/7 menjawab pertanyaanmu saat kamu mengerjakan pelajaran ini.

Apakah aku perlu pengalaman untuk memulai MCP Academy?

Tidak diperlukan pengalaman sebelumnya. MCP Academy di CoddyKit dirancang untuk pemula hingga pelajar tingkat lanjut, jadi kamu bisa memulai di sini atau dari awal dan belajar sesuai kecepatan kamu sendiri. Ini adalah pelajaran 1 dari 4.

Berapa lama pelajaran “Kesalahan Alat yang Dapat Dilihat Model” memakan waktu?

Sebagian besar pelajaran CoddyKit memakan waktu sekitar 5–10 menit. Setiap pelajaran ringkas dan interaktif, jadi kamu membuat kemajuan stabil dan melanjutkan dari tempat kamu tinggalkan di web dan aplikasi.

Bisakah aku menulis dan menjalankan kode dalam pelajaran MCP Academy ini?

Ya. Setiap pelajaran MCP Academy menyertakan editor kode bawaan, jadi kamu menulis dan menjalankan kode nyata langsung di browser dan mendapatkan umpan balik AI instan — tidak diperlukan penyiapan lokal.

Semua pelajaran dalam kursus ini

  1. Kesalahan Alat yang Dapat Dilihat Model
  2. Kesalahan Protokol dan Kegagalan Alat
  3. Memvalidasi Input Sebelum Bertindak
  4. Gagal dengan Aman, Jangan Pernah Macet
← Kembali ke MCP Academy