guilds.run：可检查、可调试的多智能体工作流平台

guilds.run 是 Cigale AI 开发的开源多智能体工作流平台。它把具有不同任务、模型和工具权限的 AI 组成长期运行的团队，并保留执行记录，方便你核对结果、排查错误和调整协作方式。

通俗解释：guilds.run 到底是干什么用的？

可以把它理解成一个“AI 小组的工作台”。你给研究员、写作者或整理员各自分配任务，让它们在同一个群聊里交流，把发现写进共享笔记或表格。你既能查看最终回复，也能打开某次运行，看到模型实际收到的提示词、调用了哪些工具、工具返回了什么，以及记忆如何变化。

这里的 guild 就是一支智能体团队；agent 是成员；Task 是每次运行都会读取的长期任务说明；run 是一次执行记录。它适合需要反复执行并持续改进流程的开发者和运营团队，例如信息研究、线索整理或待审核回复生成。只想偶尔问一个问题的用户，还需考虑配置模型和维护部署的投入。

用角色、共享笔记与表格组织协作

每个成员可以使用不同模型，并获得适合自己工作的工具。团队共享聊天、笔记和表格；智能体自己的记忆则用于延续后续运行的上下文。笔记适合保存规则和研究结论，表格适合管理结构化记录，脚本适合保存可重复执行的处理逻辑。

连接器可以连接外部服务或 MCP 工具，但“官网展示了图标”不等于账号已经接好。Gmail、Google Drive 和 GitHub 等接入涉及管理员配置应用及凭证；应先确认所需连接器的当前文档，再决定授权给组织、团队还是单个成员。建议从一个清晰任务开始，把输入、输出和允许的动作写进 Task，再逐步增加角色。

多智能体出错时，如何检查并修正？

在回复旁打开 Inspect run，先看模型实际收到的 Task，再逐步核对工具输入和返回结果。这样可以区分问题来自任务说明、数据、工具还是记忆，而不是仅凭最后一句回复猜测。记忆、笔记及脚本也有可检查的持久化记录，能帮助追溯错误如何进入下一轮工作。

Prompt Studio 文档说明，Studio 会读取已有团队的执行证据，起草长期任务的修改。你审阅差异后选择发布或放弃；教练不会自行发布。发布影响后续运行，已经保存的旧运行保持原样。可观测性有助于发现问题，但不保证模型输出自动正确。

从 Docker 部署到验证第一个团队

准备 Docker 与 Compose 插件、git 和 bash，按官方安装说明执行：

git clone https://github.com/CigaleAI/guilds.git
cd guilds
./setup.sh
docker compose up --detach --wait

首次构建镜像可能需要几分钟。保留生成的 .env，其中包含加密已存凭证所需的密钥。启动后在浏览器打开 http://127.0.0.1:8080/。

1. 在欢迎窗口选择模型供应商，连接 API Key，勾选允许使用的模型，并选一个默认模型。
2. 创建一个 guild，在侧栏添加 agent，打开 Prompt，填写长期 Task 并保存。
3. 回到 Group chat 发送测试任务。以 @成员名 开头可以定向唤醒成员；不带标签的消息会唤醒整个团队。
4. 打开 Inspect run，核对提示词和工具步骤。再问一个依赖前次信息的问题，并在 State 中检查记忆版本，确认上下文确实保存。

先验证一次小任务的结果，再接入业务账号或安排定时运行。默认本地安装的访问方式与面向多人使用的远程部署不同，远程访问需按官方配置说明处理。

模型选择、免费边界与数据去向

截至 2026 年 10 月 14 日，开源核心可免费自部署，许可证为 AGPL-3.0-only；官方文档将托管版本描述为独立的专有实现，本次未核实到当前可用的托管套餐和额度。因此，“免费”指软件本身，不包含服务器、云端模型或第三方工具费用。

核心支持 OpenAI、OpenRouter、xAI、DeepInfra，以及 Ollama、LM Studio、vLLM 等兼容接口的本地端点。Claude、Gemini 等可通过 OpenRouter 接入；Kimi Code 仅服务编程智能体。不要把官网的“任意模型”理解为所有模型无需适配即可使用。

模型与密钥文档明确：API 用量由密钥所属账号承担，平台没有内置支出上限，需要在供应商一侧设置预算。连接云端模型时，请求仍会发送到所选供应商；自部署不能直接等同于数据完全离线。连接本机模型还需注意 Docker 内的 127.0.0.1 指向容器本身。

官网的隐私及条款入口本次返回 404，无法核实完整保留、训练或托管数据条款。凭证应按任务最小范围授权；文档也提醒，共用同一机器的智能体存在共同信任边界，需要隔离的凭证应配合独立机器配置。

定时任务和 Recipes：复用流程时保留哪些内容？

Routine 可以按计划唤醒成员，并支持暂停。Cron 按 UTC 解释，唤醒间隔至少五分钟；随机时间窗口则有自己的时区设置。测试结束后暂停例行任务，避免持续产生模型费用。

Recipes把团队配置保存为 JSON，包括角色、Task、表格结构、脚本及日程等。操作路径为 Save as recipe、审核、导出；导入后先查看创建预览，完成登录及外部设置清单，再激活例行任务。它不会复制密钥、聊天历史、记忆、表格记录或浏览器登录状态。官网公开 Recipes 目录仍标注“即将上线”，不要将展示案例视为已开放的模板市场。

常见问题

guilds.run 免费使用会不会产生账单？

会有可能。自部署软件免费，但云端模型、服务器和外部服务可以单独收费。平台不替你设置模型支出上限，也不能把页面示例成本当成自己的固定日费。

能否使用本地模型，让敏感数据留在自己环境中？

可以配置兼容接口的本地模型端点，但仍要检查连接器和外部工具的数据流。若使用云端模型，请求会到达该供应商；官网完整隐私条款目前未能核实。

能看到 AI 为什么产生这个结果吗？

可以打开回复旁的 Inspect run，查看实际提示词、工具输入和返回结果，再对照记忆版本。它提供执行证据，帮助定位原因，但不会自动保证结果正确。

官方资源与开发者社区

• 官方文档：安装、连接器和日常运维说明。
• GitHub 源码与问题反馈：检查实现、许可证及提交问题。
• 官方 X 账号：查看产品公告。
• 官网链接的 Discord 社区：社区交流入口，访问可能需要账号及频道权限。