Mendeklarasikan Parameter dengan Petunjuk Tipe
Gunakan petunjuk Python untuk membentuk skema alat.
Mendeklarasikan Parameter dengan Petunjuk Tipe adalah pelajaran MCP Academy gratis di CoddyKit. Ini adalah pelajaran 2 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.
Parameter Menjadi Skema
Setiap argumen fungsi tool Anda menjadi bagian dari skema input yang harus diikuti model saat memanggil tool. 🧩
Petunjuk Tipe Menangani Semuanya
FastMCP membaca petunjuk tipe Python Anda dan membuat skema JSON untuk Anda, sehingga Anda jarang perlu menulis skema secara manual.
@mcp.tool()
def add(a: int, b: int) -> int:
return a + bstr, int, float, bool
Tipe dasar dipetakan dengan jelas: str menjadi string, int dan float menjadi number, sedangkan bool menjadi boolean dalam skema.
Tanpa Tipe Berarti Tidak Jelas
Jika Anda mengabaikan petunjuk tipe, model hanya melihat nilai bebas tanpa aturan. Hal ini membuka peluang terjadinya input yang salah atau tidak valid.
def add(a, b):
return a + bWajib secara Bawaan
Parameter tanpa nilai bawaan dianggap wajib, sehingga model harus selalu menyediakannya saat memanggil tool.
Nilai Bawaan Menjadikannya Opsional
Berikan nilai bawaan pada parameter agar parameter tersebut menjadi opsional. Model boleh mengabaikannya, dan fungsi Anda menggunakan nilai cadangan.
@mcp.tool()
def greet(name: str, formal: bool = False) -> str:
...Daftar dan Kamus
Anda juga dapat memberikan petunjuk untuk koleksi. Argumen list dipetakan ke array JSON, sedangkan dict dipetakan ke objek yang dapat diisi model.
def tag(items: list[str]) -> int:
return len(items)Nilai Opsional
Gunakan Optional ketika argumen dapat berupa nilai atau None. Ini menandakan bahwa model boleh sengaja membiarkannya kosong.
from typing import Optional
def find(q: str, limit: Optional[int] = None):
...Namai Parameter dengan Jelas
Model melihat setiap nama parameter dalam skema, jadi city lebih baik daripada c dan start_date lebih baik daripada arg2. Nama yang jelas membantu menghasilkan pemanggilan yang lebih baik.
Petunjuk Mendukung Validasi
Karena petunjuk menentukan skema, MCP dapat menolak pemanggilan dengan tipe yang salah sebelum kode Anda berjalan, sehingga kesalahan dapat ditemukan lebih awal.
Buat Tanda Tangan Tetap Ringkas
Parameter yang lebih sedikit dan memiliki tipe yang jelas lebih mudah diisi model dengan benar daripada daftar panjang argumen yang tidak saling berkaitan.
Pemeriksaan Singkat
Apa yang membuat parameter tool menjadi opsional dalam FastMCP?
Ringkasan
Petunjuk tipe Anda membentuk skema tool: tipe dasar dipetakan secara langsung, nilai bawaan berarti opsional, dan nama yang jelas memandu model. ✅
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 “Mendeklarasikan Parameter dengan Petunjuk Tipe” gratis?
Ya — teks lengkap “Mendeklarasikan Parameter dengan Petunjuk Tipe” 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 “Mendeklarasikan Parameter dengan Petunjuk Tipe”?
Gunakan petunjuk Python untuk membentuk skema alat. 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 2 dari 4.
Berapa lama pelajaran “Mendeklarasikan Parameter dengan Petunjuk Tipe” 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