产品信息
更新于:2026年05月19日
什么是 Agentspan
Agentspan 是一个用于 AI 代理的持久执行运行时,它以开源服务器加 SDK(Python 和 TypeScript)的形式提供,可帮助您以生产就绪的方式构建、运行和观察代理。Agentspan 不会将执行状态保留在您的应用程序进程中(在该进程中,崩溃、重启和超时会导致进度丢失),而是将代理作为持久工作流运行,其状态存在于 Agentspan 服务器上。它支持常见的代理模式,如工具使用、结构化输出、内存、流式事件和多代理协调,并且可以直接使用,也可以作为现有框架(如 OpenAI Agents SDK、Google ADK 和 LangGraph)的即插即用执行层。
Agentspan 的主要功能
Agentspan 是一个开源的、可自托管的服务器和 SDK,它将代理代码转化为持久的、可观察的工作流,其执行状态存在于您的进程之外。它专为生产环境设计:代理可以从精确的步骤崩溃并恢复,无限期暂停以待人工批准,自动重试工具调用,并运行多代理协调模式——同时通过本地服务器/UI 提供完整的事件流和执行历史记录。它通过简单的模型字符串支持多个模型提供商,增加了防护措施和结构化输出,并包含用于 CI 的确定性测试实用程序。
持久执行(默认崩溃+恢复): 工作流在 Agentspan 服务器上持久化,因此代理可以在进程崩溃后幸存下来,并可以从任何机器重新连接,从上次完成的步骤恢复,而无需自定义检查点。
人工参与的审批: 将工具标记为需要审批,以便运行可以干净地暂停(几分钟或几天),并通过代码或外部渠道(例如,Slack/web 门户)在审批/拒绝后恢复。
多代理管道和协调策略: 使用 `researcher >> writer >> editor` 等表达式组合代理,并使用多种协调模式(顺序、并行、切换/路由器、群集等),并提供每步日志记录和持久性。
可观察性+流式事件: 提供完整的执行历史记录和实时事件流,用于工具调用/结果、LLM 请求、切换、计时、错误和完成——支持实时 UI 和调试。
结构化输出+防护措施: 强制执行类型化输出(例如,Pydantic 模型)和安全/验证防护措施(正则表达式、自定义检查或 LLM 检查),并具有可配置的自动重试、修复、升级或暂停以待人工处理的行为。
框架集成和模型提供商灵活性: 通过最小的更改与现有代理框架(例如,OpenAI Agents SDK、Google ADK、LangGraph)配合使用,并通过切换单个提供商/模型字符串支持许多模型提供商。
Agentspan 的使用场景
带审批的客户支持自动化: 运行代理来起草回复、丰富案例并触发退款或账户更改等操作,同时对敏感步骤需要人工批准,并维护可审计的执行轨迹。
财务/运营工作流(可重试的工具自动化): 自动化对账、发票处理或后台任务,其中工具调用可能会暂时失败——Agentspan 的持久步骤和重试减少了手动重启和工作丢失。
研究和内容管道: 创建多代理链(研究 → 撰写 → 编辑),可以可靠地运行长时间作业,将进度流式传输到 UI,并在中断后恢复,而无需重新运行已完成的步骤。
IT/DevOps 运行手册和事件响应: 协调诊断和修复步骤,对高风险操作设置人工门槛,并提供完整的可观察性以进行事件后审查和重放。
企业数据分析助手: 部署长时间运行的分析代理,这些代理在会话之间保留状态,强制执行结构化报告输出,并为合规性和利益相关者审查提供可追溯性。
优点
持久性是内置的(崩溃安全、可恢复的工作流),而不是需要自定义检查点。
强大的生产工具:可观察性、流式事件、重试和人工参与的暂停。
开源(MIT)和可自托管;支持多个模型提供商并与流行的代理框架集成。
缺点
需要运行 Agentspan 服务器/运行时(与简单的进程内脚本相比,需要额外的基础设施)。
对于小型或纯交互式代理,某些高级功能(持久性、编排)可能会增加概念开销。
如何使用 Agentspan
1) 安装 Agentspan: 在您的 Python 环境中,安装 SDK:`pip install agentspan`。
2) 启动(或验证)Agentspan 服务器 + UI: 安装 Agentspan CLI(例如,`npm install -g @agentspan-ai/agentspan`,或从源代码构建)并运行本地服务器,以便您可以在可视化仪表板中检查运行(通常在 `http://localhost:6767`)。使用 `agentspan doctor` 验证设置。
3) 为代理定义要调用的工具(函数): 创建 Python 函数并用 `@tool` 装饰它们。使用类型提示和文档字符串,以便 Agentspan 可以自动为工具调用生成模式。
示例:
Agentspan 常见问题
Agentspan 是一个开源 (MIT)、可自托管的服务器以及 SDK/CLI,它将 AI 代理定义编译成持久性工作流。执行状态存在于您的进程之外,因此代理可以在崩溃后继续运行、重试工具调用,并支持长时间运行和人工批准的自动化。













