快速上手路径
验证 Manor AI 作为自托管 AI 工作区运行时所需的全部步骤:克隆仓库、启动本地 服务栈、登录、添加模型密钥、查看预置工作区,并确认受治理的操作会暂停等待 人工审批。
这是什么(简述)
Manor AI 是一个自托管的 AI 工作区运行时。一个工作区把目标、任务、文档、 知识、Agent、工具和人工审批规则集中在一处,让运营者清楚看到 Agent 被允许 做什么。
第一次运行应当验证四件事:
| 概念 | 应该看到什么 |
|---|---|
| 工作区 | 目标、任务、知识、规则、Agent 映射集中在一个运营视图里 |
| 运行时 | API、worker、PostgreSQL、Redis、MinIO、沙箱等服务协同运行 |
| 治理 | 自然语言规则映射为审批与拒绝的动作模式 |
| API 面 | FastAPI 端点与 Web 应用使用的完全一致 |
开始之前
安装 Docker Compose v2、Git、Python 3.11+ 和 Node.js 20+。本地评估可直接 复制示例环境文件;任何 共享部署都必须先替换生成的密钥并配置好凭据,再邀请 用户。
git clone https://github.com/manor-os/manor-ai.git
cd manor-ai
cp .env.example .env
共享部署前请先修改密钥。演示账号和默认
.env.example值仅供本地评估。
5 分钟路径
镜像在本地就绪后,预计 5-10 分钟。
| 步骤 | 页面或命令 | 应该看到什么 | 耗时 |
|---|---|---|---|
| 1 | docker compose up --build -d | 核心容器变为 healthy | 2-5 分钟 |
| 2 | http://localhost:18080 | 登录页和预置演示账号 | 1 分钟 |
| 3 | 设置 | 模型密钥保存在你的部署中 | 1-2 分钟 |
| 4 | 工作区 | 任务、目标、文档和运行评分 | 1 分钟 |
| 5 | 治理 | 敏感操作在工具执行前需要审批 | 1 分钟 |
1. 启动服务栈
docker compose up --build -d
这会启动 Web 应用、API、worker、带 pgvector 的 PostgreSQL、Redis、MinIO 和沙箱服务。
2. 打开 Manor AI
打开本地 Web 应用:
http://localhost:18080
自托管模式会预置一个本地演示账号:
demo@manor.local / manor-demo
3. 添加模型密钥
打开设置,为你想使用的模型路径添加一个提供商密钥。自托管部署下 Manor AI 采用 BYOK(自带密钥)模式,模型凭据只保存在你自己的部署中。
4. 查看工作区
打开工作区视图,查看运行评分、目标、任务、文档和 Agent 映射。工作区看起来 应该像一个正在运转的系统,而不是空空如也的 SDK 示例。
5. 检查治理
打开工作区规则。发外部消息、发社交帖等敏感操作可以要求人工审批;破坏性 操作可以在工具执行前直接拒绝。
完成后你将拥有
- 一个
http://localhost:18080的浏览器会话。 - 已登录的本地演示账号。
- 运行中的 API、worker、数据库、缓存、对象存储和沙箱服务。
- 一个可见任务、目标和治理规则的工作区。
- 同一部署内可访问的本地 API 文档。
