Heym 是一个自托管的运行时与平台,用于在用户自有基础设施上构建、编排、运行、观测、评估和控制智能体系统。按照官方描述,它覆盖智能体生命周期的多个环节:构建、编排、运行、观测、评估、控制与对外暴露,这些环节相互连接,可用观测与评估结果反过来优化提示词、工具和工作流逻辑。
主要能力
- 构建:支持可视化与 AI 辅助创作。可在画布上搭建并检查工作流图,通过 AI 助手用文本或语音生成或修改,并可复用模板。将 LLM 与 Agent 节点同条件、分支、循环、合并、数据转换、子工作流调用等确定性逻辑结合,支持在受支持字段中使用表达式。
- 多智能体编排:为编排器指定具名子智能体与子工作流进行调用,独立子智能体调用可并发执行,并按智能体配置推理强度与温度。
- 知识与记忆:通过 RAG 使用 Qdrant 或 PostgreSQL/pgvector 检索文档;为智能体启用知识图谱以跨运行保留事实,并可配置智能体之间的共享权限,用图编辑器检查与编辑记忆。
- 工具与集成:通过内置节点、HTTP API 与 MCP 连接通信服务、开发者工具、生产力应用、数据库、队列和存储;使用 MCP Call 节点进行确定性工具调用。
- 技能与自定义行为:为智能体附加可复用的 SKILL.md 指令和可选 Python 工具,用 AI 创建或修改技能、安装插件,或用带类型配置与执行处理器的自定义节点扩展。
- 运行:支持并行执行与恢复,独立节点并发运行,用 Merge 同步分支,并可配置重试、退避、错误路径与模型回退;可通过 cron、webhook、消息集成、收件箱事件、WebSocket 消息和平台事件触发。支持用 Playwright 的浏览器自动化与选择器恢复,以及把 Codex 或 OpenCode Go 作为工作流步骤对代码库运行并产出 diff 与拉取请求。
- 智能体看板:卡片即持久化的智能体任务,把卡片移入某列会按其有序工作流链运行,结合卡片内容、评论、历史与先前输出,并把结果写回卡片。
- 负载分布:通过 PostgreSQL 在多个 Heym 实例之间分配符合条件的后台运行,可在设置中的实例页面配置执行权重。
- 观测:可从历史记录或看板卡片打开生产运行,检查保存状态,跟踪实时节点进度、调试日志与最终输出;查看模型请求、响应、工具调用、输入输出 token、延迟和错误,用维护的模型价格与自定义覆盖计算美元成本,并按模型与时间范围查看历史支出;跟踪执行量、成功率与时长,查看日志,设置错误、时长、token 或美元支出以及运行数量的告警,并通过 OpenTelemetry 导出工作流、节点与智能体工具跨度。
- 评估与控制:运行可重复的提示词评估以跨模型比较预期与实际输出并查看历史结果;工作流分析器利用执行上下文生成可编辑的 Markdown 报告,说明目的、步骤行为与改进点。智能体检查点可暂停执行以接受、编辑或拒绝,再从保存的执行快照继续,审核分支可通过现有集成通知人员。安全与访问方面可配置输入护栏、加密凭据、团队共享、执行令牌和工作流认证,支持 JWT 或通过 Keycloak、Okta、Entra ID、Auth0、Google 等提供商的 OIDC SSO 登录。
- 对外暴露:通过 REST、SSE 和 MCP 从应用调用工作流、流式传输执行事件,或把工作流发布为 MCP 客户端可用的工具(地址为 /api/mcp/sse)。门户与聊天可发布由工作流驱动的聊天界面,支持流式、上传与对话历史;还可构建由工作流支撑的自定义仪表板组件,管理结构化数据表,并把生成文件保存在 Heym Drive 中,支持团队共享与分享链接。
使用方式与部署 本地试用:git clone https://github.com/heymrun/heym.git && cd heym && ./run.sh,随后打开 http://localhost:4017 创建账户并开始构建。run.sh 会启动 PostgreSQL、后端和前端,并在需要时生成 SECRET_KEY 与 ENCRYPTION_KEY。前置条件为 Bun、Python 3.11+、UV 和 Docker。 Heym 以 PostgreSQL 作为核心数据库,标准 Compose 设置包含 PostgreSQL、后端与前端,并用本地卷保存持久文件。RabbitMQ 与 Redis 是按需连接的集成;RAG 可使用内置 PostgreSQL/pgvector 后端或外部 Qdrant 服务器;S3 通过其集成节点使用。生产部署使用 Docker Compose 与 Python 3,官方建议先注册管理员账户,然后在 .env 中设置 ALLOW_REGISTER=false 并重启以关闭注册。另有预构建 Docker 镜像,镜像内含前端与后端,示例把它连接到主机上已有的 PostgreSQL 数据库,需设置 DATABASE_URL;在 Linux 上使用 host.docker.internal 主机名时加 --add-host=host.docker.internal:host-gateway。挂载与运行时设置支持 Playwright(--shm-size 2g)、Heym Drive(FILE_STORAGE_DIR=/app/data/files)、插件(HEYM_PLUGINS_DIR=/app/data/plugins)、Codex 工作区、OpenCode Go 工作区与 Docker 访问(用于沙箱容器与 MCP stdio 执行)。多实例执行可把更多 Heym 实例连接到同一 PostgreSQL 数据库以分配符合条件的后台工作流运行,主实例提供 UI、API、MCP 与门户并拥有本地文件和已安装插件,工作实例执行符合条件的排队运行。
示例与适用场景 官方演示展示了一个端到端的电商销售活动流程,包含用 AI 助手生成工作流、人工审核、看板执行、结构化数据、仪表板、追踪、RAG、MCP、分析与团队协作。另有编排器与子智能体系统的演示:对“如何从柏林到法兰克福”“到那该吃什么”之类请求,编排器可在同一轮调用相互独立的子智能体、并发运行并合并结果。还可通过自然语言生成工作流、从聊天调用工作流,并创建附加到智能体的技能。
限制与状态 Heym 处于 1.0 之前的发布系列,官方建议关注版本徽章与发布说明获取更新;部署指南与安全策略提供运维设置参考。上述功能与组件以官方仓库文本为准,未提及的价格、平台支持范围或效果不在资料中,暂未提供。