Gọi hàm trong API OpenAI

Gọi hàm cho phép bạn kết nối các mô hình OpenAI với các công cụ và hệ thống bên ngoài. Điều này hữu ích cho nhiều việc, chẳng hạn như trao năng lực cho trợ lý AI hoặc xây dựng các tích hợp sâu giữa ứng dụng của bạn và LLM.

Tìm hiểu thêm trong hướng dẫn dành cho nhà phát triển về gọi hàm của chúng tôi.

Vào tháng 6 năm 2024, chúng tôi đã ra mắt đầu ra có cấu trúc. Khi bạn bật tính năng này bằng cách đặt strict: true trong định nghĩa hàm, đầu ra có cấu trúc đảm bảo rằng các đối số do mô hình tạo ra cho một lệnh gọi hàm khớp chính xác với Lược đồ JSON bạn đã cung cấp trong định nghĩa hàm.

Vào tháng 10 năm 2024, chúng tôi đã ra mắt tính năng “Tạo bất cứ thứ gì”, cho phép nhà phát triển mô tả một hàm, dán trực tiếp hàm đó hoặc dán mã của bạn và tạo một lược đồ hàm hợp lệ. Tìm hiểu thêm về “Tạo bất cứ thứ gì” trong bài viết tại trung tâm trợ giúp này

Tôi có thể sử dụng gọi hàm như thế nào?

Gọi hàm hữu ích cho rất nhiều trường hợp sử dụng, chẳng hạn như:

• Cho phép trợ lý tìm nạp dữ liệu:

• Cho phép trợ lý thực hiện hành động:

• Cho phép trợ lý thực hiện tính toán:

• Xây dựng quy trình làm việc phong phú:

• một quy trình trích xuất dữ liệu tìm nạp văn bản thô, sau đó chuyển đổi thành dữ liệu có cấu trúc và lưu vào cơ sở dữ liệu.

Gọi hàm được hỗ trợ trong API Responses, hợp nhất các khả năng trước đây được tách ra giữa API hoàn thiện hội thoại và API Assistants.

Tôi có thể sử dụng chế độ JSON như thế nào?

Khi bật chế độ JSON, đầu ra của mô hình được đảm bảo là JSON hợp lệ, ngoại trừ một số trường hợp biên mà bạn nên phát hiện và xử lý phù hợp.

Để yêu cầu chế độ JSON với API hoàn thiện hội thoại, hãy đặt response_format thành { "type": "json_object" } trên các mô hình được hỗ trợ. Với API Responses, hãy đặt text.format thành { "type": "json_object" }, ví dụ text: { "format": { "type": "json_object" } }, nếu áp dụng. Trong cả hai API, chế độ JSON chỉ hoạt động khi đáp ứng các điều kiện tiên quyết về mô hình/tin nhắn/công cụ (ví dụ: mô hình hỗ trợ json_object, cuộc trò chuyện có hướng dẫn tạo JSON và mọi ràng buộc công cụ đều tương thích). Ít nhất một tin nhắn yêu cầu hoặc tin nhắn đầu vào trong ngữ cảnh đầu vào hiệu lực phải chứa json ở dạng không phân biệt chữ hoa chữ thường, chẳng hạn như JSON, json hoặc Json; nếu không, API sẽ trả về lỗi. Trong Responses, chỉ riêng trường hướng dẫn cấp cao nhất không đáp ứng xác thực này. Khi dùng gọi hàm trên các mô hình/đường dẫn tương thích, các ràng buộc JSON được áp dụng tự động cho đối số của lệnh gọi hàm; các mô hình hoặc tổ hợp công cụ/định dạng phản hồi không tương thích có thể bị từ chối hoặc có thể không dùng lấy mẫu bị ràng buộc bởi JSON.

Lưu ý quan trọng:

• Khi sử dụng chế độ JSON, bạn phải luôn hướng dẫn mô hình tạo JSON thông qua một tin nhắn nào đó trong cuộc trò chuyện, ví dụ thông qua tin nhắn hệ thống của bạn. Nếu bạn không đưa vào hướng dẫn rõ ràng để tạo JSON, mô hình có thể tạo một luồng khoảng trắng không kết thúc và yêu cầu có thể chạy liên tục cho đến khi đạt giới hạn token. Để giúp đảm bảo bạn không quên, chế độ JSON sẽ từ chối yêu cầu trừ khi các tin nhắn đầu vào hoặc hướng dẫn liên quan chứa từ json ở một dạng nào đó, không phân biệt chữ hoa chữ thường.

• Chế độ JSON không đảm bảo đầu ra khớp với bất kỳ lược đồ cụ thể nào, mà chỉ đảm bảo rằng đầu ra hợp lệ và được phân tích cú pháp không có lỗi. Bạn nên dùng đầu ra có cấu trúc để đảm bảo đầu ra khớp với lược đồ của bạn; hoặc nếu không thể, bạn nên dùng thư viện xác thực và có thể thử lại để đảm bảo đầu ra khớp với lược đồ mong muốn.

• Ứng dụng của bạn phải phát hiện và xử lý các trường hợp biên có thể khiến đầu ra của mô hình không phải là một đối tượng JSON hoàn chỉnh (xem bên dưới)