Course 01 · Reliability
Production Harness Engineering
Đọc nguyên bản course outline, hướng dẫn vận hành, ADR và evaluation docs—không nén thành một syllabus khác.
37 tài liệu gốc63.812 từ371 phút đọc
Đọc đầy đủ bằng tiếng Việt hoặc English
Mục lục bám trực tiếp README, running_the_code, docs/adr, evals và docs/notes của upstream. Các bài viết Decoding AI bên ngoài repository được giữ dưới dạng liên kết gốc trong README. Mỗi tài liệu có bản dịch tiếng Việt song song với nguyên bản upstream; người học có thể chuyển đổi bất kỳ lúc nào.
Mục lục theo upstream
Thứ tự dưới đây xuất phát từ chính repository, không phải một cấu trúc bài học được biên soạn lại.
Bắt đầu từ nguồn
README gốc giữ nguyên course outline, mục tiêu, yêu cầu và liên kết đến các bài viết/video chính thức.
Hướng dẫn chạy và vận hành
Toàn bộ hướng dẫn thực hành trong running_the_code, theo đúng thứ tự đánh số của upstream.
020304050607080910
Khắc phục sự cố
Troubleshootingrunning_the_code/00_troubleshooting.mdBắt đầu
Getting Startedrunning_the_code/01_install_and_usage.mdDanh mục mô hình phương thức - Chọn và phục vụ mô hình để khai thác decode
Modal Model Catalog — Picking & Serving a Model for the decode Harnessrunning_the_code/02_modal_endpoints.mdruntime headless - decode chạy, độ bền và phát lại
Headless Runtime — decode run, durability & replayrunning_the_code/03_runtime.mdSandboxing - Không gian làm việc biệt lập, --repo & hỗ trợ git
Sandboxing — isolated Workspaces, --repo & the git hand-backrunning_the_code/04_sandboxing.mdĐánh giá decode
Evaluating decoderunning_the_code/05_evals.mdThông tin xác thực - một bề mặt cấu hình
Credentials — one config surfacerunning_the_code/06_credentials.mdInfra — ngăn xếp runtime từ xa (chạy decode trên Modal, do ZenML/Kitaru điều phối)
Infra — the remote runtime stack (decode run on Modal, orchestrated by ZenML/Kitaru)running_the_code/07_infra.mdagent & agent phụ
Agents & Subagentsrunning_the_code/08_subagents.mdQuyết định kiến trúc
Các ADR nguyên bản ghi lại quyết định, bối cảnh và đánh đổi trong quá trình xây dựng harness.
11121314151617181920212223242526272829
0001. Ghi lại các quyết định về kiến trúc
0001. Record architecture decisionsdocs/adr/0001-record-architecture-decisions.md0002. Kiến trúc cột mốc 1 - coding agent vani trên thiết bị
0002. Milestone 1 architecture — vanilla on-device coding agentdocs/adr/0002-milestone-1-vanilla-agent-architecture.md0003. Cột mốc 2 — danh mục hệ thống cấp phép và agent
0003. Milestone 2 — permission system & agents catalogdocs/adr/0003-milestone-2-permission-system-and-agents-catalog.md0004. Cột mốc 3 - Kỹ năng (tiết lộ tiến bộ)
0004. Milestone 3 — Skills (progressive disclosure)docs/adr/0004-milestone-3-skills.md0005. Hỗ trợ nhiều nhà cung cấp LLM - phụ trợ suy luận có thể lựa chọn (Gemini / OpenRouter / Modal)
0005. Multi-LLM-provider support — selectable inference backends (Gemini / OpenRouter / Modal)docs/adr/0005-multi-llm-provider-support.md0006. Nén hội thoại - nén bộ nhớ trong ngữ cảnh + khi thoát hai tầng tương đối với cửa sổ, trên JSONL
0006. Conversation compaction — window-relative two-tier in-context + on-exit memory compression, on JSONLdocs/adr/0006-conversation-compaction.md0007. Tích hợp LSP — mã Python được hỗ trợ thông minh qua hai kênh, trên máy khách stdio được cuộn bằng tay
0007. LSP integration — ty-backed Python code intelligence via two channels, on a hand-rolled stdio clientdocs/adr/0007-lsp-integration.md0008. runtime bền vững của Kitaru — một luồng headless như một đường dẫn vào thứ hai, không phải là một trình bao bọc xung quanh REPL trực tiếp
0008. Kitaru durable runtime — a headless flow as a second entry path, not a wrapper around the live REPLdocs/adr/0008-kitaru-durable-runtime.md0009. Hạ cấp pydantic-ai 2.0 → 1.x (và giới hạn pydantic/click) để tích hợp runtime Kitaru
0009. Downgrade pydantic-ai 2.0 → 1.x (and cap pydantic/click) to integrate the Kitaru runtimedocs/adr/0009-downgrade-pydantic-ai-for-kitaru.md0010. Tính năng phát lại được hỗ trợ bởi Kitaru cho quá trình decode headless — sử dụng lại tính năng phát lại gốc, chỉ xây dựng các trình kích hoạt
0010. Kitaru-powered replay for the headless decode run — reuse native replay, build only the enablersdocs/adr/0010-runtime-replay.md0011. Sandboxing + Credential Proxy — ba người thực thi đằng sau một đường nối chạy, một mitmproxy headless cho thông tin xác thực công cụ
0011. Sandboxing + Credential Proxy — three executors behind one run seam, a headless mitmproxy for tool credentialsdocs/adr/0011-sandboxing-and-credential-proxy.md0012. Không gian làm việc biệt lập - một SandboxExecutor + phần phụ trợ mỏng, sắp xếp các công cụ thông qua đường nối, sao chép tại gốc
0012. Isolated Workspace — one SandboxExecutor + thin backends, file tools through the seam, clone-at-rootdocs/adr/0012-isolated-workspace.md0013. Khám phá các subagent — công cụ agent và phân xuất song song trong quá trình
0013. Explore subagents — the Agent tool & in-process parallel fan-outdocs/adr/0013-explore-subagents.md0014. Khả năng quan sát của Opik - dấu vết cho mỗi lượt, lượt chạy và subagent
0014. Opik observability — traces for every turn, run, and subagentdocs/adr/0014-opik-observability.md0015. Bí mật về môi trường-nhóm - một bề mặt cấu hình, hai cơ chế tiêm
0015. Environment-Bucket secrets — one config surface, two injection mechanismsdocs/adr/0015-environment-bucket-secrets.md0016. Bỏ Proxy xác thực - một bề mặt bí mật, một cơ chế tiêm token
0016. Drop the Credential Proxy — one secret surface, one token-injection mechanismdocs/adr/0016-drop-credential-proxy.md0017 — bộ decode eval: demo, benchmark, thăm dò hồi quy, khai thác Opik
0017 — decode eval suite: demos, benchmark, regression probes, Opik harnessdocs/adr/0017-decode-eval-suite.md0017. Linh hoạt, song song theo mặc định Khám phá phân xuất phân ra — một cuộc gọi tổng đài viên, N con đã được xác thực, một tập hợp được gắn nhãn
0017. Resilient, parallel-by-default Explore fan-out — one agent call, N validated children, one labelled aggregatedocs/adr/0017-resilient-parallel-subagent-fanout.md0018. Sửa lỗi nén — Điểm cắt ModelResponse, nguồn token phản hồi cuối cùng, hiển thị kết quả, tóm tắt đường nối của nhà cung cấp
0018. Compaction fix — ModelResponse cut points, last-response token source, outcome surfacing, provider-seam summarizerdocs/adr/0018-compaction-cut-points-token-source-and-provider-seam-summarizer.mdEvaluation
Tài liệu gốc cho benchmark, regression probe và evaluation harness.
Tra cứu kỹ thuật
Glossary và các ghi chú chuyên sâu đi kèm repository.
3334353637
Thuật ngữ
Glossarydocs/glossary.mdProxy thông tin xác thực
The Credential Proxydocs/notes/credentials_proxy.mdSong song hóa thông qua hộp cát
Parallelization via sandboxesdocs/notes/parallelization-via-sandboxes.mdPhương pháp hộp cát - decode so với khai thác tham chiếu (+ Codex)
Sandboxing methods — decode vs the reference harnesses (+ Codex)docs/notes/sandboxing_comparison_table.mdSeatbelt/bwrap là gì?
What is Seatbelt/bwrap?docs/notes/sandboxing_seatbelt_bwrap.md