Chương trình học Bài 230 trên tổng số 250 · Dự án: Agent Nghiên cứu Sử dụng Công cụ
Dự án: Agent Nghiên cứu Sử dụng Công cụ

Danh mục Công cụ + Bộ điều phối

Mọi "AI agent" mà bạn từng đọc qua đều dựa trên một thành phần không mấy hào nhoáng: một tool registry. Mô hình sẽ phát ra thứ gì đó giống như {"tool": "search", "args": {"query": "weather"}}, và your code phải tìm đúng Python function, kiểm tra các arguments có hợp lý không, chạy nó, và gửi kết quả trở lại. Nếu làm sai lớp này, toàn bộ agent sẽ gặp lỗi crash trong production chỉ vì một argument sai định dạng. Bài học đầu tiên của dự án xây dựng chính xác lớp đó, và bạn sẽ tái sử dụng ý tưởng này trong mọi bài học sau đó.

Bạn đang xây dựng bộ điều phối cho một agent nghiên cứu. Nó cần hai công cụ để bắt đầu: một search(query)để tra cứu sự thậtcalc(op, a, b)và một để thực hiện tính toán. Registry ánh xạ một tên công cụđến một cặp: hàm và lược đồ đối số

(tập hợp các tên đối số mà công cụ chấp nhận). Dispatch là cổng mà mọi thứ đi qua.
class Registry:
    def __init__(self):
        self.tools = {}   # name -> {"fn": callable, "args": set_of_arg_names}

    def register(self, name, fn, args):
        self.tools[name] = {"fn": fn, "args": set(args)}

    def dispatch(self, name, args):
        # 1. unknown tool name      -> raise KeyError
        # 2. args keys != schema    -> raise ValueError (missing OR extra)
        # 3. otherwise              -> call fn(**args) and return the result
        ...

Quy tắc dispatch phải thực thi(đây là mục đích chính của bài tập):

  • Công cụ không xác định tên -> raise KeyError. Agent đã yêu cầu thứ không tồn tại.
  • Các key của args dict phải khớp chính xác với schema đã đăng ký . Nếu thiếu hoặc dư một argument -> raise ValueError. Điều này ngăn chặn một {"q": ...} (sai key) âm thầm không làm gì cả.
  • một cuộc gọi hợp lệ -> chạy fn(**args) và trả về bất cứ thứ gì nó trả về.

Tại sao dùng set cho schema? Vì việc kiểm tra chỉ là thiết lập tính bằng nhau: set(args) == self.tools[name]["args"]. Nếu kết quả là false, hãy xác định xem các keys bị thiếu hay dư thừa và raise ValueError trong cả hai trường hợp. Gọi với fn(**args) sẽ trải dict thành các keyword arguments, vì vậy function signature sẽ thực hiện việc liên kết cuối cùng.

A quản lý tuyển dụng khi đọc "đã xây dựng một agent sử dụng công cụ" thực sự đang hỏi: bạn có xử lý được các trường hợp lỗi không? Agent được đưa vào sử dụng là cái mà dispatcher từ chối các lời gọi lỗi một cách rõ ràng thay vì làm hỏng quá trình chạy. Nhấn Run để đăng ký hai công cụ và xem các lời gọi tốt thành công trong khi các lời gọi lỗi sẽ báo lỗi.

Đến lượt bạn

Xây dựng một lớp Registry. register(name, fn, args) lưu trữ hàm và lược đồ tên đối số của nó (sử dụng một set). dispatch(name, args) phải: ném ra KeyError cho một tên công cụ không xác định; ném ra ValueError nếu các khóa của args không khớp chính xác với lược đồ (thiếu hoặc thừa); nếu không thì gọi fn(**args) và trả về kết quả. Đăng ký một công cụ search(query) và một công cụ calc(op, a, b) để bộ điều phối có thứ thực tế để định tuyến.

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ờ.