面向生产环境的 AI Agent Python 框架，内置预算控制、持久化记忆与多智能体编排能力。
Syrin 是一个面向开发者的生产级 AI Agent Python 框架（要求 Python ≥ 3.11），由 Syrin Labs 维护，当前版本 0.11.0（Alpha 阶段），采用 MIT 许可证。
核心能力#
预算控制#
将预算控制作为一等公民设计，每次 LLM 调用前检查预算，支持 4 种超支策略：STOP（硬性停止）、WARN（警告）、IGNORE（忽略）、SWITCH（自动切换低成本模型）。内置小时/天/月维度的费用窗口控制（RateLimit），支持在预算消耗至特定百分比时触发自定义回调（BudgetThreshold），BudgetPool 支持多 Agent 共享总预算且线程安全，reserve 参数可为最终回复预留金额防止中断。
多智能体编排#
提供 5 种开箱即用的拓扑结构：ORCHESTRATOR（动态路由）、PARALLEL（并行合并）、CONSENSUS（投票共识，可配置最小同意比例）、REFLECTION（生成-批评循环）、WORKFLOW（顺序/并行/分支/动态扇出）。通过统一的 Swarm 类配合 SwarmConfig 和 SwarmTopology 无缝切换，每个 Agent 拥有独立费用明细与预算利用率报告。
持久化记忆#
四象限记忆系统：FACTS（身份与偏好）、HISTORY（事件与对话）、KNOWLEDGE（通用知识，适配向量检索）、INSTRUCTIONS（技能与流程）。语义化操作 API：agent.remember()、agent.recall()（语义搜索）、agent.forget()。6 种存储后端：MEMORY（内存/测试）、SQLITE（默认）、QDRANT、CHROMA、REDIS（支持 TTL）、POSTGRES（pgvector）。支持衰减曲线与跨会话持久化。
可观测性与调试#
72+ 生命周期钩子覆盖 LLM 调用、工具调用、预算事件、记忆操作及 handoff 等。CLI 添加 --trace 参数即可零侵入启用全链路追踪。内置 OpenTelemetry OTLP gRPC 导出器。基于 Rich 的 TUI 步进调试器支持断点、事件查看及工具/记忆/护栏状态检查。
安全护栏#
PIIGuardrail 实现邮箱、电话、SSN、卡号等敏感信息的检测与脱敏；LengthGuardrail 限制输出长度；ToolOutputValidator 验证工具返回结果。检查结果集中反映在 result.report.guardrail.passed。
生产级增强特性#
- 结构化输出：保证返回 Pydantic / JSON 类型
- TOON 格式：自研 Token-Oriented Object Notation，替代 JSON Schema，号称减少 40% token 消耗
- 容错恢复：Checkpoint 机制自动保存状态，崩溃后精确恢复
- 事件驱动：支持
CronProtocol（定时）和WebhookProtocol（钩子）触发 - 服务化：
agent.serve()一键启动 FastAPI 服务，内置 Playground UI（/chat、/stream、/playground） - 身份防伪：Ed25519 加密身份签名，防止 Agent 伪造
- 多模态扩展：集成 ElevenLabs/Deepgram/Cartesia 语音处理，Docling/python-docx/openpyxl 文档解析
- 知识库/RAG：支持 GitHub 仓库、文档、PDF、网站作为知识源
典型应用场景#
| 场景 | 关键能力 |
|---|---|
| 研究流水线 | 并行 Agent 收集信息 + 共识拓扑验证结论 |
| 客户支持机器人 | 会话记忆、PII 护栏、低置信度时转人工 |
| 文档智能 | RAG + 结构化输出 + 按文档预算控制 |
| 金融分析 | 硬性费用上限、审计日志、类型安全结构化结果 |
| 语音 AI 助手 | ElevenLabs/Deepgram 集成、跨通话记忆 |
| 合规审查 | PII 扫描、输出验证、完整溯源记录 |
| 自主调度器 | Cron/webhook 触发、崩溃恢复检查点 |
安装与快速开始#
pip install syrin # 基础安装
pip install syrin[openai] # OpenAI 支持
pip install syrin[anthropic] # Anthropic 支持
pip install syrin[voice,pdf,vector] # 多模态
pip install syrin[openai,anthropic,serve,vector,postgres,pdf,voice] # 全量
from syrin import Agent, Budget, Model
from syrin.enums import ExceedPolicy
class Analyst(Agent):
model = Model.OpenAI("gpt-4o-mini", api_key="...")
budget = Budget(max_cost=0.10, exceed_policy=ExceedPolicy.STOP)
system_prompt = "You are a precise financial analyst."
result = Analyst().run("Summarise Q3 revenue trends")
print(result.content)
print(f"Cost: ${result.cost:.6f} | Tokens: {result.tokens}")
架构要点#
采用 src/syrin/ (src layout) 规范，核心模块包括 syrin.agent、syrin.budget、syrin.memory、syrin.swarm、syrin.guardrails、syrin.knowledge、syrin.debug、syrin.checkpoint、syrin.watch、syrin.serve。基于 Python 类继承的声明式定义模式，直接封装 openai/anthropic/litellm SDK，使用 httpx 作为 HTTP 客户端、tiktoken 计算 Token、chevron（Mustache）处理提示词渲染、chonkie 负责文本分块、docling 解析 PDF。全量 StrEnum 枚举、Pydantic v2 数据模型、通过 mypy strict 严格类型检查，使用 Ruff 统一 Lint/Format。
待确认信息#
- 文档侧边栏提及 MCP 集成与 A2A messaging，具体实现范围未深入确认
- 首次发布时间、团队背景、生产用户案例均未公开
- 未发现关联学术论文或 Hugging Face 页面