OpenAI Agents API vs Responses API vs Agents SDK vs AgentKit: Chọn nền tảng nào để xây dựng

Bốn tên gọi này nằm ở các lớp khác nhau và có một câu hỏi chung đặt ra: ai sẽ điều hành vòng lặp tác nhân? Responses API là lệnh gọi mô hình và mã của bạn chạy vòng lặp xung quanh nó. Agents SDK là một thư viện TypeScript và Python mà bộ thực thi của nó chạy vòng lặp bên trong ứng dụng của bạn. Agents API, đang trong giai đoạn thử nghiệm công khai kể từ ngày 10 tháng 9 năm 2026, sẽ chạy bộ điều khiển Codex của OpenAI cho bạn và duy trì phiên hoạt động, cùng với tùy chọn môi trường biệt lập (sandbox). AgentKit là gói bao gồm Agent Builder, ChatKit, Connector Registry và Evals được ra mắt vào tháng 10 năm 2025, trong đó Agent Builder dự kiến sẽ ngừng hoạt động vào ngày 30 tháng 11 năm 2026.

button

DevDay vào ngày 29 tháng 9 đã thêm tính năng sử dụng máy tính vào Agents API (xem tóm tắt DevDay 2026), điều này khiến câu hỏi về cách đặt tên trở nên khó bỏ qua hơn. Dưới đây: so sánh song song về vòng lặp, tính toán, trạng thái, giá cả và độ trưởng thành, một bảng quyết định, và một lộ trình di chuyển từ vòng lặp Responses thủ công. Để có hướng dẫn thực hành chi tiết về các phiên và phê duyệt, hãy đọc hướng dẫn OpenAI Agents API. Dù bạn chọn cách nào, giao diện HTTP đều có thể kiểm tra được trong Apidog.

Các tùy chọn tác nhân OpenAI so sánh song song

Nguồn: so sánh môi trường chạy tác nhân của OpenAI, tổng quan về Agents API, và trang ngừng hỗ trợ.

Ai chạy vòng lặp

Đây là yếu tố quyết định hầu hết các hàng khác.

Responses API: bạn chạy nó. Các công cụ được lưu trữ như tìm kiếm web, tìm kiếm tệp, trình thông dịch mã và MCP từ xa có thể chạy nhiều lệnh gọi trong một yêu cầu, nhưng các hàm của riêng bạn sẽ quay trở lại bạn. Khi mô hình gọi một hàm, bạn nhận được một mục function_call, chạy nó và gửi một function_call_output với cùng call_id trong yêu cầu tiếp theo. Bạn quyết định khi nào dừng, cách lưu trữ lịch sử (phản hồi được lưu trữ theo mặc định; store: false tắt tính năng đó), và khi nào nén các ngữ cảnh dài bằng context_management và compact_threshold. Hướng dẫn Responses API và hướng dẫn gọi hàm bao gồm vòng lặp đó.

Agents SDK: quy trình của bạn chạy nó. Tài liệu của OpenAI nói rằng trình chạy của SDK "xử lý vòng lặp tác nhân và chuyển giao", trong khi máy chủ của bạn sở hữu việc triển khai, triển khai công cụ, lưu trữ trạng thái và quyết định phê duyệt. Với Sandbox Agents, bộ điều khiển có thể nằm trong cơ sở hạ tầng của bạn trong khi các lệnh chạy trong không gian làm việc cục bộ của Unix, Docker hoặc nhà cung cấp lưu trữ, vì vậy xác thực, nhật ký kiểm tra và xem xét của con người nằm ngoài vùng chứa.

Agents API: OpenAI chạy nó. Bộ điều khiển được quản lý xử lý các phiên, điều phối, nén ngữ cảnh và phục hồi, đồng thời nó thêm các tác nhân phụ, tìm kiếm công cụ và gọi công cụ có lập trình. Các máy chủ MCP từ xa được OpenAI gọi trực tiếp. Mã của bạn vẫn xử lý các công cụ hàm: khi phiên báo cáo một function_call trong required_actions, bạn trả về một sự kiện agent.session.input.tool_result với turn_id và call_id.

Cùng một tác vụ, theo hai cách:

# Responses API: một lệnh gọi mô hình; mã của bạn sở hữu vòng lặp
curl https://api.openai.com/v1/responses \
  -H "Authorization: Bearer $OPENAI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-6.1-sol",
    "reasoning": {"effort": "low"},
    "tools": [{"type": "web_search"}],
    "input": "Summarize the breaking changes in the latest Node.js release."
  }'

# Agents API: một phiên bền vững; OpenAI sở hữu vòng lặp
curl https://api.openai.com/v1/agents/sessions \
  -H "OpenAI-Beta: agents=v1" \
  -H "Authorization: Bearer $OPENAI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "agent": {"model": "gpt-6-astra", "tools": [{"type": "web_search"}]},
    "environment": {"type": "none"},
    "input": "Summarize the breaking changes in the latest Node.js release."
  }'

Các ví dụ trong tài liệu Agents API sử dụng gpt-6-astra; chúng không nói liệu các mô hình khác có được chấp nhận hay không, vì vậy hãy kiểm tra trước khi bạn thay thế bằng gpt-6.1-sol.

Tính toán, trạng thái và chi phí

Tính toán. Agents API có thể cung cấp và quản lý một sandbox cho toàn bộ phiên: đặt environment.type thành openai_hosted, self_hosted hoặc none. Với SDK, bạn chọn và trả tiền cho nhà cung cấp sandbox. Với Responses, mã chạy ở nơi bạn chạy nó, ngoài các công cụ được lưu trữ.

Trạng thái. Một phiên Agents API giữ cấu hình, lượt và mục ở phía OpenAI, vì vậy một sự theo dõi là một sự kiện trên cùng một ID phiên. Với Responses, bạn chuỗi previous_response_id hoặc sử dụng Conversations. Với SDK, trạng thái nằm trong bộ nhớ của bạn hoặc các phiên SDK.

Chi phí. Giá mã thông báo giống nhau ở mọi nơi, vì mỗi tùy chọn gọi cùng một mô hình. Agents API tính "không có phí bổ sung", nhưng các vùng chứa được lưu trữ có giá từ 0,03 đô la (1 GB) đến 0,48 đô la (16 GB) cho mỗi phiên 20 phút. Chi phí bổ sung của SDK là chi phí lưu trữ của riêng bạn. AgentKit không có gói đăng ký riêng, theo giải thích về AgentKit của chúng tôi.

Dữ liệu. Agents API chỉ hỗ trợ lưu trữ dữ liệu tại Hoa Kỳ và không hỗ trợ Zero Data Retention (ZDR), ngay cả với một sandbox tự lưu trữ. Trang kiểm soát dữ liệu của OpenAI liệt kê /v1/agents là không đủ điều kiện ZDR, với trạng thái được giữ lại cho đến khi bị xóa, trong khi /v1/responses đủ điều kiện ZDR với giới hạn và có sẵn trên các điểm cuối theo khu vực như eu.api.openai.com. Nếu ZDR hoặc cư trú tại EU là một yêu cầu, điều đó loại trừ API Agents ngay hôm nay.

AgentKit vào cuối năm 2026: còn lại gì

AgentKit ra mắt vào ngày 6 tháng 10 năm 2025 dưới dạng bốn phần. Đây là vị trí của từng phần:

• Agent Builder: ngừng hỗ trợ được công bố vào ngày 3 tháng 6 năm 2026; dự kiến ngừng hoạt động vào ngày 30 tháng 11 năm 2026. Hướng dẫn di chuyển của OpenAI xuất một quy trình làm việc dưới dạng mã Agents SDK, hoặc tạo lại nó dưới dạng Tác nhân không gian làm việc ChatGPT trên Business, Enterprise hoặc Edu.
• Evals: các đánh giá hiện có sẽ trở thành chỉ đọc vào ngày 31 tháng 10 năm 2026, và bảng điều khiển và API dự kiến ngừng hoạt động vào ngày 30 tháng 11.
• ChatKit: vẫn có sẵn cho tính năng trò chuyện nhúng.
• Connector Registry: bảng điều khiển quản trị cho các trình kết nối và máy chủ MCP trên các sản phẩm của OpenAI.

Như hướng dẫn AgentKit của chúng tôi đã nêu, lộ trình bền vững, ưu tiên mã thông qua AgentKit là Agents SDK.

Nên xây dựng trên cái nào

Trên AWS, Bedrock Managed Agents, được cung cấp bởi OpenAI, mang các khả năng cốt lõi của Agents API để chạy nguyên bản trong AWS. Để kết nối MCP trong cả hai lộ trình ưu tiên mã, hãy xem các máy chủ MCP với tác nhân OpenAI.

Chuyển từ vòng lặp Responses của riêng bạn sang Agents API

Nếu bạn đã xây dựng một vòng lặp trên Responses và muốn OpenAI chạy nó:

1. Ánh xạ các thành phần. Hướng dẫn, mô hình và công cụ chuyển vào agent; vùng chứa của bạn trở thành environment; kho lưu trữ cuộc trò chuyện của bạn trở thành một ID phiên.
2. Chuyển các máy chủ MCP từ xa vào agent.tools. Đặt mã thông báo của chúng vào một kho lưu trữ được đính kèm với vault_ids, không phải trong lời nhắc.
3. Viết lại xử lý hàm. Thay thế vòng lặp function_call_output của bạn bằng một bộ xử lý cho agent.session.requires_action (luồng) hoặc agent.session.action_required (webhook) trả về agent.session.input.tool_result. Các tác nhân phụ không thể gọi các công cụ hàm, vì vậy hãy giữ chúng trên tác nhân chính.
4. Xóa mã nén của bạn. Bộ điều khiển tự động nén ngữ cảnh.
5. Chuyển sang các sự kiện. Truyền trực tuyến kết quả lượt (agent.session.turn.completed, agent.session.turn.failed, agent.session.turn.cancelled) hoặc sử dụng webhook. Một phiên không hoạt động không có nghĩa là thành công.
6. Kiểm tra các ràng buộc. Chỉ cư trú tại Hoa Kỳ, không ZDR và một tiêu đề beta.

Giữ cả hai trong một dự án Apidog

Trước khi bạn chuyển đổi, hãy chạy phiên bản cũ và mới song song. Trong một dự án Apidog, hãy tạo một thư mục Responses và một thư mục Agents API chia sẻ một môi trường với {{OPENAI_API_KEY}} và một biến mô hình. Gửi cùng một lời nhắc thông qua cả hai, xác nhận về mã trạng thái và các trường đầu ra bắt buộc, và mở luồng Agents API dưới dạng yêu cầu SSE để xem các sự kiện lượt. Lưu các lần chạy làm kịch bản kiểm thử và chạy nó trong CI với Apidog CLI, để một thay đổi beta hiển thị dưới dạng kiểm tra thất bại. Hướng dẫn độ tin cậy tác nhân AI sản xuất bao gồm những gì cần xác nhận. Tải xuống Apidog để thiết lập.

Câu hỏi thường gặp

Agents API có thay thế Responses API không? Chưa có thông báo ngừng hỗ trợ nào. Tổng quan về tác nhân của OpenAI liệt kê API Agents, SDK Agents và API Responses là các tùy chọn hiện tại cho các nhu cầu khác nhau.

OpenAI AgentKit có bị ngừng hỗ trợ không? Một phần. Agent Builder và Evals dự kiến ngừng hoạt động vào ngày 30 tháng 11 năm 2026; ChatKit vẫn có sẵn.

SDK Agents có sử dụng Agents API không? Không. SDK chạy trong ứng dụng của bạn; API Agents chạy một bộ điều khiển được quản lý trong dịch vụ của OpenAI.

Điều gì đã xảy ra với Assistants API? Trang ngừng hỗ trợ của OpenAI đã đặt thời điểm loại bỏ nó vào ngày 26 tháng 8 năm 2026 và hướng dẫn các nhà phát triển đến API Responses và Conversations.

Tùy chọn nào rẻ nhất? Giá mã thông báo giống nhau trên tất cả các tùy chọn. Sự khác biệt là các vùng chứa được lưu trữ trên Agents API so với việc tự lưu trữ với SDK hoặc Responses.

Chọn một lộ trình trong tuần này

Chọn dựa trên ai nên chạy vòng lặp, sau đó chứng minh bằng các yêu cầu trước khi viết ứng dụng. Nếu bạn đang bắt đầu mới, hãy thử một phiên Agents API và so sánh đầu ra của nó với thiết lập Responses hiện tại của bạn trong Apidog.

button