Pemberian Versi Alat dan Skema
Kembangkan pelayan anda tanpa merosakkan klien.
Pemberian Versi Alat dan Skema ialah pelajaran MCP Academy percuma di CoddyKit. Ini ialah pelajaran 4 daripada 4. Sebanyak 3 pelajaran dalam laluan pembelajaran ini boleh dibaca sepenuhnya secara percuma — selepas itu, CoddyKit PRO membuka akses kepada semua pelajaran, serta latihan praktikal dengan penyunting kod terbina dalam dan tutor kecerdasan buatan yang tersedia 24/7. Pelajaran ini merupakan sebahagian daripada laluan pembelajaran MCP Academy, dan kemajuan anda disegerakkan merentas web serta aplikasi CoddyKit. Kursus MCP Academy merangkumi sejumlah 4 pelajaran.
Klien Bergantung pada Bentuk Anda
Selepas pihak lain bersambung, mereka bergantung pada nama alat dan bentuk argumen anda. Mengubahnya secara cuai akan merosakkan setiap klien serentak.
Perubahan Tambahan Selamat
Menambah parameter pilihan dengan nilai lalai memastikan pemanggil lama terus berfungsi. Mereka hanya mengabaikan medan baharu yang tidak dihantar.
def search(q: str, limit: int = 10) -> list:
...Perubahan Pecah Menyakitkan
Menamakan semula tool, membuang argumen atau menjadikan satu argumen wajib ialah perubahan pecah. Klien sedia ada tiba-tiba menghantar panggilan yang tidak lagi sepadan.
Tambah, Kemudian Tandakan sebagai Tidak Digalakkan
Untuk mengembangkan suatu medan, tambahkan medan baharu dan kekalkan medan lama. Tandakan medan lama sebagai tidak digalakkan dalam keterangannya supaya pemanggil tahu untuk beralih.
Versikan dalam Nama Tool
Untuk perubahan pecah yang sebenar, sediakan tool v2 di samping v1. Kedua-duanya berjalan buat sementara waktu, membolehkan klien beralih mengikut kadar masing-masing.
@mcp.tool(name="search_v2")
def search_v2(query: str) -> list:
...Pelayan Melaporkan Versinya
Pelayan anda mengumumkan nama dan versi semasa jabat tangan. Naikkan versinya supaya klien dapat melihat keluaran yang disambungkan kepada mereka.
mcp = FastMCP("my-server")
# version surfaces in server infoIkuti Pemversian Semantik
Gunakan semver: naikkan tampalan untuk pembaikan, versi kecil untuk ciri tambahan dan versi utama apabila anda membuat perubahan pecah. Nombor itu menceritakan perubahannya.
Luaskan, Jangan Sempitkan, Output
Menambahkan medan pada hasil biasanya selamat; membuang medan ialah perubahan pecah. Anggap skema output anda sebagai janji yang dihuraikan oleh klien.
Simpan Log Perubahan
Catat setiap perubahan tool dan skema dalam log perubahan. Pengguna yang menaik taraf perlu melihat perkara yang berubah, perkara baharu dan perkara yang telah dibuang.
Tetapkan Tarikh Tamat untuk Penamatan
Umumkan masa tool lama akan dibuang. Tarikh tamat yang jelas mendorong pemindahan tanpa mengejutkan sesiapa secara mendadak.
Uji dengan Klien Lama
Sebelum keluaran, jalankan ujian anda seperti cara klien lama membuat panggilan kepada anda. Ini mengesan perubahan pecah yang tidak disengajakan dan tidak dapat dilihat oleh pemeriksa jenis.
Semakan Pantas
Perubahan manakah pada tool sedia ada yang selamat untuk klien semasa?
Imbas Kembali: Berkembang dengan Selamat
Utamakan perubahan tambahan, tandakan sesuatu sebagai tidak digalakkan sebelum membuangnya, sediakan v2 untuk perubahan pecah sebenar, ikuti semver dan simpan log perubahan. Anda boleh menerbitkan keluaran dengan yakin! 🚀
Pelajari Python dengan tutor kecerdasan buatan — percuma
Tulis dan jalankan kod sebenar dalam pelayar anda, dapatkan bantuan segera daripada tutor kecerdasan buatan yang tersedia 24/7, dan sambung semula dari tempat anda berhenti di web atau dalam aplikasi.
- Kursus
- 30
- Pelajaran
- 120
Soalan Lazim
Adakah pelajaran “Pemberian Versi Alat dan Skema” percuma?
Ya — sebanyak 3 pelajaran dalam laluan pembelajaran MCP Academy, termasuk “Pemberian Versi Alat dan Skema”, boleh dibaca sepenuhnya secara percuma di web ini. Selepas itu, CoddyKit PRO membuka akses kepada semua pelajaran, serta latihan interaktif dengan penyunting kod terbina dalam dan tutor kecerdasan buatan yang tersedia 24/7. Kursus MCP Academy merangkumi sejumlah 4 pelajaran.
Apakah yang akan saya pelajari dalam “Pemberian Versi Alat dan Skema”?
Kembangkan pelayan anda tanpa merosakkan klien. Anda berlatih MCP Academy menggunakan kod praktikal yang dijalankan terus dalam pelayar, manakala tutor kecerdasan buatan 24/7 menjawab soalan anda semasa anda mengikuti pelajaran.
Adakah saya memerlukan pengalaman untuk memulakan MCP Academy?
Tiada pengalaman terdahulu diperlukan. Pembelajaran MCP Academy di CoddyKit disusun untuk pelajar daripada peringkat pemula hingga lanjutan, jadi anda boleh bermula di sini atau dari awal dan belajar mengikut kadar anda sendiri. Ini ialah pelajaran 4 daripada 4.
Berapa lamakah pelajaran “Pemberian Versi Alat dan Skema” diambil?
Kebanyakan pelajaran CoddyKit mengambil masa kira-kira 5–10 minit. Setiap pelajaran ringkas dan interaktif, jadi anda boleh membuat kemajuan secara berterusan dan menyambung tepat dari tempat anda berhenti di web atau aplikasi.
Bolehkah saya menulis dan menjalankan kod dalam pelajaran MCP Academy ini?
Ya. Setiap pelajaran MCP Academy menyertakan penyunting kod terbina dalam, jadi anda boleh menulis dan menjalankan kod sebenar terus dalam pelayar serta menerima maklum balas kecerdasan buatan serta-merta — tanpa memerlukan persediaan setempat.
Semua pelajaran dalam kursus ini
- Seni Bina Pelayan Berlapis
- Konfigurasi dan Rahsia melalui Persekitaran
- Alat Idempoten dan Sedar Kesan Sampingan
- Pemberian Versi Alat dan Skema