07 / Tra cứu
Tra cứu & gỡ lỗi
Bắt đầu bằng dấu hiệu lỗi và bằng chứng nhỏ nhất. Đừng mở quyền, xóa dữ liệu hay lặp thao tác chưa rõ chỉ để làm thông báo hết lỗi.
Gỡ lỗi từng bước
| Dấu hiệu | Kiểm tra | Việc tiếp theo | Đạt khi |
|---|---|---|---|
| Không có soot trên PATH | Danh mục tải, hệ điều hành, phiên bản, mã băm | Lấy đúng bản hoặc biên dịch khi có quyền truy cập | soot version --json trả phiên bản |
| Thiếu Pack/chương trình | Manifest đã cài, capability đã chọn, phần phụ thuộc | Chuẩn bị đúng phần thiếu, không bỏ qua schema | Cấu hình hợp lệ, đọc bằng công cụ được |
| Sẵn sàng nhưng Test không có AI thật | Nhà cung cấp, mô hình, đăng nhập | Đăng nhập/cấu hình trên host | Có bằng chứng gọi nhà cung cấp thật |
| Saved nhưng Test bị khóa | Saved/active, chờ kích hoạt, work_available | Activate đúng phiên bản, chờ xác nhận | Test gắn active revision |
| Nest không kết nối | Địa chỉ, TLS/origin/operator key | Origin chính xác, đúng loại khóa | Danh tính/quyền xác thực đúng |
| Đọc/ghi DENIED | Capability, khóa thao tác, pool grant | Người vận hành xem lại từng lớp quyền | Đọc được phép, ghi ngoài quyền bị từ chối |
| Lưu xung đột | Revision/generation hiện tại, nháp | Đọc lại, chủ động rebase | Lưu bản mới, không mất nháp |
| Gửi mất phản hồi | Request/run/receipt gốc và resource fences | GET/watch/đối chiếu; không phát lại effect chưa rõ qua nhóm khác | Kết quả rõ hoặc ghi chưa rõ |
| Không có nhóm tự động | Host groups.auto.v1, Soot automatic_groups, nhóm ghim app/client | Dùng chế độ cố định/cũ được hỗ trợ; bỏ group_id không bật auto | Nhận việc tương thích, không tự thêm quyền |
| Chat tổng hợp bị ẩn sau thu hồi quyền | Grants của mọi nhóm đã đóng góp | Host xem lại quyền; không chép tóm tắt sang phạm vi khác | Có quyền với mọi nhóm đóng góp hoặc chat vẫn ẩn |
| USD trống/tổng chậm | Phần có giá, giờ UTC đã đóng, kết nối | Giữ chưa biết/từng phần, xem lần gọi cụ thể | Không đổi chưa biết thành số không |
| Chat cũ lỗi sau đổi mô hình | Mô hình cũ còn trong danh sách cho phép? | Xem tương thích, việc mới dùng chat mới | Không xóa hay phát lại lịch sử |
Từ điển ngắn
| Từ | Nghĩa thực hành |
|---|---|
| Soot | Một agent có nhiệm vụ và quyền cụ thể |
| Runtime host | Máy chủ quyết định cấu hình, AI, khóa, giới hạn, công cụ và dữ liệu |
| Nest | Không gian của người vận hành, không phải runtime hay agent |
| Soul / mission | Cách làm ổn định / nhiệm vụ và ranh giới hiện tại |
| Skill / tool | Kiến thức/quy trình để đọc / thao tác được phép thực thi |
| Pack / capability | Gói phân phối / nhóm Skill-công cụ được chọn rõ |
| Conversation | Chat lưu bền gắn Soot/runtime đã chọn và chế độ: auto dùng A → B → A; chat cố định và nhóm ghim app/client vẫn cố định, phạm vi cũ không đổi |
| Nhóm tự động | Client hiện tại chọn group_id: auto khi có groups.auto.v1 và automatic_groups: true; native delegation chọn đích được phép, không bắt buộc bước chọn nhóm |
| Group | Phạm vi do host định nghĩa cho Soot nhận chat, đồng đội, thao tác đã duyệt gắn khóa, bộ nhớ riêng và giới hạn; không phải thư mục Nest hay sandbox hệ điều hành |
| Run | Lượt runtime nhận, có ID, trạng thái và phiên bản cấu hình |
| Execution | Quá trình mô hình/công cụ làm việc dưới giới hạn host |
| Saved / active | Phiên bản đã lưu / phiên bản host xác nhận đang dùng |
| Receipt | Biên nhận thao tác/kết quả; đang chờ chưa phải hoàn thành |
| Scope / grant | Phạm vi/quyền được host cấp, không do nội dung hay nhãn UI mở rộng |
| Data Pool | Dịch vụ nguồn dùng chung tùy chọn có chính sách/phiên bản riêng |
| Known cost | Chi phí ước tính cho phần quan sát có giá, không phải toàn hóa đơn |
Đọc Điều phối để hiểu tự phối hợp, tương thích API cũ, nhóm Forge và ranh giới public client.
Tài liệu đối chiếu
Dùng CLI/mã nguồn đang duy trì khi nhãn hay ghi chú phát hành cũ khác nhau. Điều kiện truy cập mã nguồn và bộ cài nằm ở phần chuẩn bị của hướng dẫn bắt đầu nhanh.
- Getting started — bắt đầu và bản phân phối.
- CLI — spawn/check/login/run/watch/nest.
- Configuration — trách nhiệm host và Soot.
- Runtime Packs — chọn capability.
- Models — nhà cung cấp/mô hình thay thế.
- Execution — giới hạn, việc con, Stop và kết quả chưa rõ.
- Monitoring — chi phí và độ mới số liệu.
- Nest browser — kết nối, danh tính, biên nhận.
- Nest Data Pool — quản lý bằng người và quyền.
- Desktop Settings — saved/active/Test.
- Product integration — khóa và danh tính của backend.
- Data Pool Pack — phần phụ thuộc và cài dịch vụ.
Đọc bằng trợ lý lập trình
Mỗi chương có Markdown không chứa giao diện trang: thêm /index.md vào URL hoặc dùng .md. Mục lục Markdown dẫn tới đủ chương; danh mục nguồn giúp tìm đúng ngôn ngữ. Đường Markdown không có thật trả 404, không trả giao diện ứng dụng thay thế.
Nội dung được xem lại: 09.10.2026