Hàm -> schema công cụ (nội quan)
Gọi công cụ (còn gọi là gọi hàm) cho phép một mô hình yêu cầu chương trình của bạn chạy một hàm: bạn quảng bá một tập công cụ, mô hình trả lời bằng một tên công cụ và các đối số, và bạn thực thi nó. Nhưng mô hình không nhìn thấy Python của bạn -> nó chỉ thấy một schema: một mô tả JSON về tên và tham số của mỗi công cụ. Tự viết các schema đó cho mọi hàm thì nhàm chán và lệch khỏi thực tế ngay khi bạn đổi một chữ ký. Cách sửa là nội quan (introspection): sinh schema thẳng từ hàm.
Mô-đun inspect của Python đọc chữ ký của một hàm lúc chạy. Schema mà các API gọi công cụ mong đợi trông như thế này:
{
"name": "get_weather",
"parameters": {
"type": "object",
"properties": {"city": {"type": "string"}, "days": {"type": "integer"}},
"required": ["city"]
}
}Bạn đang xây tool_schema(func) tạo ra đúng cái đó. Hai ý tưởng làm hết việc:
- Ánh xạ kiểu Python sang kiểu JSON-schema. Đọc chú thích của mỗi tham số và dịch:
int->"integer",float->"number",str->"string",bool->"boolean". Mọi thứ khác mặc định là"string". - Suy ra required từ giá trị mặc định. Một tham số không có mặc định là bắt buộc; một tham số có mặc định là tùy chọn.
inspect.Parameter.emptylà giá trị canh gác cho "không có mặc định".
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.annotationDùng func.__name__ làm tên công cụ. Xây nó sao cho hai hàm có chú thích khác nhau tạo ra hai schema khác nhau rõ ràng, một tham số int hiện ra là "integer" và một str là "string", một tham số có mặc định bị để ngoài required, và một tham số không có mặc định thì nằm trong đó. Đó là hợp đồng mà mọi tích hợp gọi công cụ dựa vào.
Viết tool_schema(func) nội quan một hàm bằng inspect.signature và trả về {"name": func.__name__, "parameters": {"type": "object", "properties": {param: {"type": json_type}}, "required": [...]}}. Ánh xạ int->"integer", float->"number", str->"string", bool->"boolean" (mặc định "string"), và chỉ đặt một tham số vào required khi nó không có mặc định.
Bạn thấy vấn đề gì trong bài học này? Hãy báo cáo nó · Hỏi về bài học này
Bài tập này sẽ sớm mở.
Hoàn thành bài học trước đó để mở khóa bài này. Toàn bộ khóa học là miễn phí, không cần tài khoản, và bạn có thể đọc bài học này ngay bây giờ.
Trình duyệt này đang chặn cookie cho learn.floati.life, nên các bài học bạn đã hoàn thành tại đây không thể mở theo thứ tự. Hãy cho phép cookie cho trang web này và tải lại trang.