Tổng quan

Agents API hiện có ở phiên bản beta. API này cho phép nhà phát triển xây dựng ứng dụng với tác nhân Codex do OpenAI quản lý, có thể thực hiện công việc qua nhiều bước và tiếp tục trong cùng một phiên.

Ứng dụng của bạn cung cấp tác vụ, công cụ và cấu hình. OpenAI quản lý phiên của tác nhân và điều phối hoạt động giữa mô hình với các công cụ của tác nhân.

Tác nhân có thể làm gì?

Tùy vào công cụ và môi trường thực thi, tác nhân có thể chạy mã, chỉnh sửa tệp, sử dụng kết nối MCP và tạo tệp cho ứng dụng của bạn. Bạn có thể gửi thêm chỉ dẫn hoặc tiếp tục với một tác vụ khác trong cùng phiên.

Xem tổng quan về Agents API để biết các khả năng được hỗ trợ và ví dụ.

Tôi bắt đầu như thế nào?

1. Tạo khóa API cho ứng dụng trong dự án của bạn trên OpenAI Platform. Cấp quyền api.agents.read và api.agents.write cho các phiên, cùng với api.responses.write cho các yêu cầu gửi đến mô hình.

2. Làm theo hướng dẫn bắt đầu nhanh để cấu hình tác nhân, tạo phiên và gửi tác vụ.

3. Theo dõi các sự kiện trong phiên để xem tiến độ và kết quả. Lưu ID phiên nếu bạn muốn tiếp tục công việc.

Lưu khóa API của bạn bên ngoài sandbox của tác nhân. Các yêu cầu phải có tiêu đề OpenAI-Beta: agents=v1. Các SDK của OpenAI tự động thêm tiêu đề này.

Tác nhân của tôi có cần sandbox không?

Chọn môi trường phù hợp với tác vụ:

• Không có môi trường: Tác nhân trả lời câu hỏi hoặc sử dụng công cụ bên ngoài mà không cần các lệnh shell tích hợp sẵn hay tệp trong không gian làm việc.

• Sandbox do OpenAI lưu trữ: Tác nhân cần chạy tập lệnh hoặc làm việc với tệp và bạn muốn OpenAI quản lý sandbox của tác nhân.

• Sandbox tự lưu trữ: Bạn cần dùng cơ sở hạ tầng, phần mềm hoặc mạng riêng của mình. Ứng dụng của bạn quản lý vòng đời của môi trường.

Xem kiến trúc Agents API để biết chi tiết về cấu hình.

Tôi có thể xem lại phiên ở đâu?

Mở Nhật ký trong bảng điều khiển Platform, chọn Tác nhân rồi tìm ID phiên. Bạn có thể kiểm tra các lượt, lệnh gọi công cụ và hoạt động của tác nhân phụ.

Hướng dẫn về khả năng quan sát cũng giải thích cách xem lại mức sử dụng token đã ghi nhận.

Nếu luồng sự kiện bị ngắt kết nối thì sao?

Truy xuất phiên hiện có và các mục đã lưu trong phiên trước khi thử lại. Việc này giúp bạn kiểm tra những gì đã diễn ra trước khi gửi thêm công việc.

Một lượt đã hoàn tất không có nghĩa là mọi công cụ đều thực thi thành công. Hãy xem lại kết quả được báo cáo. Chỉ riêng việc phiên ở trạng thái chờ chưa đủ để xác nhận tác vụ đã hoàn tất thành công.

Phí sử dụng được tính như thế nào?

Các yêu cầu gửi đến mô hình được tính theo đơn giá API của mô hình đã chọn. Các công cụ của OpenAI và sandbox do OpenAI lưu trữ được tính theo đơn giá công cụ và container tương ứng.

Xem bảng giá API để biết đơn giá hiện tại.

Dữ liệu phiên và tệp được xử lý như thế nào?

Agents API lưu giữ trạng thái phiên để công việc có thể tiếp tục qua nhiều lượt. Bạn có thể xóa các phiên và sản phẩm đầu ra đã xuất bản khi không còn cần đến. Hãy lưu mọi tệp bạn cần trước khi xóa phiên.

Agents API hiện chỉ hỗ trợ nơi lưu trú dữ liệu tại Hoa Kỳ. API này không hỗ trợ chế độ không lưu giữ dữ liệu, kể cả khi bạn sử dụng sandbox tự lưu trữ. Xem tài liệu về Agents API để biết chi tiết về các tùy chọn kiểm soát dữ liệu.