Chat Completions là API tiêu chuẩn để sử dụng với các mô hình mới nhất của OpenAI. Bạn có thể tìm hiểu cách bắt đầu với API này bằng hướng dẫn dành cho nhà phát triển về tạo văn bản của chúng tôi.
Kể từ ngày 11 tháng 3 năm 2025, chúng tôi đã phát hành các khối xây dựng của nền tảng Tác nhân mới. Để biết chi tiết, hãy xem tài liệu API của chúng tôi về Responses API, các công cụ gồm Tìm kiếm trên web, Tìm kiếm tệp và Sử dụng máy tính, cũng như SDK Tác nhân của chúng tôi với Truy vết.
Từ câu lệnh đến tin nhắn
Để có cuộc trò chuyện tương tác và linh hoạt hơn với các mô hình của chúng tôi, bạn có thể dùng tin nhắn ở định dạng trò chuyện thay vì kiểu câu lệnh cũ dùng với completions.
Cách hoạt động như sau:
Thay vì gửi một chuỗi duy nhất làm câu lệnh, bạn gửi một danh sách tin nhắn làm đầu vào.
Mỗi tin nhắn có một
rolevàcontent.Các vai trò phổ biến gồm
system,user,assistant,developervàtool. Tin nhắn công cụ được dùng cho kết quả của công cụ/hàm và phải tương ứng với các lệnh gọi công cụ của trợ lý. Để tương thích ngược, tin nhắn hàm vẫn có thể được chấp nhận và chuyển đổi thành tin nhắn công cụ trong quá trình xử lý trên máy chủ. Tin nhắn của nhà phát triển có thể được ánh xạ lại tùy theo mức hỗ trợ của mô hình.contentchứa văn bản của tin nhắn từ vai trò đó.Hướng dẫn hệ thống có thể đưa ra chỉ dẫn cấp cao cho cuộc trò chuyện
Các tin nhắn được xử lý theo thứ tự xuất hiện trong danh sách, và trợ lý phản hồi tương ứng.
Ngay cả các yêu cầu Completions cơ bản cũng có thể được hoàn thành thông qua Chat Completions, như bạn có thể thấy bên dưới:
| Trước đây | Hiện nay | | 'prompt' : 'tell me a joke' | 'messages': <br>[{'role':'user', 'content':'tell me a joke'}] |
Giờ đây, việc trao đổi qua lại với mô hình trở nên dễ dàng hơn bao giờ hết bằng cách mở rộng danh sách tin nhắn trong cuộc trò chuyện.
'messages': [{'role':'user', 'content':'kể cho tôi một câu chuyện cười'},
{'role':'assistant', 'content':'tại sao con gà băng qua đường'},
{'role':'user', 'content':'Tôi không biết, tại sao con gà băng qua đường'}]Hướng dẫn hệ thống
Bạn cũng có thể dùng hướng dẫn cấp hệ thống để định hướng hành vi của mô hình trong suốt cuộc trò chuyện. Ví dụ: sử dụng một hướng dẫn hệ thống và một tin nhắn như thế này
'messages': [{'role':'system', 'content':'Bạn là một trợ lý nói chuyện như Shakespeare.'},
{'role':'user', 'content':'kể cho tôi một câu chuyện cười'}, sẽ cho kết quả tương tự như
{...
'message': {'role':'assistant',
'content':'Tại sao con gà băng qua đường? Để sang bên kia, nhưng quả thật bên kia đầy hiểm nguy và nguy hiểm, nên nó nhanh chóng quay trở lại nơi nó đã đến, đúng vậy!'}
...}Nếu bạn muốn khám phá các lựa chọn không đòi hỏi bạn phải tự quản lý lịch sử cuộc trò chuyện dạng tin nhắn, hãy xem Assistants API.