【免费下载链接】loushangAI-native agent harness for coding workflows by python: multi-model LLM orchestration, stateful sessions, tool governance, traceable delivery, and provider routing for GPT, Claude, DeepSeek, Qwen, Kimi, GLM, and MiniMax.项目地址https://gitcode.com/gh_mirrors/lo/loushang点击查看免费下载Loushang AI SDKloushang.ai是 Loushang 项目内置的底层模型调用层专为 Python 开发者打造一套 API 同时驾驭 GPT、Claude、DeepSeek、Qwen、Kimi、GLM 和 MiniMax 等主流厂商完整支持流式输出、工具调用、Reasoning 推理与结构化输出。本文带你快速看懂它的核心设计从模型选择到四大进阶能力一篇讲透。 为什么需要统一的 AI SDK直接对接各家模型 API 的痛点很常见协议格式不一Anthropic Messages、OpenAI Chat Completions、OpenAI Responses、鉴权方式不同、流式事件粒度不一致、usage 计费口径有差异。Loushang 的解法是把差异全部收敛在 SDK 内部对上层只暴露一条调用链Model → CallOptions → 认证解析 → 协议适配 → 冻结请求 → 流式事件组装其核心机制是provider:endpoint:model三元组寻址每个模型都通过厂商、端点、模型 ID 三个字段唯一定位端点声明了baseUrl、能力是否支持流式/工具/图片和协议适配器运行时不做隐式回退。这样你拿到的AssistantMessage上始终带有完整的响应来源信息方便审计与排查。架构总览如下图所示图中Agent AI区域展示了模型访问层如何作为准入能力融入整个执行底座 流式输出统一事件流一次终结Loushang 的流式输出以stream()为入口返回AssistantMessageEventStream异步事件流。事件类型定义在 types.py全部事件归一为同一套语义start/text_start/text_delta/text_end文本增量thinking_delta推理过程增量toolcall_start/toolcall_delta/toolcall_end工具调用增量组装done终结事件携带完整AssistantMessage与stop_reasonerror携带类型化错误载荷关键正确性契约值得记住流必须恰好终结一次厂商静默无响应不会被自动补成功error或aborted终结之后不会再产生成功事件。事件流的队列缓冲与终态管理实现在 event_stream/stream.py。典型用法完整可运行示例见 02_stream.pyfrom loushang.ai import ApiKeyAuth, CallOptions, get_model, stream model get_model(moonshot, openai-completions, kimi-k2.6) events await stream( model, {messages: [{role: user, content: 从一数到三}]}, CallOptions(authApiKeyAuth(...), idle_timeout_seconds10), ) async for event in events: if event[type] text_delta: print(event[delta], end) message await events.result() # 拿到最终 AssistantMessage两个超时字段语义清晰timeout_seconds覆盖单次尝试的全程含首包idle_timeout_seconds只约束流式片段之间的空闲时间。️ 工具调用严格校验 并行组装工具治理是 Agent 可靠性的关键。Loushang 的工具链路设计为定义 → 校验 → 执行 → 回传闭环工具 schema 校验实现在 tool/validation.py。它的两个亮点1. 双校验策略。validate_tool_arguments提供严格模式与coerce强制转换模式严格模式拒绝2这种字符串数字coerce模式会转换参数并输出诊断信息转换路径、原类型、目标类型让模型偶尔嘴瓢传错类型不再直接炸掉整轮对话。2. 并行工具调用增量组装。流式场景下多个toolcall_delta事件按content_index增量拼装成完整ToolCall一轮返回多个调用时stop_reason为toolUse可参考 05_parallel_tools.py。离线示例 04_tools.py 演示了完整回传闭环定义add工具 → 收到ToolCall→ 校验参数 → 本地执行 → 用ToolResultMessage把结果带回上下文。另外CallOptions的pairing_mode默认为repair会自动修复历史对话中工具调用后结果缺失的悬空配对而不是让请求直接失败。 Reasoning预算可控的推理过程对支持推理的模型Loushang 通过ReasoningOptions提供统一的推理控制面定义在 options.pyfrom loushang.ai import CallOptions, ReasoningOptions options CallOptions( reasoningReasoningOptions( effortmedium, # 推理力度 budget_tokens2048, # 推理 token 预算 expose_summaryTrue, # 是否暴露推理摘要 ), )设计要点推理配置只解析一次并对照模型能力声明做校验各协议适配器负责把统一的推理参数映射到各自的 wire 协议不同厂商字段完全不同。推理 token 不会重复计入输出 token流式时以独立的thinking_delta事件呈现可与正文text_delta分通道展示。示例见 06_reasoning.py。 结构化输出Schema 即契约当你需要模型返回可直接落库的数据时complete_structured()配合StructuredOutputOptions是标准解法实现位于 structured.pyresult await complete_structured( model, {messages: [{role: user, content: 给出答案与置信分}]}, CallOptions(outputStructuredOutputOptions(modejson_schema, schemaANSWER_SCHEMA)), ) print(result.parsed) # 已是解析好的对象支持两种模式json_object要求返回合法 JSON 对象宽松场景使用json_schema传入 JSON Schema或 Pydantic 风格类型strict 模式下约束更严strict: True时会禁用额外属性两个关键行为能力不匹配时提前失败——如果模型不支持结构化输出或适配器没有对应映射错误会在调用厂商之前抛出避免浪费一次真实请求StructuredOutputResult同时保留raw原始消息和parsed解析结果调试与兜底都方便。可运行示例见 07_structured_output.py。 上手路径与配套资源推荐的学习路线是跟着 examples/ai/ 的 12 个编号示例走它们全部离线运行、不消耗真实额度示例能力01_complete.py完整返回02_stream.py流式事件04_tools.py工具调用与校验05_parallel_tools.py并行工具调用06_reasoning.pyReasoning 选项07_structured_output.py结构化输出模型目录内置覆盖anthropic、openai、deepseek、dashscopeQwen、moonshotKimi、zaiGLM、minimax等十余家厂商目录文件位于 model/models.json自定义 catalog 可用custom_model_file.py加载。 延伸阅读SDK 完整文档docs/en/sdk/README.mdAI 包设计说明src/loushang/ai/README.md错误与重试示例09_errors_retry.pyusage 与成本估算10_usage.py✅ 小结Loushang AI SDK 的四大支柱——统一流式事件、严格工具校验、可控 Reasoning、契约化结构化输出——背后是同一条设计主线把厂商差异冻结在协议适配器内部把正确性契约一次终结、提前失败、usage 不重复计暴露在公共 API 边界。无论你接的是 GPT、Claude 还是 DeepSeek、Kimi上层代码都只需要关心get_model→stream/complete/complete_structured这三步即可得到可审计、可恢复、可治理的模型调用能力。赞分享【免费下载链接】loushangAI-native agent harness for coding workflows by python: multi-model LLM orchestration, stateful sessions, tool governance, traceable delivery, and provider routing for GPT, Claude, DeepSeek, Qwen, Kimi, GLM, and MiniMax.项目地址https://gitcode.com/gh_mirrors/lo/loushang点击查看免费下载相关推荐python-sdk 结构化输出完全指南让 MCP 工具返回类型注解即输出 Schemapython sdk 结构化输出完全指南让 MCP 工具返回类型注解即输出 Schema 输出文章 MCP Python SDK 结构化输出指南从返回类型人工智能MCP 服务MCP Clientsresponsive-html-email-signature完全指南告别邮件签名排版噩梦5分钟打造专业响应式设计responsive html email signature完全指南告别邮件签名排版噩梦5分钟打造专业响应式设计 在数字化办公时代一个专业的邮件签名不仅HsMod炉石插件基于BepInEx的高级游戏体验优化方案HsMod炉石插件基于BepInEx的高级游戏体验优化方案 HsMod是一款基于BepInEx框架开发的炉石传说高级功能增强插件专为追求极致游戏效率和个性化游戏开发创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考