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 thuộc các lớp khác nhau, nhưng câu hỏi triển khai cốt lõi là: ai đ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 bên ngoài. Agents SDK là thư viện TypeScript/Python, trong đó trình chạy SDK điều hành vòng lặp trong ứng dụng. Agents API, ở beta công khai từ ngày 10 tháng 9 năm 2026, vận hành bộ điều khiển Codex do OpenAI quản lý, duy trì phiên và có thể dùng sandbox. AgentKit là bộ công cụ gồm Agent Builder, ChatKit, Connector Registry và Evals, ra mắt tháng 10 năm 2025; Agent Builder dự kiến ngừng hoạt động ngày 30 tháng 11 năm 2026.

Dùng thử Apidog ngay hôm nay

DevDay ngày 29 tháng 9 đã bổ sung khả năng sử dụng máy tính vào Agents API (xem tóm tắt DevDay 2026). Vì vậy, trước khi chọn API hoặc SDK, hãy so sánh vòng lặp, môi trường tính toán, trạng thái, chi phí và ràng buộc dữ liệu. Để triển khai phiên và cơ chế phê duyệt, xem hướng dẫn OpenAI Agents API. Bạn cũng có thể kiểm tra mọi giao diện HTTP trong Apidog.

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

	Agents API	Responses API	Agents SDK	AgentKit
Nó là gì	Môi trường chạy tác nhân được quản lý trên bộ điều khiển Codex	Điểm cuối mô hình: POST /v1/responses	Thư viện cho TypeScript và Python	Gói gồm Agent Builder, ChatKit, Connector Registry, Evals
Ai chạy vòng lặp	OpenAI	Mã của bạn	Trình chạy SDK trong ứng dụng	Quy trình Agent Builder; có thể xuất sang SDK hoặc nhúng bằng ChatKit
Nơi chạy tính toán	Sandbox OpenAI, sandbox riêng hoặc không dùng sandbox	Môi trường của bạn và các công cụ được lưu trữ	Runtime và nhà cung cấp sandbox của bạn	Không áp dụng
Nơi lưu trạng thái	Phiên OpenAI: cấu hình, lượt, mục	Lịch sử riêng, previous_response_id hoặc Conversations API	Bộ nhớ riêng, phiên SDK hoặc trạng thái Responses	Quy trình đã xuất bản, có phiên bản
Chi phí	Token, công cụ và vùng chứa được lưu trữ; không có phí nền tảng bổ sung	Token và công cụ	Token, công cụ và chi phí hạ tầng của bạn	Sử dụng API cơ bản; không có gói đăng ký riêng
Nỗ lực tích hợp	Thấp	Cao	Trung bình	Không được đánh giá
Trạng thái	Beta công khai, cần OpenAI-Beta: agents=v1	Được khuyến nghị cho dự án mới	Hiện tại	Agent Builder/Evals sẽ ngừng hoạt động ngày 30/11/2026; ChatKit vẫn hoạt động
Kiểm soát dữ liệu	Chỉ lưu trữ tại Hoa Kỳ, không đủ điều kiện ZDR	Có thể đủ điều kiện ZDR với giới hạn; hỗ trợ endpoint theo vùng	Phụ thuộc API được gọi	Không áp dụng

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

Ai chạy vòng lặp?

Đây là tiêu chí ảnh hưởng trực tiếp đến kiến trúc, vận hành và quyền kiểm soát của bạn.

Responses API: mã của bạn chạy vòng lặp

Responses API phù hợp khi bạn muốn kiểm soát từng lượt. 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ể thực hiện nhiều thao tác trong một yêu cầu. Tuy nhiên, với hàm do bạn tự triển khai, luồng xử lý quay về ứng dụng của bạn:

1. Mô hình trả về mục function_call.
2. Ứng dụng chạy hàm tương ứng.
3. Ứng dụng gửi function_call_output kèm đúng call_id.
4. Bạn quyết định tiếp tục hay dừng vòng lặp.

Bạn cũng tự quản lý lịch sử hội thoại qua previous_response_id hoặc Conversations API. Responses được lưu theo mặc định; đặt store: false để tắt lưu trữ. Với ngữ cảnh dài, bạn có thể dùng context_management và compact_threshold.

Xem thêm hướng dẫn Responses API và hướng dẫn gọi hàm.

Agents SDK: ứng dụng của bạn chạy vòng lặp qua SDK

Theo tài liệu OpenAI, trình chạy SDK xử lý “vòng lặp tác nhân và chuyển giao”. Tuy nhiên, ứng dụng của bạn vẫn sở hữu:

• Triển khai và triển khai hạ tầng.
• Công cụ tùy chỉnh.
• Lưu trữ trạng thái.
• Quy tắc phê duyệt.
• Xác thực, nhật ký kiểm tra và quy trình xem xét của con người.

Với Sandbox Agents, bộ điều khiển có thể chạy trong hạ tầng của bạn, còn lệnh được thực thi trong workspace Unix cục bộ, Docker hoặc sandbox của nhà cung cấp lưu trữ.

Agents API: OpenAI chạy vòng lặp

Agents API phù hợp khi bạn muốn OpenAI quản lý phiên, điều phối, nén ngữ cảnh và khôi phục tác vụ. API này bổ sung tác nhân phụ, tìm kiếm công cụ và gọi công cụ có lập trình. OpenAI cũng gọi trực tiếp các máy chủ MCP từ xa.

Bạn vẫn phải xử lý hàm riêng của mình. Khi phiên báo cáo function_call trong required_actions, hãy trả về sự kiện agent.session.input.tool_result với đúng turn_id và call_id.

Cùng một tác vụ, nhưng quyền sở hữu vòng lặp khác nhau:

# Responses API: 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: OpenAI sở hữu vòng lặp và phiên
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."
  }'

Ví dụ Agents API trong tài liệu dùng gpt-6-astra. Tài liệu không xác nhận mọi mô hình khác đều được chấp nhận, vì vậy hãy kiểm tra trước khi thay bằng gpt-6.1-sol.

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

1. Chọn nơi chạy tính toán

Với Agents API, đặt environment.type thành một trong các giá trị sau:

• openai_hosted: OpenAI cấp và quản lý sandbox.
• self_hosted: dùng sandbox của bạn.
• none: không dùng sandbox.

Với Agents SDK, bạn tự chọn và thanh toán nhà cung cấp sandbox. Với Responses API, mã chạy trong môi trường bạn triển khai, trừ các công cụ được OpenAI lưu trữ.

2. Chọn nơi lưu trạng thái

• Agents API: phiên lưu cấu hình, lượt và mục tại OpenAI. Một lần theo dõi tiếp theo là một sự kiện mới trên cùng ID phiên.
• Responses API: dùng previous_response_id hoặc Conversations API.
• Agents SDK: lưu trong bộ nhớ ứng dụng, phiên SDK hoặc trạng thái Responses.

3. Ước tính chi phí

Giá token giống nhau vì các lựa chọn gọi cùng mô hình. Khác biệt nằm ở hạ tầng:

• Agents API: không có phí nền tảng bổ sung, nhưng vùng chứa được lưu trữ có giá từ 0,03 USD cho 1 GB đến 0,48 USD cho 16 GB, cho mỗi phiên 20 phút.
• Agents SDK: bạn trả thêm chi phí hạ tầng/sandbox của mình.
• Responses API: bạn tự chịu chi phí môi trường chạy mã.

Theo giải thích về AgentKit, AgentKit không có gói đăng ký riêng.

4. Kiểm tra yêu cầu dữ liệu trước khi chọn

Agents API chỉ hỗ trợ lưu trữ dữ liệu tại Hoa Kỳ và không hỗ trợ Zero Data Retention (ZDR), kể cả khi dùng 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à trạng thái được giữ cho đến khi xóa. Trong khi đó, /v1/responses có thể đủ điều kiện ZDR với giới hạn và có endpoint theo vùng như eu.api.openai.com.

Nếu ZDR hoặc cư trú dữ liệu tại EU là yêu cầu bắt buộc, Agents API không phù hợp ở thời điểm hiện tại.

AgentKit vào cuối năm 2026: phần nào còn dùng được?

AgentKit ra mắt ngày 6 tháng 10 năm 2025 với bốn thành phần. Khi lập kế hoạch mới, phân biệt rõ từng phần:

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

Như hướng dẫn AgentKit đã nêu, hướng đi ưu tiên mã và bền vững là Agents SDK.

Nên xây dựng trên lựa chọn nào?

Chọn	Khi nào nên dùng
Agents API	Tác vụ chạy trong vài phút, cần tệp, lệnh hoặc trình duyệt, và bạn không muốn vận hành vòng lặp, sandbox hoặc lưu trữ phiên. Bạn chấp nhận lưu trữ tại Hoa Kỳ và header beta.
Responses API	Bạn cần kiểm soát mọi lượt, thực hiện lệnh gọi đơn lẻ, cần ZDR hoặc cư trú dữ liệu ngoài Hoa Kỳ, hoặc đã có vòng lặp ổn định.
Agents SDK	Ứng dụng cần sở hữu công cụ, lưu trữ, phê duyệt và chuyển giao; vòng lặp phải chạy trong hạ tầng của bạn.
ChatKit	Bạn cần UI trò chuyện nhúng trong sản phẩm.
Agent Builder	Không nên bắt đầu dự án mới tại đây. Hãy xuất workflow hiện có trước ngày 30 tháng 11 năm 2026.

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

Chuyển từ vòng lặp Responses sang Agents API

Nếu bạn đã có vòng lặp Responses và muốn OpenAI quản lý nó, hãy di chuyển theo thứ tự sau.

1. Ánh xạ thành phần hiện có

Thành phần Responses hiện tại	Thành phần Agents API
Hướng dẫn, mô hình, công cụ	agent
Vùng chứa hoặc môi trường chạy	environment
Kho lịch sử hội thoại	ID phiên
Vòng lặp gọi hàm	Event handler cho action bắt buộc

2. Chuyển MCP từ xa vào agent.tools

Khai báo máy chủ MCP từ xa trong agent.tools. Đặt token trong kho lưu trữ được gắn qua vault_ids; không đặt token trong prompt.

3. Viết lại xử lý hàm

Thay vòng lặp function_call_output hiện tại bằng handler cho:

• agent.session.requires_action khi dùng streaming.
• agent.session.action_required khi dùng webhook.

Handler cần trả về agent.session.input.tool_result.

Lưu ý: tác nhân phụ không thể gọi công cụ hàm. Giữ các công cụ hàm trên tác nhân chính.

4. Xóa logic nén ngữ cảnh thủ công

Agents API tự động nén ngữ cảnh thông qua bộ điều khiển được quản lý. Hãy loại bỏ logic nén riêng chỉ khi hành vi thực tế đã được kiểm thử với workload của bạn.

5. Theo dõi sự kiện kết thúc lượt

Đừng coi một phiên không hoạt động là thành công. Theo dõi các sự kiện:

agent.session.turn.completed
agent.session.turn.failed
agent.session.turn.cancelled

Bạn có thể xử lý chúng qua streaming hoặc webhook.

6. Xác nhận ràng buộc triển khai

Trước khi chuyển production traffic, xác nhận:

• Dữ liệu chỉ được lưu trữ tại Hoa Kỳ.
• Không có yêu cầu ZDR.
• Hệ thống có thể gửi header OpenAI-Beta: agents=v1.
• Quy trình xử lý lỗi và webhook đã được kiểm thử.

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

Đừng thay thế ngay vòng lặp Responses đang hoạt động. Chạy song song Responses API và Agents API trong cùng một dự án Apidog:

1. Tạo thư mục Responses.
2. Tạo thư mục Agents API.
3. Dùng chung environment chứa {{OPENAI_API_KEY}} và biến model.
4. Gửi cùng một prompt qua cả hai API.
5. Kiểm tra mã trạng thái và các trường đầu ra bắt buộc.
6. Mở luồng Agents API dưới dạng yêu cầu SSE để xem sự kiện từng lượt.
7. Lưu các lần chạy thành test scenario.
8. Chạy test trong CI bằng Apidog CLI để phát hiện thay đổi beta 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 mô tả các điểm 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ợ. OpenAI hiện liệt kê Agents API, Agents SDK và Responses API là các lựa chọn cho các nhu cầu khác nhau.

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 ngày 30 tháng 11 năm 2026. ChatKit vẫn có sẵn.

Agents SDK có dùng Agents API không?

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

Assistants API đã xảy ra điều gì?

Trang ngừng hỗ trợ của OpenAI đặt thời điểm loại bỏ là ngày 26 tháng 8 năm 2026 và hướng nhà phát triển sang Responses API cùng Conversations API.

Lựa chọn nào rẻ nhất?

Giá token giống nhau giữa các lựa chọn. Khác biệt chi phí đến từ vùng chứa được lưu trữ của Agents API so với chi phí tự lưu trữ khi dùng Agents SDK hoặc Responses API.

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

Bắt đầu bằng câu hỏi: ai nên sở hữu vòng lặp tác nhân?

• Cần kiểm soát tối đa hoặc ZDR: bắt đầu với Responses API.
• Cần runtime có kiểu trong hạ tầng riêng: chọn Agents SDK.
• Muốn OpenAI quản lý phiên, điều phối và sandbox: thử Agents API.
• Chỉ cần UI chat nhúng: dùng ChatKit.

Trước khi viết ứng dụng hoàn chỉnh, hãy gửi cùng một tập yêu cầu qua hai phương án và so sánh đầu ra trong Apidog.