Fungsi -> Skema Alat (Introspeksi)
Tool calling (juga dikenal sebagai function calling) memungkinkan model untuk meminta programmu menjalankan sebuah fungsi: kamu menyediakan sekumpulan tools, model membalas dengan nama tool dan argumen, lalu kamu mengeksekusinya. Tapi model tidak bisa melihat Python milikmu -> ia hanya melihat schema: deskripsi JSON dari nama dan parameter setiap tool. Menulis skema tersebut secara manual untuk setiap fungsi sangat melelahkan dan akan tidak sinkron saat kamu mengubah sebuah signature. Solusinya adalah introspection: buat skema langsung dari fungsinya.
Modul inspect Python membaca signature fungsi saat runtime. Skema yang diharapkan oleh tool-calling APIs terlihat seperti ini:
{
"name": "get_weather",
"parameters": {
"type": "object",
"properties": {"city": {"type": "string"}, "days": {"type": "integer"}},
"required": ["city"]
}
}Kamu sedang membangun tool_schema(func) yang menghasilkan hal itu tepat. Dua ide melakukan semua pekerjaannya:
- Petakan tipe Python ke tipe JSON-schema. Baca anotasi setiap parameter dan terjemahkan:
int->"integer",float->"number",str->"string",bool->"boolean". Atur sisanya ke"string"secara default. - Ambil dari default. Parameter dengan tanpa default wajib ada; parameter dengan default bersifat opsional.
inspect.Parameter.emptyadalah penanda untuk "tanpa default".
import inspect
sig = inspect.signature(func)
for name, param in sig.parameters.items():
is_required = param.default is inspect.Parameter.empty
json_type = ... # from param.annotationGunakan func.__name__ untuk nama tool. Buat agar dua fungsi dengan anotasi berbeda menghasilkan dua skema yang jelas berbeda, param int muncul sebagai "integer" dan str sebagai "string", parameter default tidak dimasukkan ke required, dan yang tidak default ada di dalamnya. Itu adalah kontrak yang diandalkan setiap integrasi pemanggilan tool.
Tulis tool_schema(func) yang mengintrospeksi sebuah function dengan inspect.signature dan mengembalikan {"name": func.__name__, "parameters": {"type": "object", "properties": {param: {"type": json_type}}, "required": [...]}}. Petakan int->"integer", float->"number", str->"string", bool->"boolean" (default "string"), dan masukkan parameter ke dalam required hanya jika tidak ada default.
Ada masalah di pelajaran ini? Laporkan · Tanya tentang pelajaran ini
Latihan ini akan segera dibuka
Selesaikan pelajaran sebelumnya agar pelajaran ini terbuka. Seluruh kursus ini gratis, tidak butuh akun, dan kamu bisa baca pelajaran ini sekarang.
Browser ini memblokir cookie untuk learn.floati.life, jadi pelajaran yang sudah kamu selesaikan di sini tidak bisa dibuka berurutan. Izinkan cookie untuk situs ini dan muat ulang.