DuraGraph

这个 Agent 能做什么，适合哪些场景？

DuraGraph 是一个自托管、面向企业场景的 AI 工作流编排系统，核心思路是把每一次状态变更都作为不可变事件写入 PostgreSQL，并与工作本身放在同一个事务里，因此 worker 在工具调用中途崩溃也不会丢状态，整个运行可以从事件日志重放。仓库是 monorepo：cmd/duragraph 是控制平面二进制（引擎 + 内嵌 dashboard + 开发模式引导），internal/ 按 DDD、事件溯源与 CQRS 分层，dashboard/ 是 React + TanStack Router + xyflow 的控制台（含可视化工作流编辑器，构建时嵌入二进制），python/ 与 go-sdk/ 是两类 worker SDK，examples/ 提供 Go 与 Python 参考 Agent，deploy/ 存放 Docker、SQL 迁移与 Helm chart。对外接口是稳定的 REST + SSE API，覆盖 runs、threads、assistants、graphs；worker 通过 SDK 在启动时注册图定义，不需要代码生成或自定义 DSL。部署边界很清晰：开发模式用单个二进制内嵌 PostgreSQL 与 NATS，生产环境可换成外部 Postgres 和 NATS。

运行时，worker 通过 Python 或 Go SDK 连接控制平面并注册图定义；客户端调用 POST /api/v1/threads/:id/runs 创建 run，引擎的图执行引擎按节点、边、条件分支、human-in-the-loop 中断与工具调用逐步推进，并把每个状态迁移作为事件写入 PostgreSQL 事件存储。写事务与工作本身同一事务提交，因此崩溃后可从中断处恢复，且不会重复执行。Outbox relay 把领域事件转发到 NATS JetStream，dashboard 通过 SSE 实时显示节点点亮、图拓扑与可回放的轨迹。读取侧走 CQRS 查询，GET /api/v1/runs/:id 取运行状态，GET /api/v1/threads/:id/runs 列出会话中的 run，GET /api/v1/threads/:id/runs/:run_id/stream 订阅实时执行事件，POST /api/v1/assistants 注册 assistant，GET /api/v1/assistants/:id/graph 读取图结构。此外暴露 OpenTelemetry 友好的 Prometheus 指标。

1. 需要长时间运行的 LLM Agent 团队：Agent 会跑几小时甚至更久，担心 worker 在中途崩溃导致状态丢失，希望重启后从最后一个已提交状态继续。
2. 需要审计与合规的场景：要把每一次状态变更按时间顺序留痕，并基于事件存储做 eval 与合规视图。
3. 被线上失败困扰的开发者：想按产生问题的确切决策序列逐步回放出错 run，而不是只看堆栈和模糊的最后已知位置。
4. 想免运维试跑自己的 AI 工作流的个人或小团队：用 duragraph dev 一条命令起引擎和内嵌 Postgres/NATS，从 Playground 发第一条消息。
5. 已经在用 Go 或 Python 写 Agent 的工程团队：用 go-sdk 或 python/ 中的 SDK 注册图定义，接入现有代码而不写 DSL。
6. 平台团队：需要自托管的控制平面、REST + SSE 接口、Prometheus 指标，并计划在生产替换成外部 Postgres 与 NATS。

如何安装或部署这个 Agent？

README 给出四种安装途径，任选其一：

# Homebrew（macOS、Linux）
brew install Duragraph/tap/duragraph

# 一行安装脚本
curl -fsSL https://duragraph.ai/install.sh | sh

# 从 Go 安装
go install github.com/Duragraph/duragraph/cmd/duragraph@latest

# 或从 Releases 下载预编译二进制
# → https://github.com/Duragraph/duragraph/releases

从源码参与开发：

git clone https://github.com/Duragraph/duragraph.git
cd duragraph
task dev   # 针对本地 Postgres + NATS 启动引擎与 dashboard
task test  # 单元 + 集成测试套件

凭据方面：无需预先配置数据库或消息中间件，开发模式内嵌 PostgreSQL 与 NATS；首次启动后使用日志中打印的 bootstrap admin 账号登录 dashboard。生产环境需要外部 PostgreSQL 与 NATS（deploy/ 下提供 Docker 与 SQL 迁移，Helm chart 仍标注为进行中）。

如何使用这个 Agent？

第一步启动服务：

duragraph dev
# → 引擎与 dashboard 监听 http://localhost:8081

第二步跑通第一个 Agent：打开 http://localhost:8081，用日志里打印的 bootstrap admin 登录，进入 Playground，选择一个已注册的 assistant，发送一条消息；可以看到工作流实时执行，每个节点依次点亮，并能在 Traces 中查看完整图拓扑与可回放的事件日志。examples/ 下有 RAG、工具调用 Agent、文档处理、eval 等 Go 与 Python 示例，可直接对着 duragraph dev 运行。

第三步接入自己的 Agent：起一个 worker，用 python/ 或 go-sdk/ 里的 SDK 在启动时注册图定义；然后通过 REST + SSE 驱动 run：

POST   /api/v1/threads/:id/runs                  # 创建 run
GET    /api/v1/runs/:id                          # 查询 run 状态
GET    /api/v1/threads/:id/runs                  # 列出某会话的 run
GET    /api/v1/threads/:id/runs/:run_id/stream   # SSE：实时执行事件
POST   /api/v1/assistants                        # 注册 assistant
GET    /api/v1/assistants/:id/graph              # 读取图拓扑

这个 Agent 有哪些优点和局限？

这个 Agent 与同类方案有什么区别？

与相关度最高的同类 agent 并排比较关键指标。

FollowAgents 如何评估这个 Agent？

常见问题