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

Cấu hình và chẩn đoán hiệu năng

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-13

Chủ sở hữu: ax-code runtime

Chọn một hồ sơ công cụ

Với các phiên lập trình không cần vận hành hạ tầng, lên lịch, sinh ảnh hoặc phân tích chuyên biệt, hãy đặt toolProfile thành coding cho nhà cung cấp đã kết nối trong cấu hình AX Code:

{
  "provider": {
    "your-provider-id": {
      "options": {
        "toolProfile": "coding"
      }
    }
  }
}

Thay your-provider-id bằng mã nhà cung cấp đã kết nối. Cách này giữ kiểm tra và sửa tệp, việc shell và nền, ủy thác, sổ tay, mục tiêu, kỹ năng, bộ nhớ và xác minh rà soát. Công cụ web và công cụ tùy chọn vẫn theo quy tắc bật và quyền hiện có. Công cụ tùy chỉnh và MCP giữ quy tắc tiếp nhận hiện có và có thể làm tăng kích thước yêu cầu.

Dùng full khi bạn cần council/arena, vận hành, lên lịch, sinh ảnh hoặc công cụ phân tích chuyên biệt. Nhà cung cấp đám mây mặc định là full; AX Engine giữ mặc định nhỏ hơn core. coding không đổi mức nỗ lực suy luận, quyền, việc chụp ảnh hay yêu cầu xác minh. Tác động của nó lên tốc độ và thành công nhiệm vụ phụ thuộc vào mô hình và tải. Xem Mức nỗ lực mô hình để biết các điều khiển suy luận tường minh.

Tách phần chuẩn bị cục bộ khỏi thời gian phản hồi của nhà cung cấp

Bật lập hồ sơ cục bộ cho một lần chạy:

AX_CODE_PROFILE_NATIVE=1 ax-code run --model your-provider-id/your-model "Your task"
ax-code session replay YOUR_SESSION_ID --mode export

Hồ sơ thoát trên stderr gồm các khoảng session.insertReminders, session.preparePromptRequest, session.preflight, session.resolveTools và ảnh chụp track/patch. Đây là số đo gộp; các khoảng lồng nhau hoặc chồng nhau không được cộng lại như thời gian tường của nhiệm vụ. Chính việc lập hồ sơ cũng thêm chi phí đo.

Các sự kiện llm.response đã ghi nhận thêm một đối tượng tùy chọn timing:

Trường	Ý nghĩa
`boundary`	`provider-adapter`: quan sát tại bộ chuyển mô hình, trước khi SDK xử lý kết quả công cụ
`attempt`	Số lần thử của bộ chuyển trong lần gọi `LLM.stream` này; các trường khác mô tả lần thử này
`setupMs`	Thời gian từ lúc vào `LLM.stream` tới lần điều phối bộ chuyển này; khi thử lại thì gồm các lần thử trước và thời gian lùi
`firstContentMs`	Từ lúc điều phối tới delta văn bản, suy luận hoặc đầu vào công cụ không rỗng đầu tiên, hoặc tới lần gọi công cụ hoàn chỉnh
`firstTextMs`	Từ lúc điều phối tới delta văn bản không rỗng đầu tiên; vắng mặt với phản hồi chỉ có công cụ hoặc chỉ suy luận
`streamMs`	Từ lúc điều phối tới khung kết thúc của bộ chuyển; vắng mặt khi không quan sát được khung kết thúc

Khung siêu dữ liệu và khung bắt đầu luồng không được tính là nội dung. Thời gian dùng đồng hồ đơn điệu và phản ánh lúc các khối được quan sát, kể cả áp lực ngược của luồng. Chúng không phải thời gian mạng thô, thời gian suy luận máy chủ hay thời gian kết xuất TUI. Bộ chuyển CLI có thể gồm việc của chính CLI con. latencyMs hiện có giữ cách đo bước hỗn hợp cũ hơn và có thể gồm thực thi công cụ cùng việc ảnh chụp. Các trường thời gian mới chỉ chứa thời lượng và danh tính lần thử.

Không có AX_CODE_PROFILE_NATIVE=1 thì đối tượng thời gian bổ sung bị bỏ. Lập hồ sơ dùng chẩn đoán cục bộ và nhật ký sự kiện phiên hiện có; nó không bật bộ xuất đo từ xa bên ngoài.

Để so sánh hữu ích, hãy giữ nguyên nhiệm vụ, bản sửa kho, điểm cuối nhà cung cấp, đúng mô hình, mức nỗ lực suy luận, quyền công cụ và điều kiện bộ nhớ đệm. Ghi thời gian phản hồi nhìn thấy đầu tiên và thời gian tới một kết quả đã xác minh, kể cả kiểm thử và các lần sửa. Một yêu cầu nhỏ hơn hoặc ảnh chụp cục bộ nhanh hơn tự nó không chứng minh nhiệm vụ đám mây hoàn thành nhanh hơn.

Dùng điều khiển harness và đánh giá đã xác minh để thử khôi phục ngữ cảnh, khám phá MCP, công thức chỉ đọc và so sánh fixture khớp với xác minh độc lập.

Hiểu kích thước yêu cầu

Các sự kiện llm.request mới trong ax-code session replay YOUR_SESSION_ID --mode export gồm requestBytes khi có nguồn gốc yêu cầu:

Trường	Ý nghĩa
`encoding`	`canonical-json-utf8`: độ dài byte của biểu diễn vân tay chuẩn hiện có
`system`	Mảng thông điệp hệ thống được lắp riêng
`messages`	Mảng thông điệp đã lắp đầy đủ, kể cả thông điệp hệ thống
`toolDefinitions`	Tên công cụ đang hoạt động, mô tả và lược đồ đầu vào đã phân giải

system đã nằm trong messages; đừng cộng chúng với nhau. Khung mảng được tính vào. Giá trị nhị phân dùng biểu diễn digest hiện có, nên các kích thước này không phải kích thước tải mạng cũng không phải số đo bộ nhớ thường trú. Chúng không phải số token: mức dùng token của nhà cung cấp và bộ đếm bộ nhớ đệm vẫn là nguồn cho việc hạch toán đầu vào mô hình. Một tóm tắt gói ngữ cảnh chỉ phủ một giai đoạn hẹp hơn và không phải toàn bộ đầu vào mô hình. Sự kiện kế thừa bỏ trường này; nguồn gốc thất bại vẫn được ghi là không có một cách tường minh.

Chẩn đoán này chỉ ghi kích thước cùng các hàm băm/siêu dữ liệu hiện có. Không lưu thêm thân lời nhắc hay thông tin xác thực. Nó tái dùng phép tuần tự hóa chuẩn cần cho từng hàm băm thay vì tách token của yêu cầu. Hãy so kích thước ở các lượt khớp khi quyết định chỉ dẫn hệ thống, định nghĩa công cụ hay lịch sử đang lớn có cần chú ý hay không. Hồ sơ lập trình ở trên có thể giảm định nghĩa công cụ mà không đổi mức nỗ lực suy luận; hồ sơ đầy đủ vẫn có cho các khả năng nó thêm vào.

Tránh khám phá thừa

Với việc tra một tệp đã biết hoặc đếm đơn giản, hãy dùng tìm kiếm tập trung hoặc một lệnh gộp. Phân giải đường dẫn theo thư mục không gian làm việc hiện tại; một phiên bắt đầu bên trong một gói đã có gói đó làm gốc tìm. Grep tích hợp dùng cú pháp regex mặc định của ripgrep, không có lookaround hay backreference.

Dùng một người điều tra cho một đường gọi. Các tác vụ chỉ đọc song song nên có sản phẩm bàn giao khác nhau và đường dẫn hoặc phân hệ được sở hữu, với bằng chứng hiện có được đưa trong bản tóm tắt. Rà soát độc lập có thể xem lại bằng chứng cho một câu hỏi xác minh riêng. Lặp khám phá trong nhiều ngữ cảnh mới tốn các vòng mô hình ngay cả khi bộ nhớ đệm bằng chứng trúng; lần trúng bộ nhớ đệm không bỏ qua xác thực nội dung hiện tại hay quyền.

Máy chủ ngôn ngữ giờ khởi động theo nhu cầu theo mặc định. Xem Mức dùng bộ nhớ về chọn tham gia làm nóng trước mang tính suy đoán và sự đánh đổi với độ trễ của truy vấn ngữ nghĩa đầu tiên. Hướng dẫn lời nhắc và kiểm thử cục bộ không thiết lập một mức giảm cụ thể về số lần gọi mô hình trực tiếp hay RAM vật lý.