# 企业级智能体集群平台（CodeName：AIOS）

**Repository Path**: low-code-dev-lab/aios-oc

## Basic Information

- **Project Name**: 企业级智能体集群平台（CodeName：AIOS）
- **Description**: 活字格企业级AI智能体集群解决方案（一体化容器）
- **Primary Language**: TypeScript
- **License**: Not specified
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-05-14
- **Last Updated**: 2026-07-08

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 快速部署手册

解决方案由一体化容器和对话应用构成，一体化容器中内置智能体集群构建与管理所需的全部组件，对话应用使用活字格构建，提供实现对话式交互。

## 推荐环境

- x64 架构
- 4C8G 或更高配置
- Linux / WSL / Docker Desktop

## 步骤1:启动容器

```bash
docker volume create aios-data
docker run -d --restart unless-stopped --name aios --cap-add NET_ADMIN -p 3030-3050:3030-3050 -p 1883:1883 -p 9000:9000 -v aios-data:/var/aios crpi-4auaoyyj6r36p6lb.cn-hangzhou.personal.cr.aliyuncs.com/huozige_lab/aios-hzg-x64:[版本号]
```

`[版本号]` 请参考项目 Release，例如 `20260702.01`。运行数据保存在 Docker volume `aios-data` 中；如需隔离多套环境，请替换为新的 volume 名称。详细说明见 [docker/README.md](./docker/README.md)。

## 步骤2:登录管理控制台

容器启动后，等待 Docker logs 出现 `management console should be available ...`，然后访问宿主机 `3030` 端口，例如：

```text
http://127.0.0.1:3030
```

启动命令会开放 `3030-3050`。其中 `3030` 当前用于管理控制台，`3031-3050` 作为后续服务预留端口。

默认账号：

- 用户名：`aios`
- 初始密码：`123456`

首次登录后请按提示修改密码。

## 步骤3:配置大语言模型

在管理控制台“大语言模型”菜单中依次创建服务商和模型。

服务商需要：

- 服务商 ID
- OpenAI 兼容 API 基础地址，通常以 `/v1` 结尾
- API Key

模型需要：

- 所属 Provider
- 模型 ID
- 名称
- 上下文长度、输入上限等参数

如果模型服务位于内网，需要在管理控制台 `系统设置` 页面中，将该服务器的地址（如 `172.16.11.12`）添加到白名单。需要注意的是，白名单的变更需要重启容器方可生效，而不是重启服务。

## 步骤4:接入业务系统

首先，在管理控制台 `系统设置` 页面中，将业务系统和对话应用所在的服务器 IP 地址（对话应用和业务系统需要部署在同一台服务器中）设置到 `对话应用/业务应用服务器`。因为修改后该配置后，系统会同步调整 IP 白名单，需重启容器后生效。

然后，在“业务系统”菜单中添加接入的业务系统。活字格系统通常需要填写：

- 应用名
- 端口
- 是否启用 HTTPS
- Ontology zip

Ontology zip 需通过 `huozige-ontology-builder` 构建，[点击阅读使用指南](https://www.npmjs.com/package/huozige-ontology-builder)。

## 步骤5:添加数字员工

在“数字员工”菜单中创建数字员工。通常需要配置：

- ID
- 模板
- 名称
- 服务商 / 模型
- 每日 Token 限额
- 授权用户

创建完成后，点击 `授权用户` 按钮，将改数字员工分配和活字格管理控制台上的用户。此处需要输入的是用户名，而不是用户全名。

## 步骤6:对接对话应用

对话应用采用活字格构建，可使用 `https://gitee.com/low-code-dev-lab/aios-cui-hzg`。

发布后在应用全局变量中配置：

- `AIOS_SERVER_IP`
- `AIOS_MQTT_CHANNEL_PASSWORD`
- `AIOS_S3_SECRET_ACCESS_KEY`
- `AIOS_MANAGEMENT_CONSOLE_TOKEN`

MQTT/MinIO 密码可在 `系统设置` 页面中 `基础设置` 选项卡获取；管理控制台 Token 在 `访问令牌` 选项卡中创建。

重启应用后，就可以登录对话应用，开始使用您的数字员工了。

## 性能测试

- 测试版本：20260701.01
- 测试环境：2C4G
- LLM：本地模拟，收到请求后等待 5 秒再返回，非阻塞
- 测试规格：
  - 数字员工 x 100
  - 用户 x 1000，每个数字员工关联 10 个用户
  - 数字员工模板 x 100，每个工作区模板 100 个文件
  - 技能 x 100
  - 系统 x 100
- 测试计划：
  - 预热：1 分钟
  - 稳态：10 分钟

| 并发 | 结果 | 稳态成功/请求 | 失败 | 吞吐 req/s | P50 | P95 | P99 | CPU 峰值 | 内存峰值 |
| ---: | --- | ---: | ---: | ---: | ---: | ---: | ---: | ---: | ---: |
| 20 | 通过 | 986/986 | 0 | 1.64 | 11.857s | 17.119s | 21.945s | 202.39% | 1.66GiB |
| 50 | 通过 | 1000/1000 | 0 | 1.67 | 28.185s | 40.100s | 58.307s | 199.70% | 2.05GiB |
| 100 | 通过 | 998/998 | 0 | 1.66 | 56.599s | 74.609s | 93.801s | 180.19% | 2.13GiB |