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 sang tin nhắn
Để trò chuyện với các mô hình theo cách tương tác và linh hoạt hơn, bạn có thể sử dụng tin nhắn ở định dạng trò chuyện thay cho 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 câu lệnh duy nhất, bạn gửi một danh sách các đối tượng tin nhắn làm dữ liệu đầu vào.
Mỗi tin nhắn có một role và thường có content.
Các vai trò phổ biến gồm system, user, assistant, developer và tool. Tin nhắn của 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 lệnh gọi công cụ của trợ lý. Để tương thích ngược, tin nhắn của hàm vẫn có thể được chấp nhận và chuyển đổi thành tin nhắn của công cụ khi máy chủ xử lý. Tin nhắn của nhà phát triển có thể được ánh xạ lại tùy theo khả năng hỗ trợ của mô hình.
Trường content chứa nội dung văn bản của tin nhắn do vai trò đó gửi.
Chỉ dẫn hệ thống có thể đưa ra hướng dẫn tổng quát 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ý sẽ phản hồi tương ứng.
Ngay cả các yêu cầu Completions cơ bản cũng có thể được thực hiện qua Chat Completions, như minh họa dưới đây:
| Trước đây | Hiện nay |
|---|---|
'prompt' : 'tell me a joke' | 'messages': [{'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: chỉ cần thêm tin nhắn vào danh sách tin nhắn của 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.