Sim 智能体工作流工作区

它是什么

Sim 是一个用来构建、部署和管理 AI 智能体与工作流的工作区。它的 README 说，你可以用可视化的方式、对话的方式或者写代码来构建智能体。一个工作区里有由相连的块组成的工作流，还有表格、文件、知识库和日志。你可以把一个工作流部署成 API、聊天界面或 MCP 服务器。Sim 由 Sim Studio 制作。你可以用 Sim Cloud，或者用 Docker Compose 或 Kubernetes 跑在你自己的服务器上，Mac 应用可以打开这两种部署里的工作区。

1. 你在 Chat 里描述一个任务，或者在构建器里添加块
2. Sim 搭出一个由相连的块组成的工作流
3. 你运行它，在 Logs 里读每个块的输出
4. 你把它部署成 API、聊天或 MCP 服务器
5. Logs 记下每一次运行

适合谁

想把智能体和自动化放在一处，并且让表格、文件和知识库就在身边的人。想把它托管在自己的 Docker 或 Kubernetes 环境里的团队。想让 Claude Code、Codex 或 Cursor 通过 MCP 替自己运行和部署工作流的开发者。如果你不想自己管 Docker、数据库和一堆密钥，就别走自托管这条路，Sim Cloud 不需要这些。

用在哪里

Sim 可以在下面这些地方使用，文档里也写明了这几种连接其他工具的方式。

• Sim Cloud，在 sim.ai 登录
• 用 Docker Compose 跑在你自己的服务器上，由 sim-setup 向导启动，或者用 Helm 装进 Kubernetes 集群
• Sim Desktop，一个 macOS 应用，打开你的工作区，并增加浏览器、终端和本地文件工具
• 通过 MCP 连接的 Claude Code、Claude、Codex、Cursor 和 VS Code
• 通过 Ollama、vLLM 或 LM Studio 使用的本地模型，用在自托管的 Sim 上

如何设置

点“获取”会把一个装有 Mindket 安装说明的 zip 压缩包存进你的下载文件夹，里面按 Sim 的 README 和文档列出了每个智能体和平台的步骤。Sim Cloud 不用安装。自托管的话，README 给的路径是 sim-setup 向导。

1. 运行向导。它会问几个问题，生成密钥，写入 .env，并启动已发布的镜像。
2. 向导打开浏览器时登录，用来连接 Chat 密钥。
3. 打开 http://localhost:3000。

npx sim-setup

README 说向导会建一个小小的 sim 文件夹，不会克隆仓库，并用 Docker Compose 启动容器。在那个文件夹里运行 npx sim-setup status，可以看到装了什么、是否健康。

如何使用

先在 Chat 里开始，或者在工作流构建器里手动搭。Getting started 页面用一个简单的摘要器演示这两种方式，它由一个 Start 块和一个 Agent 块组成。

1. 选 New chat，请它做出这个工作流。
2. 检查 Sim 搭出的块，补上缺失的模型凭据。
3. 点 Run。打开构建器底部的 Logs，选中 Agent 块，读它的 Output。

Build a workflow that summarizes a product update in one sentence. Use a Start block and an Agent block, and open it beside this chat.

想连接编程智能体的话，就把 Sim 加成一个 MCP 服务器。Cloud 的地址对每个客户端都一样，每个客户端各有自己的添加方式。

示例

你想看一个工作流运行，并读它的结果。在 Getting started 页面上，你添加一个 Agent 块，选一个模型，把消息角色设为 User，再粘贴一段简短的产品更新。

Summarize this update in one sentence:
We launched the new dashboard on Monday. Customers can now filter
reports by team and export them as CSV. The mobile layout is still
in progress.

你点 Run，打开这个块的 Output。页面说 content 字段里是摘要，措辞可能不同。它给出的可能结果是这样。

The new dashboard adds team filters and CSV exports, with the mobile layout still in progress.

新手与专家

新手：工作流就是一串相连的块。新工作流里有一个 Start 块，Agent 块请一个模型去干活。Logs 显示每个块收到了什么、返回了什么。如果运行失败，页面说要在 Logs 里选中失败的块，读它的报错。然后检查所选的模型和它的凭据，再运行一次。这一步走通之后，页面会指向 <start.input> 这样的引用，用来在块之间传数据。

专家：Sim MCP 提供四个工具。search_operations 查找操作，describe_operation 返回一个操作的输入，call_read_operation 和 call_write_operation 去运行它。由操作所需的权限决定用读工具还是写工具，而不是看它的 HTTP 方法。一次调用写明操作名，并填上它需要的内容：

{
  "operation": "listTableRows",
  "params": { "tableId": "tbl_8f2c" },
  "query": { "workspaceId": "ws_91ab", "limit": 50 }
}

Tools 页面把一次结果限制在 1 MiB，并说 MCP 上没有流式传输，也不传文件字节。OAuth 请求的是 api:read 或 api:write，所以只读访问是你自己要去请求的一个范围。无法通过浏览器登录的客户端，可以在 X-API-Key 头里发送 API 密钥。自托管的服务器用 https://<your-sim-host>/api/mcp，或者你的 SIM_MCP_URL。

在 Docker Compose 安装或源码检出里，npx sim-setup add 可以配置 email、storage、sandbox、jobs、cache、knowledge、chat、llm，或者像 slack 这样的集成。Docker 页面说它会拒绝 Helm 发布。npx sim-setup doctor 检查配置。Kubernetes 页面用 Helm 3.8 或更高版本，从 oci://ghcr.io/simstudioai/charts/sim 安装 chart。

注意事项

Sim 用你的密钥和你的数据运行智能体，所以在依赖它之前，有几点要先知道。

• 许可证：核心是 Apache License 2.0，LICENSE 附录里写着“Copyright 2026 Sim Studio, Inc.”。SSO、访问控制、访问请求、白标和 SCIM 这类企业功能放在单独的 ee 文件夹里，适用另一份许可证。它允许开发、测试和内部非生产使用，生产使用需要企业版订阅
• Chat：它是由 Sim 管理的服务。自托管的安装需要一个 Chat 密钥，或者你设置 NEXT_PUBLIC_CHAT_DISABLED=true 把 Chat 藏起来
• 安装命令：README 写的是 npx sim-setup。Docker 页面写的是 bunx sim-setup，并把 Bun 列为前提。这些说明两种都给了
• 密钥：把 ENCRYPTION_KEY 和 API_ENCRYPTION_KEY 备份在服务器之外的地方。用不同的密钥恢复数据库，加密过的值就读不出来了。已有的安装上，千万别再运行 Docker 页面里那条生成 .env 的命令
• 上传文件：生产用的 Compose 文件没有挂载 uploads 文件夹，所以重建 app 容器会丢掉存在那里的文件，除非你先配好对象存储
• 使用数据：对于自托管的 Sim，Environment variables 页面说，NEXT_TELEMETRY_DISABLED=1（Docker 和 Helm 的默认值）会关掉匿名遥测
• 桌面版：它的终端以你 macOS 账户的权限运行命令，可能改动你批准的文件夹之外的文件。浏览器和终端默认是开着的，可以在设置页里关掉
• MCP 访问：在 Sim 设置里创建的 API 密钥默认没有过期时间。要撤销一个应用，去 Settings → General → Authorized apps。撤销不会还原这个应用已经改过的内容
• 移除：npx sim-setup down 会删除容器并保留数据卷，但没有挂载的 uploads 文件夹里的上传文件会丢失，除非你配好对象存储或持久挂载。npx sim-setup reset 会归档 .env 并清掉受管理的数据。两个都会先问你。Desktop 页面没有给出卸载步骤