MCP Academy · Pelajaran

Input Model dengan Pydantic

Tentukan bentuk bertipe untuk argumen alat.

Pelajaran 2 dari 413 langkah

Input Model dengan Pydantic 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.

Satu Model untuk Setiap Input

Untuk membentuk argumen alat, Anda menulis model Pydantic: kelas kecil yang setiap atributnya merupakan kolom input dengan tipe tertentu.

from pydantic import BaseModel

class SearchInput(BaseModel):
    query: str
    limit: int

Turunkan dari BaseModel

Setiap model input mewarisi BaseModel, yang memberinya kemampuan mengurai, memvalidasi, dan membuat skema JSON secara otomatis.

Kolom adalah Atribut Bertipe

Setiap baris menyebutkan sebuah kolom dan tipenya. Pydantic membaca anotasi tersebut untuk mengetahui bentuk input yang valid.

Teruskan Model sebagai Satu Argumen

Dalam alat FastMCP, terima model sebagai satu parameter bertipe, dan kerangka kerja akan membuat skema darinya.

@mcp.tool()
def search(args: SearchInput) -> str:
    return run(args.query, args.limit)

Akses Kolom berdasarkan Nama

Di dalam alat, Anda membaca nilai sebagai atribut: args.query dan args.limit. Tidak perlu pencarian dict, dan penyunting Anda melengkapi namanya secara otomatis.

Konversi Tipe yang Wajar

Pydantic akan mengonversi nilai yang kompatibel dengan hati-hati, misalnya mengubah string 5 menjadi bilangan bulat 5, sehingga ketidaksesuaian kecil dapat langsung ditangani.

Menolak Tipe yang Salah

Jika suatu nilai tidak dapat diubah menjadi tipe yang dideklarasikan, Pydantic memunculkan kesalahan validasi yang jelas, bukan membiarkannya lolos.

Model Bersarang

Sebuah kolom dapat berupa model lain, sehingga Anda dapat menjelaskan objek bersarang dengan rapi, bukan menggunakan dict mentah yang sangat bertingkat.

class Address(BaseModel):
    city: str

class User(BaseModel):
    name: str
    home: Address

Skema Dibuat Otomatis

Pydantic secara otomatis mengubah model Anda menjadi skema JSON, yang kemudian diteruskan MCP kepada klien agar model mengetahui bentuk inputnya.

Gunakan Kembali Model di Berbagai Alat

Tentukan sebuah model sekali dan bagikan ke beberapa alat. Dengan begitu, bentuk input Anda tetap konsisten dan kode tidak berulang.

Keamanan Tipe dari Awal hingga Akhir

Sejak model dipanggil hingga isi fungsi Anda dijalankan, data mempertahankan satu tipe yang telah diverifikasi, sehingga Anda tidak perlu lagi menangani dict tanpa tipe.

Pemeriksaan Singkat

Bagaimana cara menentukan bentuk input bertipe untuk alat dengan Pydantic?

Ringkasan

Turunkan dari BaseModel, cantumkan kolom bertipe, dan teruskan model sebagai satu argumen. Pydantic memvalidasi input dan membuat skemanya. ✅

Gratis untuk memulai

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 “Input Model dengan Pydantic” gratis?

Ya — teks lengkap “Input Model dengan Pydantic” 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 “Input Model dengan Pydantic”?

Tentukan bentuk bertipe untuk argumen 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 “Input Model dengan Pydantic” 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. Mengapa Skema Lebih Baik daripada Argumen Lepas
  2. Input Model dengan Pydantic
  3. Batasan, Nilai Bawaan, dan Enum
  4. Deskripsi Kolom yang Memandu Model
← Kembali ke MCP Academy