Trang này được dịch từ tài liệu tiếng Anh. Lệnh, định danh và ví dụ giữ nguyên. Runtime 7.24.4 · SDK 2.6.7. Bản tiếng Anh

Chế độ thực thi (Cục bộ, Đám mây, Lai, Council, Arena)

Trạng thái: Đang hoạt động
Phạm vi: trạng thái hiện tại
Xem xét lần cuối: 2026-09-12
Chủ sở hữu: ax-code runtime

AX Code có thể đặt việc lên suy luận cục bộ, nhà cung cấp được lưu trữ hoặc CLI, hoặc cả hai (lai), và có thể phân tán việc có rủi ro cao sang nhiều nhà cung cấp đã kết nối (rà soát council và arena chọn tốt nhất trong N). Trang này ghi lại hành vi đã phát hành của các chế độ đó.

Nguồn sự thật

Khi hành vi thay đổi, hãy đối chiếu với:

• packages/ax-code/src/mode/ — chính sách thuần, lai, tổng hợp council, xếp hạng arena, tranh luận, ngân sách, bộ nhớ, chính sách worktree, chấm điểm implement-arena
• packages/ax-code/src/tool/council.ts — công cụ council đa nhà cung cấp
• packages/ax-code/src/tool/arena.ts và arena-implement.ts — arena lập kế hoạch và triển khai
• packages/ax-code/src/session/prompt/prompt-routing.ts — vị trí lai khi modes.default là hybrid
• packages/ax-code/src/config/schema-impl.ts — lược đồ cấu hình modes
• packages/ax-code/src/command/template/{council,arena}.txt — /council và /arena nằm trong menu gạch chéo mặc định

Bộ chọn chế độ làm việc (Agent | Council | Arena)

TUI và Desktop có một điều khiển chế độ làm việc cho định tuyến đa mô hình. Mặc định là Agent.

• Chrome mặc định của TUI: chân trang không hiện chip Agent. Chế độ chạy và Sandbox vẫn ở lại. /work-mode (bảng lệnh Chọn chế độ làm việc) mở bộ chọn tường minh: Agent, Council và Arena, mỗi hàng có chi phí và ngữ nghĩa. Các hàng ensemble không khả dụng bị tắt kèm lý do.
• Chrome ensemble đã kích hoạt: sau khi bạn chọn Council hoặc Arena, một chip xuất hiện (Council · 2, hoặc Arena (off) rỗng nếu sau đó không còn khả dụng). Nhấp chip để trở về Agent. Cuộc trò chuyện mới đặt lại về Agent.
• Khả dụng: một chế độ khả dụng khi được bật trong cấu hình, có ít nhất hai nhà cung cấp đã kết nối với mô hình có thể chọn, và giới hạn thành viên đã cấu hình không phải 1. Chip và hàng bộ chọn cập nhật trực tiếp khi nhà cung cấp kết nối hoặc ngắt.
• Gợi ý trước khi gửi (TUI): một dòng gợi ý phía trên lời nhắc xuất hiện khi council/arena bị chặn hoặc vẫn đang kiểm tra, và ở lần dùng đầu của một chế độ khả dụng (ví dụ Council mode · up to 2 reviewers · advisory · approval on first use). Sau một lần gửi thành công ở chế độ đó, chip vẫn là trạng thái và gợi ý được ẩn. Gửi khi chế độ đã chọn không khả dụng sẽ bị chặn kèm lý do — bản nháp được giữ và lời nhắc không bao giờ bị hạ âm thầm xuống một lần chạy mô hình đơn.
• Desktop: chip trên thanh công cụ soạn thảo (cạnh Thủ công/Tự chủ).
• /council và /arena tường minh không bao giờ bị viết lại và vẫn là điểm vào một lần.
• Các tác nhân chuyên biệt (kiến trúc, bảo mật, …) ở trên bộ chọn tác nhân riêng.

Các chế độ đặt vị trí trong một cái nhìn

Định tuyến chuyên gia theo từ khóa và phân tầng độ phức tạp (xem Định tuyến tự động) độc lập với vị trí lai và các chế độ ensemble.

Mức nỗ lực / mức suy nghĩ của mô hình (Nhanh, Cân bằng, Sâu, Tối đa) cũng độc lập — đó là ngân sách suy luận theo từng mô hình, không phải chế độ làm việc. Xem Mức nỗ lực mô hình.

Cấu hình

Trong ax-code.json:

{
  "modes": {
    "default": "hybrid",
    "hybrid": {
      "preferLocalWhenAvailable": true,
      "escalateOnHighComplexity": true,
      "localProviderID": "ax-engine"
    },
    "council": {
      "enabled": true,
      "maxMembers": 3,
      "timeoutMs": 180000,
      "debateRounds": 0
    },
    "arena": {
      "enabled": true,
      "maxContestants": 3,
      "strategy": "verify_first"
    },
    "budget": {
      "maxEstimatedUsd": 0.5,
      "estimatedUsdPerMember": 0.05
    }
  }
}

Vị trí lai

Khi modes.default là hybrid và người dùng hoặc tác nhân không ghim một mô hình:

1. Nếu nhà cung cấp cục bộ (mặc định ax-engine) có mô hình có thể chọn → ưu tiên cục bộ cho độ phức tạp thấp/trung bình.
2. Nếu độ phức tạp cao và escalateOnHighComplexity đúng → đám mây.
3. Nếu quyền riêng tư yêu cầu cục bộ và cục bộ khả dụng → cục bộ.
4. Nếu cục bộ không khả dụng → đám mây.

Độ phức tạp vẫn dùng đường mô hình nhỏ/nhanh hiện có cho tin nhắn low khi định tuyến độ phức tạp tự động được bật (Định tuyến tự động). Lai không thay thế định tuyến chuyên gia theo từ khóa.

Hướng dẫn mô hình cục bộ và bộ nhớ: Chọn mô hình AX Engine. Danh sách nhà cung cấp: Nhà cung cấp được hỗ trợ.

Council (chế độ đồng thuận)

Công cụ: council
Gạch chéo: /council <question>

1. Chọn các nhà cung cấp đã kết nối đa dạng (đa dạng họ — dưới một cổng đa mô hình không nhận ra, họ lùi về mã mô hình; thiên lệch mềm từ bộ nhớ kết quả).
2. Phân tán song song một lời nhắc rà soát hoặc thiết kế có cấu trúc.
3. Gom vấn đề vào các tầng đồng thuận (nhất trí trong các thành viên thành công ở mức túc số — ít nhất max(2, ⌈2/3 × attempted⌉) lần thành công), đa số chặt (hơn một nửa thành viên đã thử), thiểu số (ít nhất hai) và đơn lẻ. Phát hiện công bố mức ủng hộ so với thành viên đã thử (2/6), và báo cáo độ phủ thấp nêu rõ nhãn đồng thuận cần túc số.
4. Vòng tranh luận tùy chọn: bản tổng hợp ẩn danh (Chatham House) được chia sẻ giữa các vòng; không quy kết thương hiệu. Tranh luận bị giới hạn ba vòng và dừng sớm khi hội tụ.
5. Trả về một báo cáo markdown tư vấn. Không sửa tệp.

Cần ít nhất hai thành viên đã phân giải mới chạy được — ít hơn thì ngắn mạch với kiểm tra trước “không đủ thành viên” trước mọi lời nhắc phê duyệt hoặc lần gọi mô hình (các cặp mô hình cùng cổng được nêu tường minh được tính là hai). Các tầng đồng thuận có ý nghĩa vẫn cần ít nhất hai thành viên thành công; nếu không, báo cáo được đánh dấu chưa đầy đủ.

Tiếp nhận bằng chứng. Thành viên chỉ nhận câu hỏi và ngữ cảnh được cung cấp. Họ không kế thừa phiên đang gọi và không đọc tệp từ đường dẫn trong bản tóm tắt. Hãy đưa yêu cầu, diff liên quan, các đoạn gốc bắt buộc và bằng chứng xác minh cần cho phạm vi rà soát đã nêu.

context tùy chọn được chấp nhận nguyên văn tới 24.000 đơn vị mã UTF-16. Ngữ cảnh lớn hơn trả về context_rejected trước khi suy luận thành viên; AX Code không bao giờ rút ngắn âm thầm. Hãy tách rà soát thành các yêu cầu có phạm vi tường minh hoặc bỏ phần nền tùy chọn trong khi giữ bằng chứng bắt buộc.

Trước mỗi vòng, AX Code kiểm tra toàn bộ lời nhắc với trần cục bộ 128.000 byte và mọi giới hạn đầu vào/ngữ cảnh đã biết của từng thành viên đã phân giải, dành chỗ cho đầu ra đã yêu cầu cùng chỉ dẫn dự phòng cộng 2.048 token cho lược đồ và khung. Kích thước đầu vào dùng ước lượng byte UTF-8 cố ý thận trọng. Nó có thể từ chối lời nhắc vốn vẫn vừa; đây không phải số đếm tokenizer chính xác, cũng không phải bảo đảm về cách nhà cung cấp tuần tự hóa. Giới hạn mô hình chưa biết được công bố và vẫn chịu các trần cục bộ. Nếu một vòng tranh luận không vừa, kết quả là chưa đầy đủ và giữ báo cáo của vòng hoàn thành gần nhất.

contextAdmission ghi cổng độ dài ngữ cảnh cục bộ, kích thước đã cung cấp và một digest nội dung; promptBudget kiểm tra yêu cầu đầy đủ một cách riêng. Cả hai phải đạt trước khi suy luận. Các trường này độc lập với successfulMembers và không thiết lập tính đầy đủ ngữ nghĩa, độ mới của nguồn, hay chất lượng rà soát được bảo đảm.

Thời gian chờ. Mỗi thành viên chạy dưới modes.council.timeoutMs (mặc định 180000 ms); mô hình khai báo khả năng suy luận nhận ngân sách gấp modes.council.reasoningTimeoutScale lần (mặc định 3, tức 540000 ms). Để cho một thành viên đã biết là chậm thêm thời gian mà không kéo dài thời gian chờ của mọi người khác, hãy đặt ghi đè tuyệt đối modes.council.memberTimeoutMs khóa bằng "providerID" hoặc "providerID/modelID" — khóa mô hình chính xác thắng khóa toàn nhà cung cấp, và khóa nào cũng thắng phép tính nền/hệ số:

{
  "modes": {
    "council": {
      "memberTimeoutMs": { "deepseek/deepseek-v4-pro": 900000 }
    }
  }
}

ax-code.json là tệp cấu hình được bảo vệ — tác nhân phải hỏi người dùng trước khi đổi.

Làn tùy chọn (mặc định tắt). modes.council.chairman: true nối thêm một lần gọi tổng hợp chủ tọa bị che sau khi gom (và sau mọi vòng tranh luận): chủ tọa chỉ nhận phát hiện đã ẩn danh (tầng và số ủng hộ, không bao giờ danh tính thành viên) rồi trả về phán quyết, hành động được khuyến nghị và ghi chú bất đồng. Phân tầng tất định vẫn là đầu ra chính; lỗi chủ tọa được công bố và không gây chết. modes.council.adaptive: true bắt đầu phân tán với hai thành viên và mở rộng từng người một tới maxMembers khi độ phủ vòng 1 dưới túc số hoặc bất đồng là đáng kể; điều kiện mở rộng là hằng số có thể chỉnh của harness.

Khi nào nên dùng

• Đánh đổi kiến trúc / bảo mật / thiết kế
• Rà soát mã rủi ro cao, nơi sự đồng thuận đa mô hình làm tăng độ tin cậy
• Người dùng yêu cầu rà soát đa mô hình hoặc “ý kiến thứ hai”

Quy trình tác nhân (quan trọng)

Gọi council sớm ngay khi bằng chứng liên quan đã có với bản tóm tắt context có phạm vi tường minh. Tránh các lần đào sâu đa khám phá không liên quan tới rà soát đó; thu thập bằng chứng gốc bắt buộc trước khi hỏi thành viên về phát hiện mã. Nếu người dùng đã yêu cầu council/arena, task_parallel bị từ chối cho đến khi công cụ ensemble là hành động chính đã định.

Khi nào không nên

• Câu hỏi tầm thường (độ trễ/chi phí)
• Mã nhạy cảm về quyền riêng tư, không được rời khỏi suy luận cục bộ
• Chỉ có một nhà cung cấp được kết nối

Arena (chọn tốt nhất trong N)

Công cụ: arena
Gạch chéo: /arena <task>
Yêu cầu: modes.arena.enabled: true và ≥2 mô hình có thể chọn, khác nhau, trên các nhà cung cấp đã kết nối (kể cả một cổng dùng chung)

Tiếp nhận bằng chứng (dùng chung với council). context tùy chọn được chấp nhận nguyên văn tới 24.000 đơn vị mã UTF-16. Ngữ cảnh lớn hơn trả về context_rejected trước mọi lời nhắc phê duyệt, việc tạo worktree hoặc lần gọi mô hình — AX Code không bao giờ rút ngắn âm thầm. Hãy tách nhiệm vụ thành các yêu cầu có phạm vi tường minh hoặc giảm phần nền tùy chọn trong khi giữ bằng chứng bắt buộc. Chính lời nhắc phê duyệt chỉ bắn sau khi mọi kiểm tra trước không có tác dụng đã đạt (tắt, tiếp nhận ngữ cảnh, kiểm tra trước git khi triển khai, ngân sách, phân giải thành viên).

mode: "plan" (mặc định)

• Mỗi thí sinh đề xuất một hướng tiếp cận, các bước, rủi ro và một điểm rủi ro tự đánh giá đã hiệu chỉnh (không ghi không gian làm việc).
• Khi có ≥2 đề xuất thành công, một lần gọi giám khảo thang điểm bị che (thành viên phân giải đầu tiên; danh tính bị gỡ, thứ tự ngẫu nhiên) chấm mỗi đề xuất theo độ phủ yêu cầu, tính khả thi, kế hoạch xác minh và bằng chứng rủi ro (mỗi mục 0–10, cho phép hòa). Tổng thang điểm (0–40) là tín hiệu xếp hạng chính; rủi ro tự đánh giá chỉ để hiển thị. Lỗi giám khảo hoặc modes.arena.judge: false lùi về chấm điểm tự đánh giá kèm ghi chú công bố.
• Xếp hạng với tầng xác minh trước, rồi điểm giám khảo/rủi ro, rồi độ đa dạng vân tay bản vá (không bao giờ chỉ dựa độ phổ biến thuần). Xếp hạng kế hoạch mang tính tư vấn và không phải xác minh thực thi.
• Chỉ tư vấn.

mode: "implement"

• Cần một worktree Git chính có ít nhất một commit và không có thay đổi chưa commit, ghi đúng commit gốc, rồi tạo một git worktree cho mỗi thí sinh từ commit đó.
• Chạy một tác nhân triển khai trong mỗi worktree.
• Chụp mọi thay đổi đã theo dõi và chưa theo dõi của từng thí sinh vào một commit nhánh bền, kể cả commit do chính tác nhân tạo.
• Chỉ chạy các lệnh xác minh dự án đã phát hiện (kiểm tra kiểu / kiểm thử / lint) sau khi đã bắt được một bản vá không rỗng.
• Xếp hạng xác minh trước theo mặc định: chỉ bản vá hoàn thành, không rỗng và vượt xác minh mới có thể thắng; trong số bản đạt, ưu tiên rủi ro thấp hơn và bản vá đa dạng.
• Không tự hợp nhất. Báo cáo gồm đường dẫn worktree, nhánh và phạm vi commit để bạn kiểm tra, hợp nhất hoặc cherry-pick.

Arena triển khai cần một dự án git.

Quy tắc xếp hạng (khớp nghiên cứu)

Với ứng viên mã: xác minh trước, đa dạng thứ hai, độ phổ biến không bao giờ đứng một mình.
Bỏ phiếu đa số ngây thơ trên các bản vá sai tương tự nhau là một phản mẫu (bẫy độ phổ biến).

Lệnh gạch chéo

An toàn và chi phí

• Sandbox / tự chủ vẫn áp dụng cho việc của tác nhân đơn (Sandbox, Tự chủ).
• Council và arena kế hoạch không ghi tệp.
• Tác nhân ghi của arena triển khai bị cô lập trong worktree; worktree chính bẩn bị từ chối để đầu vào chưa commit không bị bỏ sót âm thầm.
• Phân tán ensemble nhân lên egress và chi phí nhà cung cấp; hãy dùng modes.budget và giữ maxMembers / maxContestants nhỏ. Ước tính ngân sách tính giá trường hợp xấu nhất: council 2 × (debateRounds + 1) lần gọi mỗi thành viên (dự phòng lược đồ + thử lại), arena kế hoạch 2 lần mỗi thí sinh cộng một lần gọi giám khảo phẳng, arena triển khai một ước tính 12 lần gọi đã ghi cho mỗi quỹ đạo.
• Một sổ gọi ensemble chỉ cục bộ (ensemble-calls.jsonl trong thư mục trạng thái toàn cục, trần 2 MB) ghi kết quả từng thế hệ với hàm băm lời nhắc SHA-256 — không bao giờ thân lời nhắc, không bao giờ thông tin xác thực, không egress. Tắt bằng modes.ensembleLedger: false.
• Sự đồng thuận đa mô hình là bằng chứng, không phải chứng cứ — hãy chạy kiểm thử trước khi phát hành.

Liên quan

• Định tuyến tự động — từ khóa chuyên gia + tầng độ phức tạp
• Nhà cung cấp được hỗ trợ — đám mây, CLI, AX Engine
• Chọn mô hình AX Engine — lựa chọn mô hình cục bộ