RaykieLee / Synapse

# Synapse
**让数字员工融入团队，把时间留给更有价值的事。**
Synapse 是面向团队的数字员工工作台，将组织管理、协作空间和 AgentScope 智能体能力连接在一个产品中。管理员可以管理租户、成员和权限；团队成员可以在自己的 Workspace 中管理智能体、配置 AI 资源，并通过会话开展工作。
从一个账号开始，按组织划分租户，按团队或项目划分工作空间，让人与智能体在明确的访问边界内协作。
*当前运行版本的真实登录页面，截图于 2026 年 10 月 14 日。*
核心功能 · 使用流程 · 快速开始 · 当前版本与边界 · 开发与文档
## 为什么使用 Synapse
团队引入 AI 后，需要管理的不只是一次对话：还有谁能进入工作空间、谁能修改配置、凭据归谁所有，以及一次任务的过程如何追踪。
Synapse 将这些能力放进同一个工作台：
- **组织与 AI 一起管理**：租户、成员、角色和工作空间与智能体入口使用同一套账号体系。
- **按团队组织工作**：通过 Workspace 切换器进入不同团队或项目的空间，管理对应的成员和资源。
- **让权限可配置**：内置角色覆盖常见分工，自定义角色与菜单授权满足更细的管理需求。
- **让工作过程可见**：会话历史、流式消息、工具事件和人工确认界面帮助查看任务过程。
- **支持自托管**：提供 Docker Compose 部署，数据库、附件和 AI 运行数据通过持久化卷保存。
适合希望搭建内部 AI 工作台的团队、需要区分多个组织或项目的管理者，以及希望在 AgentScope 上扩展业务能力的开发者。
## 核心功能
### 一个工作台，管理多个组织
租户代表公司、组织或客户，Workspace 代表其中的团队或项目空间。同一个账号可以加入多个租户与工作空间，租户成员身份与空间成员身份分别管理。
| 能力 | 可以做什么 |
| --- | --- |
| 租户管理 | 创建与编辑租户，配置有效期开始和结束时间，管理租户状态 |
| 全局用户 | 管理账号、用户状态和平台角色，重置密码 |
| 成员与邀请 | 管理租户成员，通过邀请链接加入租户，并分配角色 |
| Workspace | 创建和管理协作空间，维护成员、空间角色与设置 |
| 空间切换 | 在左上角切换器选择当前工作空间，进入对应业务页面 |
平台管理员、租户 Owner/Admin/Member 与空间 Owner/Admin/Member/Viewer 各自承担不同职责。平台管理员身份不自动赋予读取所有成员私有聊天和凭据的权限。
### 把组织管理规则落到页面与操作
租户内提供角色、菜单、部门、字典和参数管理，用于维护团队的管理结构与应用配置。
| 能力 | 可以做什么 |
| --- | --- |
| 自定义角色 | 创建角色、配置权限，为租户成员分配或撤销角色 |
| 动态菜单 | 管理菜单树、配置角色与菜单的授权关系，按权限展示入口 |
| 部门管理 | 维护部门层级、排序和状态 |
| 字典管理 | 维护字典类型和条目，配置状态与排序 |
| 参数配置 | 管理租户配置项，区分公开投影与敏感值展示 |
| 系统任务 | 配置任务、手动触发、查看执行记录和失败结果 |
页面导航与操作权限由服务端作用域校验共同约束，直接修改 URL 也需要通过租户和空间访问检查。
### 在工作空间中管理数字员工
AgentScope 集成在同一个 Synapse 后端中，前端通过 Workspace 页面访问智能体与会话能力。
- **智能体管理**：创建、查看和编辑智能体定义。
- **会话与聊天**：管理会话、查看历史消息与附件，接收流式文本。
- **过程与人工介入**：展示工具事件，提供生成中断、工具权限确认和外部结果提交界面。
- **模型配置**：管理提供商凭据、自定义模型名称与 Base URL，以及工作空间模型绑定。
- **团队编排**：维护团队与任务定义，创建运行控制记录，查看事件并提交中断请求。
- **扩展资源入口**：知识库、MCP、Skills、SOP、AI 调度和渠道配置已提供前端页面。
模型配置和团队编排当前主要覆盖管理与运行控制记录；扩展页面的可用范围取决于服务配置和外部依赖。真实模型调用、工具执行和完整流程验收的限制见当前版本与边界。
### 桌面与手机都可以进入工作台
登录页提供用户名与密码登录、密码显隐、记住账号和中英文切换；管理界面提供侧边栏、面包屑与移动端导航。记住账号仅保存用户名。
 查看手机登录页 
## 使用流程
建议从组织管理开始，再配置工作空间，最后体验 AI 会话。
1. **登录工作台**：首次部署由管理员创建平台账号；团队成员使用已开通的账号登录。
2. **建立组织**：创建租户，配置状态与有效期，添加或邀请成员。
3. **分配职责**：为成员设置租户角色，根据需要配置自定义角色、菜单与部门。
4. **进入团队空间**：创建 Workspace，加入空间成员，分配空间角色，通过切换器进入对应空间。
5. **配置 AI 资源**：查看智能体、模型与凭据页面；真实聊天需要在 AgentScope 凭据入口配置可用模型凭据。
6. **开始会话并查看过程**：选择智能体、创建会话，查看历史与流式消息；按任务需要使用人工确认等交互。
第一次体验建议分别用管理者、普通成员与 Viewer 账号登录，比较菜单、操作按钮和资源可见范围。全新部署不会自动创建演示账号或填充业务数据。
常用入口如下。路径中的租户 ID 和工作空间 ID 应替换为实际数据。
| 场景 | 页面路径 |
| --- | --- |
| 登录 | `/sign-in` |
| 租户与用户 | `/tenants`、`/users` |
| 租户详情 | `/tenants/{tenantId}` |
| 角色与菜单 | `/tenants/{tenantId}/roles`、`/tenants/{tenantId}/menus` |
| 部门、字典、参数 | `/tenants/{tenantId}/departments`、`/tenants/{tenantId}/dictionaries`、`/tenants/{tenantId}/configs` |
| 系统任务与执行记录 | `/tenants/{tenantId}/scheduled-tasks` |
| 空间成员与设置 | `/w/{workspaceId}/members`、`/w/{workspaceId}/settings` |
| 模型与 AgentScope 凭据 | `/w/{workspaceId}/models`、`/w/{workspaceId}/credential` |
| 智能体、团队与会话 | `/w/{workspaceId}/agents`、`/w/{workspaceId}/teams`、`/w/{workspaceId}/sessions`、`/w/{workspaceId}/chat` |
| 知识库、工具与流程 | `/w