Memberi Nama dan Mendeskripsikan Alat dengan Baik
Tulis deskripsi yang benar-benar dapat digunakan model untuk bertindak.
Memberi Nama dan Mendeskripsikan Alat dengan Baik 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.
Model Membaca Terlebih Dahulu
Sebelum AI menjalankan tool Anda, AI membaca nama dan deskripsinya untuk menentukan apakah tool tersebut sesuai dengan tugasnya. 🧭
Beri Nama Seperti Kata Kerja
Nama tool MCP yang baik langsung menjelaskan fungsinya, seperti get_weather atau send_email. Singkat, mengutamakan tindakan, dan tidak mengejutkan.
Asal Nama
Dalam FastMCP, nama tool secara bawaan berasal dari nama fungsi Python Anda. Jadi, namai fungsi dengan cermat dan gunakan snake_case.
@mcp.tool()
def get_weather(city: str) -> str:
...Menimpa Nama
Jika nama fungsi tidak ideal, berikan nama eksplisit kepada dekorator agar model melihat nama yang benar-benar Anda inginkan.
@mcp.tool(name="get_weather")
def weather_lookup(city: str) -> str:
...Deskripsi Adalah Prompt
Deskripsi tool dibaca model sebagai panduan. Perlakukan deskripsi seperti prompt kecil yang memberi tahu AI kapan dan mengapa tool ini perlu dipanggil.
Docstring Menjadi Deskripsi
FastMCP secara otomatis mengubah docstring fungsi Anda menjadi deskripsi tool. Jadi, tulislah deskripsi untuk model, bukan hanya untuk manusia.
@mcp.tool()
def get_weather(city: str) -> str:
"""Get the current weather for a city."""Nyatakan Apa yang Dikembalikan
Deskripsi yang baik menyebutkan input dan keluaran, sehingga model mengetahui apa yang akan diterimanya sebelum memanggil tool.
Jelaskan Batasannya secara Spesifik
Nyatakan batasan dalam deskripsi: kota mana yang didukung, format apa yang digunakan, dan hal apa yang tidak dapat dilakukan. Batasan yang jelas mencegah model menyalahgunakan tool Anda.
Hindari Kata Kerja yang Samar
Kata seperti memproses atau menangani tidak memberi informasi kepada model. Gunakan kata kerja yang tepat agar AI dapat membedakan tool Anda saat pemanggilan.
Satu Tool, Satu Tugas
Fokuskan setiap tool pada satu tugas. Tool yang cakupannya sempit dan namanya jelas jauh lebih mudah dipilih dengan tepat oleh model daripada tool yang melakukan segala hal.
Uji Nama dengan Mengucapkannya
Baca nama dan baris pertama deskripsi secara bersamaan. Jika orang asing tidak dapat menebak fungsinya, model mungkin juga tidak bisa.
Pemeriksaan Singkat
Dari mana FastMCP mendapatkan deskripsi tool secara bawaan?
Ringkasan
Model membaca nama dan deskripsi terlebih dahulu. Gunakan nama yang menyatakan tindakan, deskripsi docstring, dan batasan yang jelas agar AI memanggil tool Anda dengan benar. ✅
Belajar Python dengan tutor AI — gratis
Tulis dan jalankan kode asli di browser kamu, dapatkan bantuan instan dari tutor AI 24/7, dan lanjutkan di mana kamu tinggalkan di web atau aplikasi.
- Kursus
- 30
- Pelajaran
- 120
Pertanyaan yang Sering Diajukan
Apakah pelajaran “Memberi Nama dan Mendeskripsikan Alat dengan Baik” gratis?
Ya — teks lengkap “Memberi Nama dan Mendeskripsikan Alat dengan Baik” 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 “Memberi Nama dan Mendeskripsikan Alat dengan Baik”?
Tulis deskripsi yang benar-benar dapat digunakan model untuk bertindak. 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 “Memberi Nama dan Mendeskripsikan Alat dengan Baik” 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
- Memberi Nama dan Mendeskripsikan Alat dengan Baik
- Mendeklarasikan Parameter dengan Petunjuk Tipe
- Mengembalikan Hasil yang Berguna
- Alat Kalkulator dari Awal hingga Selesai