ak config
ak config status
Kiểm tra bản ghi vòng đời dashboard mà không nhầm state đã ghi với phép kiểm tra health trực tiếp.
Dùng ak config status để đọc bản ghi vòng đời do ak config start tạo. Lệnh
báo PID, địa chỉ, URL, thời gian bắt đầu đã lưu và uptime được tính khi có tệp
state hợp lệ.
Cách dùng
ak config statusLệnh không nhận argument theo vị trí và không có cờ riêng. Các cờ dùng chung như
--json, --no-interactive, --quiet, --verbose và --yes được mô tả trong
quy ước CLI.
Đọc kết quả
ak config statusLệnh đọc $AGENTKIT_HOME/dashboard/state.json, thông thường là
~/.agentkit/dashboard/state.json.
- Nếu tệp không tồn tại, lệnh báo dashboard không chạy và thoát
0. - Nếu tệp state version
1đọc và parse được, lệnh báorunningcùng PID, port, địa chỉ bind và thời gian bắt đầu đã lưu. Uptime được tính từ thời gian đó. - Tệp state không đọc được, sai định dạng hoặc có version không được hỗ trợ là lỗi lệnh, không phải kết quả đã dừng.
status không kiểm tra process của hệ điều hành và không gọi health endpoint
của dashboard. Crash hoặc forced kill có thể để lại tệp state có vẻ hợp lệ,
vì vậy running: true nghĩa là “được theo dõi là đang chạy,” không phải “đã
xác minh identity PID và HTTP health.”
Lệnh không xoá state cũ. Trước khi tự gửi tín hiệu, hãy xác minh PID được ghi
vẫn thuộc đúng process ak config start; hệ điều hành có thể tái sử dụng PID.
Đầu ra cho tự động hoá
ak config status --jsonKhi thành công, stdout nhận một envelope có version:
schema_version: 1
kind: config.status
data.running: booleanKhi data.running là true, data còn có:
pid: integer
port: integer
bind_addr: string
url: string
started_at: RFC 3339 timestamp
uptime: duration stringChỉ rẽ nhánh theo .data.running. Khi trường này là false, hãy bỏ qua mọi
field khác, dù encoder bỏ field hay biểu diễn zero value. Đây là một JSON
document, không phải NDJSON.
Lỗi runtime trong chế độ JSON ghi error envelope có cấu trúc vào stderr. Lỗi parse cờ xảy ra trước renderer của lệnh và có thể vẫn là hướng dẫn dùng dạng plain text.
Tác động và tương tác
Lệnh chỉ đọc. Lệnh không kết nối tới địa chỉ đã ghi, kiểm tra hoặc gửi tín hiệu
cho PID, ghi lại hay xoá state, mở trình duyệt, liên hệ provider hoặc dùng xác
thực AgentKit. Lệnh không bao giờ hiện prompt hay đọc stdin, vì vậy --yes và
--no-interactive không thay đổi kết quả. --quiet ẩn stdout dạng người đọc;
JSON vẫn có ưu tiên cao hơn quiet.
Lệnh không có chế độ preview, apply, dry-run hay force.
Kết quả và mã thoát
| Mã thoát | Ý nghĩa | Bước tiếp theo an toàn |
|---|---|---|
0 | Đọc status thành công, kể cả kết quả đã dừng bình thường. | Rẽ nhánh theo .data.running, không theo mã process. |
1 | Không resolve được AgentKit home, tệp state không đọc được/sai định dạng/không được hỗ trợ hoặc ghi đầu ra thất bại. | Kiểm tra riêng tệp state và process; đừng giả định đã dừng. |
2 | Argument hoặc cờ không hợp lệ. | Sửa cách gọi lệnh. |
Xác minh server được theo dõi
Với server do automation khởi động, hãy giữ process handle và đối chiếu PID, URL được báo với handle đó. Với phiên dùng thủ công, kiểm tra process bằng công cụ hệ điều hành hoặc mở URL loopback đã ghi trước khi xem server là healthy.
Chỉ dùng ak config stop sau khi chấp nhận semantics gửi tín hiệu và ranh giới
PID cũ của lệnh đó.