Bỏ qua để đến nội dung

Protocol conversion

Trang này mô tả route Codex mà Codex Desktop và Codex CLI sử dụng. VS Code cũng được hỗ trợ tương tự, và chúng tôi đang tiếp tục bổ sung thêm nhiều agent khác; mọi route đều tuân theo cùng một mô hình chuyển đổi này.

Local proxy của Nexus Composer chuyển đổi request của Codex sang giao thức mà upstream provider đã chọn hỗ trợ. Quá trình chuyển đổi này trong suốt với Codex: Codex vẫn dùng native API của mình và không cần code request riêng cho từng provider.

Composer sẽ định tuyến mỗi request tới duy nhất một upstream provider, dựa trên route đang dùng và model đang chọn. Đổi provider chỉ thay đổi nơi nhận các request tiếp theo — Composer không bao giờ chia nhánh (fan out), nhân bản (mirror) hay gửi cùng một request tới cả OpenAI Official lẫn OneNexus để so sánh.

Các giao thức được hỗ trợ

Mục “Các giao thức được hỗ trợ”

Local proxy nhận request của Codex ngay trên máy và giao tiếp theo đúng định dạng của upstream đã chọn:

  • OpenAI Responses — Endpoint /v1/responses, bảo toàn nguyên vẹn các reasoning item và trạng thái encrypted reasoning để session có thể tiếp tục liền mạch.
  • OpenAI Chat Completions — Định dạng upstream dành cho các model do OneNexus vận hành; các request thuộc chuẩn Codex Responses sẽ được chuyển đổi sang chuẩn này, đồng thời các lệnh gọi công cụ (tool call) được ánh xạ hai chiều tương ứng.

Lưu ý về quá trình chuyển đổi

Mục “Lưu ý về quá trình chuyển đổi”
  • Codex — Các trường store và previous_response_id được theo dõi trong một session store dùng chung, nên cuộc hội thoại có thể tiếp tục trên backend nào cũng được, dù bắt đầu ở đâu; đổi provider không khiến session bị kẹt lại, cũng không bắt bạn gửi lại toàn bộ lịch sử hội thoại.

Ví dụ minh họa

Mục “Ví dụ minh họa”

Cấu trúc một request thuộc chuẩn Codex Responses sau khi được chuyển đổi sang định dạng Chat Completions để gửi tới upstream:

{
  "model": "glm-5.3",
  "max_tokens": 65536,
  "messages": [
    { "role": "system", "content": "You are a helpful assistant." },
    { "role": "user", "content": "Refactor the retry loop to use backoff." }
  ]
}