AgentOS 读者资源

完整插图 PDF · 24.3 MiB SHA-256

插图由本站提供，下载前需完成 Cloudflare 安全验证。PDF 已适度压缩，封面和每页页脚均可点击返回作者网站。图册只收录插图、图号和图题，不包含书籍正文。

下载配套源码 ZIP 下载 SHA-256 校验文件

GitHub：AgentOS-Lab 配套源码 · 问题反馈 · 仓库代码采用 MIT 许可。

文件大小：373285 字节（约 365 KiB）。解压后包含一份使用说明与一个 agentos_lab 工程。

SHA-256: 495c230f5cddedb29dec7e09f0a803dd997191ee8595a68af936c0887c0287c5

包内使用旧书名《从零搭建企业级 AgentOS》。此处提供原始交付包，网页采用正式出版名；下载后以包内目录和使用说明为准。

1. 运行第一个 Agent

仅用 Python 标准库，输出模拟采购建议，不写入 ERP。

python agentos_lab/agentos_lab/first_agent.py

2. 安装依赖并运行采购案例

先安装 uv，首次安装依赖需要联网。

uv sync --project agentos_lab --locked
uv run --project agentos_lab python -m agentos_lab.main run purchase --case normal --json

默认案例不需要模型密钥或企业系统账号。企业、ERP、OA 与业务数据均为模拟环境。真实模型、远程 MCP、OPA、Temporal 和遥测后端需要额外配置；framework 命令只展示本地接口映射。

3. 演练长任务恢复

python agentos_lab/run_purchase_task.py --task purchase-demo
python agentos_lab/send_approval.py --task purchase-demo
python agentos_lab/workers/purchase_worker.py
python agentos_lab/query_task.py --task purchase-demo

四条命令从同一目录依次执行，共用 .agentos-demo/tasks.sqlite3。审批后由 Worker 处理，查询结果应为 completed；重复处理不会重复创建模拟采购记录。新演练请换一个任务 ID。

1. 第 1 章 · 第一个 Agent

   • agentos_lab/first_agent.py

   python agentos_lab/agentos_lab/first_agent.py

   仅用标准库，输出模拟采购建议。

2. 第 2 章 · 对象契约

   • agentos_lab/domain.py
   • agentos_lab/schema_export.py
   • object_contract/

   uv run --project agentos_lab python -m agentos_lab.main framework schemas --json

   导出核心对象的字段与契约；独立手写校验示例见 object_contract/。

3. 第 3 章 · 任务运行时

   • agentos_lab/runtime.py
   • agentos_lab/graph_compat.py
   • agentos_lab/langgraph_api.py

   uv run --project agentos_lab python -m agentos_lab.main run purchase --case write-timeout --json

   演练采购超时；默认使用本地实现，LangGraph 需安装 runtime 可选依赖。

4. 第 4 章 · 模型网关

   • model_gateway/
   • agentos_lab/model_router.py
   • agentos_lab/litellm_gateway.py

   uv run --project agentos_lab python agentos_lab/model_gateway/route_demo.py --case purchase_budget_limit

   本地预算降级决策，不调用真实模型供应商。

5. 第 5 章 · 工具协议

   • agentos_lab/fastmcp_adapter.py
   • agentos_lab/protocols.py
   • agentos_lab/connectors.py

   uv run --project agentos_lab python -m agentos_lab.main framework fastmcp --json

   展示工具契约与框架映射；不代表接通远程 MCP 服务。

6. 第 6 章 · 数据与证据

   • agentos_lab/knowledge.py
   • agentos_lab/data_engine.py
   • agentos_lab/llamaindex_context.py

   uv run --project agentos_lab python -m agentos_lab.main run document --json

   运行本地文档案例；context_evidence/ 等独立目录含预设字段示例。

7. 第 7 章 · 策略与权限

   • agentos_lab/policy.py
   • agentos_lab/control_plane.py
   • agentos_lab/opa_policy.py

   uv run --project agentos_lab python -m agentos_lab.main run purchase --case permission-denied --json

   验证越权阻断；真实 OPA 执行需要另行配置服务。

8. 第 8 章 · 轨迹与测试

   • agentos_lab/trace_export.py
   • agentos_lab/otel_observability.py
   • agentos_lab/evaluations.py
   • tests/

   uv run --project agentos_lab python -m agentos_lab.main trace purchase --case write-timeout --json

   查看本地执行轨迹，无需遥测后端。

9. 第 9 章 · 长任务恢复

   • runtime_queue/local_queue.py
   • run_purchase_task.py
   • send_approval.py
   • workers/purchase_worker.py
   • query_task.py

   python agentos_lab/run_purchase_task.py --task purchase-demo

   先提交任务，再按下方恢复演练审批、处理和查询；使用本地 SQLite，不需要 Temporal 服务。 查看完整恢复步骤

10. 第 10 章 · 工程组合

    • agentos_lab/system.py
    • agentos_lab/registry.py
    • composition/

    uv run --project agentos_lab python -m agentos_lab.main run all --json

    执行核心场景；composition/ 与 composition_walkthrough/ 的预设输出不能作为真实集成验收。

11. 第 11 章 · 采购与设备实战

    • agentos_lab/runtime.py
    • agentos_lab/operations_runtime.py
    • agentos_lab/casebook.py

    uv run --project agentos_lab python -m agentos_lab.main run service --case stale-knowledge --json

    演练设备资料过期并阻断写回；采购冲突使用 run purchase --case erp-conflict --json。

12. 第 12 章 · 平台运营

    • platform_registry/
    • agentos_lab/backstage_catalog.py
    • agentos_lab/benchmark.py

    python agentos_lab/platform_registry/validate_catalog.py

    检查目录必要标记，不是完整 JSON Schema 校验；Backstage 仅提供对象映射，无独立平台服务。

2026-10-25 · 插图与公开源码

新增 89 张正式正文插图的完整 PDF 图册，提供图号、图题及校验值。配套代码现已发布至 AgentOS-Lab，支持查看源码和提交问题。

2026-09-10 · 配套源码整合版

将第 1 章示例纳入同一个工程，提供 12 章代码导航、锁定依赖和本地任务恢复演练。原交付记录报告：在 macOS arm64、Python 3.10.16 下，默认环境与 LangGraph 环境各 72 项测试通过。这是历史验证记录，不代表所有操作系统或真实外部服务均已验证。

勘误与反馈

暂未收录已确认条目。如发现问题，请发送章节、页码、源码版本、运行命令、错误输出及复现步骤至 xujiayu0606@gmail.com。

• 从零写一个 AI 编程助手：MiniCode 的设计笔记 — 工具调用、上下文与权限边界。
• 现代大语言模型的架构细节 — 理解模型网关背后的模型基础。