Bỏ qua đến nội dung chính

Tool functions

📖 Nội dung bài học

Tóm tắt

Khi xây dựng ứng dụng AI với Claude, bạn thường cần cho nó truy cập vào thông tin thời gian thực hoặc khả năng thực hiện hành động. Đây là lúc tool function phát huy tác dụng - chúng là các hàm Python mà Claude có thể gọi khi cần dữ liệu bổ sung để giúp người dùng.

Hình ảnh trên cho thấy ba tool thiết yếu mà bạn sẽ triển khai: lấy ngày/giờ hiện tại, cộng thời gian vào ngày và đặt lời nhắc. Hãy bắt đầu với cái đầu tiên.

Tool function là gì?

Một tool function là một hàm Python thông thường, được thực thi tự động khi Claude quyết định cần thêm thông tin để giúp người dùng. Ví dụ, nếu ai đó hỏi "Mấy giờ rồi?", Claude sẽ gọi tool ngày/giờ của bạn để lấy thời gian hiện tại.

Đây là một ví dụ về tool function thời tiết. Lưu ý cách nó xác thực đầu vào và cung cấp thông báo lỗi rõ ràng - đây là các phương pháp hay nhất quan trọng.

Các phương pháp hay nhất cho Tool function

Khi viết tool function, hãy làm theo các hướng dẫn sau:

  • Sử dụng tên mô tả: Cả tên hàm và tên tham số của bạn phải cho biết rõ mục đích của chúng
  • Xác thực đầu vào: Kiểm tra xem các tham số bắt buộc có trống hoặc không hợp lệ không và đưa ra lỗi khi chúng có
  • Cung cấp thông báo lỗi có ý nghĩa: Claude có thể xem thông báo lỗi và có thể thử lại việc gọi hàm với các tham số đã sửa

Việc xác thực đặc biệt quan trọng vì Claude học hỏi từ các lỗi. Nếu bạn đưa ra một lỗi rõ ràng như "Địa điểm không được để trống", Claude có thể thử gọi hàm lại với một giá trị địa điểm thích hợp.

Xây dựng Tool function đầu tiên của bạn

Hãy tạo một hàm để lấy ngày và giờ hiện tại. Hàm này sẽ chấp nhận một tham số định dạng ngày để Claude có thể yêu cầu thời gian ở các định dạng khác nhau:

def get_current_datetime(date_format="%Y-%m-%d %H:%M:%S"):
    if not date_format:
        raise ValueError("date_format cannot be empty")
    return datetime.now().strftime(date_format)

Hàm này dùng module datetime của Python để lấy thời gian hiện tại và định dạng nó theo chuỗi định dạng được cung cấp. Định dạng mặc định cho bạn năm-tháng-ngày giờ:phút:giây.

Bạn có thể kiểm tra nó với các định dạng khác nhau:


get_current_datetime()

get_current_datetime("%H:%M")

Kiểm tra xác thực đảm bảo Claude không thể truyền một chuỗi trống cho định dạng ngày. Mặc dù lỗi cụ thể này không có khả năng xảy ra, nhưng nó minh họa mẫu xác thực đầu vào và cung cấp các thông báo lỗi hữu ích mà Claude có thể học hỏi.

Các bước tiếp theo

Tạo hàm chỉ là bước đầu tiên. Tiếp theo, bạn cần viết một lược đồ JSON mô tả hàm cho Claude, sau đó tích hợp nó vào hệ thống trò chuyện của bạn. Cách tiếp cận tool function này cung cấp cho Claude các khả năng mạnh mẽ trong khi vẫn giữ cho mã của bạn được tổ chức và dễ bảo trì.

Downloads

🔁 Bài học liên quan

📚 Nguồn & ghi nhận

Bài học có hữu ích không?

Góp ý / Báo lỗiPhát hiện sai sót hoặc có ý tưởng cải thiện?