Gọi hàm trong API của 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 như tăng cường khả năng cho trợ lý AI, hoặc xây dựng tích hợp sâu giữa các ứng dụng của bạn và các mô hình ngôn ngữ lớn.

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

Vào tháng 6 năm 2024, chúng tôi đã ra mắt Kết quả Có cấu trúc. Trên các mô hình và cấu hình yêu cầu được hỗ trợ, khi mô hình phát ra một cuộc gọi hàm, việc thiết lậpnghiêm ngặt: đúngtrong định nghĩa hàm của bạn đảm bảo rằng các đối số được tạo ra tuân thủ theo sơ đồ được cung cấp, với điều kiện sơ đồ sử dụng tập hợp con JSON Schema được hỗ trợ và đáp ứng các yêu cầu chế độ nghiêm ngặt. Các yêu cầu với sơ đồ không được hỗ trợ hoặc không phù hợp sẽ bị từ chối kèm theo lỗi.

Vào tháng 10 năm 2024, chúng tôi đã ra mắt tính năng ‘Generate Anything’, cho phép các nhà phát triển mô tả một hàm, dán trực tiếp hoặc dán mã của bạn và tạo ra một sơ đồ hàm hợp lệ. Tìm hiểu thêm về ‘Generate Anything’ trongbài viết trung tâm trợ giúp ở đây.

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

Gọi hàm hữu ích cho một số lượng lớn các trường hợp sử dụng, chẳng hạn như:

• Cho phép trợ lý truy xuất dữ liệu:

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

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

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

• một quy trình trích xuất dữ liệu lấy văn bản thô, sau đó chuyển đổi nó 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ợ trongAPI Phản hồi, hợp nhất các khả năng trước đây đã bị tách rời trênAPI Hoàn tất Cuộc trò chuyệnvàAPI Trợ lý.

Làm thế nào tôi có thể sử dụng chế độ JSON?

Khi chế độ JSON được bật, đầ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 (Chat Completions), hãy đặtđịnh_dạng_phản_hồiđến{ "type": "json_object" }trên các mẫu được hỗ trợ. Với API Responses, hãy thiết lậpvăn bản.định dạngđến{ "type": "json_object" }, ví dụvăn bản: { "định dạng": { "loại": "đối_tượng_json" } }, nếu áp dụng được. Trong bất kỳ API nào, chế độ JSON chỉ hoạt động khi các yêu cầu tiên quyết về mô hình/tin nhắn/công cụ được đáp ứng (ví dụ, mô hình hỗ trợđối_tượng_json, cuộc trò chuyện bao gồm các hướng dẫn để tạo JSON, và bất kỳ giới hạn công cụ nào cũng 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 quả phải chứajsondưới dạng không phân biệt chữ hoa chữ thường, chẳng hạn nhưJSON,json, hoặcJson; nếu không, API sẽ trả về lỗi. Trong Responses, chỉ trường instructions cấp cao nhất sẽ không đủ để thỏa mãn việc xác thực này. Khi gọi hàm được sử dụng trên các mô hình/đường dẫn tương thích, các ràng buộc JSON sẽ được áp dụng tự động cho các đối số của lệnh gọi hàm; các mô hình không tương thích hoặc kết hợp công cụ/định dạng phản hồi có thể bị từ chối hoặc có thể không sử dụng lấy mẫu theo ràng buộc JSON.

Lưu ý quan trọng:

• Khi sử dụng chế độ JSON, bạn luôn phải 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 bao gồm một hướng dẫn rõ ràng để tạo JSON, mô hình có thể tạo ra một luồng khoảng trắng vô tận và yêu cầu có thể tiếp tục 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 từ chối các 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ừ.jsondưới một hình thức nào đó, không phân biệt chữ hoa chữ thường.

• Chế độ JSON sẽ không đảm bảo kết quả đầu ra khớp với bất kỳ sơ đồ cụ thể nào, chỉ đảm bảo rằng nó hợp lệ và phân tích mà không có lỗi. Bạn nên sử dụng Đầu ra Có cấu trúc để đảm bảo nó khớp với sơ đồ của bạn, hoặc nếu điều đó không thể, bạn nên sử dụng một thư viện xác thực và có thể thử lại để đảm bảo rằng kết quả đầu ra khớp với sơ đồ mong muốn của bạ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ể dẫn đến việc đầu ra của mô hình không phải là một đối tượng JSON đầy đủ (xem bên dưới)