Loushang核心概念解析:Method、Session、Tool与模型Provider如何协同工作
Loushang核心概念解析:Method、Session、Tool与模型Provider如何协同工作
Loushang 是一个用 Python 构建的 AI-native agent harness(智能体执行框架),专为 coding 工作流设计:多模型 LLM 编排、有状态会话、工具治理与可追踪交付,支持 GPT、Claude、DeepSeek、Qwen、Kimi、GLM、MiniMax 等 Provider 路由。本文用最少的术语帮你搞懂它的四大核心概念——Method、Session、Tool、Model Provider,以及它们在一次编码任务中是如何协同运转的。
图:Loushang 架构中 Method、Agent、AI 与 admitted tools 的协作关系
一、Method:给 AI 定一份"工作契约" 📋
普通 AI 助手靠临场发挥,而 Loushang 的 Method(方法) 是一份面向一类任务的结构化工作契约。它明确规定:
- 适用条件:什么场景下启用该方法
- 角色与阶段:agent 应扮演什么角色、当前工作处于哪个阶段
- 流程与约束:按什么顺序推进、有哪些检查点(gates)
- 产物与验收:应产出什么 artifact、如何算"完成"
简单说,Method 让 AI 从"聪明地瞎干"变成"按合同交付"。核心类型定义在 types.py,如 MethodDescriptor(方法描述)、MethodStep(方法步骤)、MethodPlan(执行计划)等,配合 registry.py 完成方法的注册与选择。Loushang 的长期目标是让 Method 成为可执行、可改进的资产,而不是一纸静态流程文档。
二、Session:可恢复、可分叉的持久会话 💾
Session(会话) 是一次 coding 交互的持久记录,而不仅是聊天窗口。它保存:
- 消息与工具调用事件(tool events)
- 模型用量(usage)与成本
- 诊断信息与执行上下文
关键在于这些记录可恢复(resume)、可分叉(fork)、可导出(export)——中途断了、上下文炸了,都能从会话状态继续工作。这是 Loushang 与"一问一答"型 AI 的根本区别:会话是运行时事实的账本,而不是易失的对话流。
三、Tool:受策略治理的可执行能力 🔧
Tool(工具) 是提供给 agent 的可执行能力,比如读写文件、执行命令、调用内置 bash。Loushang 的 Tool 设计有两个原则:
- 策略治理(governed by policy):工具不是"能发现就能用",而是经过准入(admission)后挂载到具体作用域,权限、审批、沙箱都由策略层统一管控
- transcript 中清晰呈现:每次工具调用都会在会话记录中留痕,事后可审计、可回放
执行内核位于 agent_loop.py,Agent Loop 负责"模型输出 → 工具调用 → 结果回灌"的循环。架构图中也强调:Agent 依赖 AI 与已准入工具(admitted tools),工具运行受策略约束,它不额外获得权威。
四、Model Provider:模型目录驱动的 Provider 路由 🌐
Model Provider(模型供应商) 在 Loushang 中是一个组合概念:Provider 身份、endpoint 语义、模型能力、认证、默认值、兼容规则与价格元数据。你不需要硬编码任何一家 API 的细节——一切通过**模型目录(model catalog)**解析:
- 内置目录:models.json 声明了 GPT、Claude、DeepSeek、Qwen、Kimi、GLM、MiniMax 等可用模型
- 注册与解析:ModelRegistry 负责模型查找与能力声明
- 路由机制:ProviderRegistry 中的
ProviderRoute把请求路由到正确的供应商端点
上层代码只需"我要一个能做 X 的模型",目录层负责回答"该走哪家、怎么认证、多少钱"。这正是多模型 LLM 编排的含义:同一套会话与工具,可在不同 Provider 间切换而不改业务逻辑。
五、四者如何协同?一次编码任务的完整链路 ⚙️
把四个概念串起来,Loushang 的一次编码任务是这样运转的:
- Method 选中 —— 根据任务类型选择适用的方法,确定角色、阶段与验收标准
- Session 建立 —— 创建持久会话,方法上下文写入记录,随时可恢复
- Provider 路由 —— 模型目录解析出目标 Provider 与模型,完成认证并发起调用
- Agent Loop 执行 —— 模型产生工具调用,Tool 在策略治理下执行(读文件、改代码、跑命令),结果写回 Session
- 验收交付 —— 按 Method 约定的 artifacts 与检查点产出可验证的工作结果
用一句话总结分工:Method 定义"怎么干",Session 记录"干到哪",Tool 提供"怎么执行",Provider 决定"谁来思考"。四者各司其职,构成一套可恢复、可审计、可交付的复杂工作系统。
六、概念速查表
| 概念 | 一句话定位 | 源码/文档入口 |
|---|---|---|
| Method | 结构化工作契约(角色/阶段/流程/验收) | src/loushang/method/ |
| Session | 可恢复、可分叉的持久执行记录 | docs/zh-CN/concepts/README.md |
| Tool | 受策略治理的可执行能力 | src/loushang/agent/ |
| Model Provider | 模型目录驱动的多供应商路由 | src/loushang/ai/ |
七、想深入?从这里开始 📚
- 中文概念总览:docs/zh-CN/concepts/README.md(含工作产物 Work Product 等补充概念)
- 英文概念文档:docs/en/concepts/README.md
- 架构术语表(Product / OEM / Capability 等进阶词汇):docs/internals/glossary/loushang-product.md
- AI SDK 示例(模型查找、流式、工具调用、类型化上下文):examples/ai/
掌握这四个概念,你就理解了 Loushang 的设计哲学:不只是让 agent 更聪明,而是让复杂工作变得可靠、可恢复、可审计、可交付。
