Mengembalikan Hasil yang Berguna
Kirimkan teks yang dapat digunakan model dan pengguna.
Mengembalikan Hasil yang Berguna adalah pelajaran MCP Academy gratis di CoddyKit. Ini adalah pelajaran 3 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.
Hasil Dikembalikan ke Model
Apa pun yang dikembalikan tool Anda diberikan kembali kepada AI sebagai konteks, sehingga memengaruhi jawaban model berikutnya kepada pengguna. 🔁
Kembalikan String
Hasil paling sederhana yang berguna adalah string biasa. FastMCP membungkusnya sebagai konten teks yang dibaca langsung oleh model.
@mcp.tool()
def greet(name: str) -> str:
return "Hello, " + nameBuat Teks yang Menjelaskan Dirinya Sendiri
Model tidak memiliki konteks lain, jadi teks Anda harus dapat menjelaskan dirinya sendiri. Kembalikan The total is 42, bukan hanya 42.
Angka Diubah Menjadi String
Jika Anda mengembalikan int atau float, FastMCP mengubahnya menjadi teks untuk Anda. Namun, menambahkan label membuat nilainya lebih jelas bagi model.
@mcp.tool()
def add(a: int, b: int) -> int:
return a + bKembalikan Data Terstruktur
Kembalikan dict atau list, lalu FastMCP akan menserialisasikannya menjadi JSON, sehingga model memperoleh bidang yang bersih dan mudah diurai, bukan prosa bebas.
@mcp.tool()
def stats() -> dict:
return {"users": 12, "active": 9}Buat Hasil Tetap Ringkas
Setiap token yang dikembalikan menghabiskan anggaran konteks model, jadi ringkaslah hasil Anda hingga hanya mencakup hal yang benar-benar menjawab permintaan. Lebih sedikit gangguan menghasilkan jawaban yang lebih tajam.
Format untuk Kemudahan Membaca
Jika hasil memiliki beberapa bagian, sedikit struktur akan membantu. Baris-baris pendek dengan label lebih baik daripada satu kalimat panjang yang harus diurai model.
Kembalikan Error sebagai Teks
Jika terjadi masalah, mengembalikan pesan yang jelas memungkinkan model menjelaskan masalah dan mencoba memperbaikinya, alih-alih menebak.
if not city:
return "Error: city is required."Jangan Kembalikan Rahasia
Hasil sampai ke model dan sering kali juga ke pengguna, jadi jangan pernah menyertakan rahasia seperti kunci API atau kata sandi mentah dalam hasil yang Anda kembalikan.
Bentuk yang Konsisten Membantu
Kembalikan bentuk yang sama pada setiap pemanggilan agar model mengetahui hal yang diharapkan. Struktur yang berubah-ubah dapat menyebabkan jawaban disalahpahami.
Sesuaikan dengan Janji Tool
Hasil Anda harus memberikan tepat seperti yang dijanjikan dalam deskripsi. Jika Anda mengatakan bahwa tool mengembalikan harga, kembalikan harga, bukan seluruh laporan.
Pemeriksaan Singkat
Apa yang terjadi ketika tool Anda mengembalikan dict Python?
Ringkasan
Hasil Anda menjadi konteks model: kembalikan teks atau JSON yang jelas, ringkas, dan dapat menjelaskan dirinya sendiri; pertahankan bentuk yang konsisten; dan jangan pernah membocorkan rahasia. ✅
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 “Mengembalikan Hasil yang Berguna” gratis?
Ya — teks lengkap “Mengembalikan Hasil yang Berguna” 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 “Mengembalikan Hasil yang Berguna”?
Kirimkan teks yang dapat digunakan model dan pengguna. 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 3 dari 4.
Berapa lama pelajaran “Mengembalikan Hasil yang Berguna” 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