Chuyển từ Completions sang Chat Completions trong OpenAI API

Chat Completions là API tiêu chuẩn để 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 nó qua 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.

Tính đến ngày 11 tháng 3 năm 2025, chúng tôi đã phát hành các khối nền tảng của nền tảng tác nhân mới. Để biết chi tiết, 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 web, Tìm kiếm tệp và Sử dụng máy tính, cùng Agents SDK của chúng tôi với Tracing.

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 chat 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 trong danh sách có hai thuộc tính: role và content.

  • 'role' có thể nhận một trong ba giá trị: 'system', 'user' hoặc 'assistant'

  • 'content' chứa văn bản của tin nhắn từ vai trò đó.

• Chỉ dẫn hệ thống có thể đưa ra hướng 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ý 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ư bạn có thể thấy bên dưới:

Giờ đây, việc 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'}]

Chỉ dẫn hệ thống

Bạn cũng có thể dùng chỉ 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ụ, dùng một chỉ 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 ra kết quả 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 tùy chọn không yêu cầu tự quản lý lịch sử cuộc trò chuyện của tin nhắn, hãy xem Assistants API.