Gọi công cụ

Gọi công cụ cho phép model tạo đối số hàm có cấu trúc. Ứng dụng của bạn phải xác thực đối số, cấp quyền và thực thi thao tác, sau đó trả về kết quả. Model không bao giờ tự thực thi hàm của bạn.

Chọn giao thức

Trường hợp sử dụngGiao thức
Khả năng tương thích rộng với SDK và clientOpenAI Chat Completions
Quy trình agent OpenAI mớiOpenAI Responses
Công cụ theo định dạng ClaudeAnthropic Messages
Gọi hàm theo định dạng GeminiAPI tương thích Gemini

OpenAI Chat Completions khai báo hàm trong tools[].function. OpenAI Responses đặt trực tiếp name, descriptionparameters trên công cụ type: "function". Không sao chép nội dung yêu cầu giữa các giao thức.

Danh sách kiểm tra để thực thi an toàn

  1. Xác thực đối số bằng một lược đồ nghiêm ngặt.
  2. Kiểm tra quyền của người dùng cuối.
  3. Áp dụng thời gian chờ và giới hạn tài nguyên.
  4. Yêu cầu xác nhận đối với thao tác ghi hoặc thao tác phá hủy dữ liệu.
  5. Bảo đảm các ID gọi công cụ lặp lại có tính lũy đẳng.
  6. Trả về lỗi có cấu trúc thay vì giả vờ thành công.

Việc xử lý thành công một prompt văn bản không chứng minh rằng tính năng gọi công cụ hoạt động. Hãy xác minh chính xác tổ hợp model, giao thức và client trước khi đưa vào môi trường production.

Xem hướng dẫn OpenAI Chat Completions, hướng dẫn OpenAI ResponsesTài liệu tham chiếu API.