# AIOS：企业级智能体平台

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

## Basic Information

- **Project Name**: AIOS：企业级智能体平台
- **Description**: AIOS：企业级智能体平台
- **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-06-10

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# AIOS 快速部署手册

## 推荐环境

- x64 架构
- 4C8G 或更高硬件配置
- Ubuntu 25.10 或更高版本

## 安装步骤

### 1、安装 Docker Engine

依次执行以下命令：

```bash
curl -fsSL https://get.docker.com -o get-docker.sh
```

```bash
sudo sh ./get-docker.sh
```

[点击查看安装说明](https://docs.docker.com/engine/install/ubuntu/)。

> 提示：开发和验证测试场景中，可采用 Windows 版本的 Docker Desktop 临时替代，具体做法参考“常见问题”。

### 2、启动 AIOS 容器

执行以下命令：

```bash
docker run -d --restart unless-stopped --name aios-all-in-one --cap-add NET_ADMIN --network bridge -p 3030:3030 -p 1883:1883 -p 9000:9000 -v /var/aios_root/:/var/aios-all-in-one crpi-4auaoyyj6r36p6lb.cn-hangzhou.personal.cr.aliyuncs.com/huozige_lab/aios-all-x64:[版本号]
```

其中的 `[版本号]` 请参考本项目的Release，如 `20260604.04`。默认的启动参数可适配大多数场景，如需定制，请 [点击查看详细说明](/docker-images/all-in-one/README.md)。

### 3、配置 AIOS

容器启动后，等待1分钟左右，使用浏览器访问宿主机的3030端口（如`http://docker-host-ip:3030`），打开 AIOS 的管理控制台。

#### 3.1 添加大语言模型

AIOS 支持为不同的数字员工配置不同的大语言模型。您可以在 AIOS 管理控制台中点击【模型管理】菜单，依次配置【服务商】和【模型】。

创建服务商时需要提供的信息：

- 服务商ID：服务商的标识，您可以自行拟定，推荐采用简短的英文单词，如 `qwen`
- 基础地址：服务商文档中提供的 `OpenAI兼容 Chat Completion API` 地址，通常以 `v1` 结尾，如 `https://dashscope.aliyuncs.com/compatible-mode/v1` 或 `https://api.siliconflow.cn/v1`
- 访问密钥：服务商提供的访问密钥，通常需要在服务商的 `API密钥` 或 `API Key` 等页面中创建

创建模型时需要提供的信息：

- 服务商：选择该模型所在的服务商
- 模型ID：服务商提供的模型名称，如 `deepseek-v4-flash` 或 `gpt-5.4`，通常可以在服务商的 `模型广场` 等页面中找到
- 名称：模型的标识，您可以自行拟定，推荐直接采用模型ID
- 上下文长度：从服务商提供的文档中获取，主流厂商的最新旗舰模型通常为1M，即`1000000`
- 输入上限：从服务商提供的文档中获取

> 提示：大模型配置需要 AIOS 重新加载内核才能生效，您可以在 AIOS 管理控制台中点击【系统设置】菜单，找到 `重启服务` 按钮，手动触发重新加载，或等待创建数字员工时，一并重启。

#### 3.2 接入业务系统

业务系统接入能力，让您可以将使用活字格开发的应用系统作为工具，提供给 AI 使用，从而加速在企业的智能化改造。您可以在 AIOS 管理控制台中点击【业务系统】菜单，添加接入 AIOS 的业务系统。

接入业务系统时需要提供的信息：

- 提供方：选择 `hzg`
- 应用名：活字格应用的应用名称，您可以在活字格管理控制台的 `应用管理` 页面中获取
- 协议：如果活字格应用启用了 `https/ssl`，就选择 `https`，否则选 `http`
- 主机名：活字格服务管理器的 IP 地址（内网部署）或域名（外网部署），除非通过容器启动参数 `--dns-search` 配置了内网域名，否则不要直接使用机器名代替 IP 地址
- 端口号：活字格应用的端口号，您可以在活字格管理控制台的 `应用管理` 页面中获取
- 状态：选择 `启用`
- 描述：您可以自行编写
- 本体压缩包：使用 `huozige-ontology-builder` 构建的本体文件（去掉临时用的.json文件）打成的zip包，具体方法请 [点击查看详细说明](https://www.npmjs.com/package/huozige-ontology-builder)

#### 3.3 创建数字员工

数字员工是业务用户使用 AIOS 的媒介，通常推荐为每个部门或小组创建一个数字员工，而不是为每个员工创建。您可以在 AIOS 管理控制台中点击【数字员工】菜单，新增数字员工。

新增数字员工时需要提供的信息：

- ID：数字员工的标识，您可以自行拟定，推荐采用该数字员工服务的部门或小组的英文单词或缩写，如 `finance` 或 `prod`
- 使用模板：沉淀了经验、知识、技能的员工模板，初次使用直接选择 `default`
- 数字员工名称：数字员工的中文标识，您可以自行拟定
- 服务商、模型：根据部门或小组的工作特点，选择合适的大模型
- 每日限额：数字员工每天可以使用的Token总数，超过该数量后，将自动熔断，数字员工停止提供服务，直到管理员在数字员工的 `编译` 页面中将其恢复

> 提示：创建数字员工将会导致 AIOS 重新加载内核，服务中断1分钟左右。

#### 3.4 测试数字员工

为了帮助您快速检查数字员工的基础功能是否正常，AIOS 提供了数字员工测试功能。您可以在 AIOS 管理控制台中点击【数字员工】菜单，点击需要被测试的数字员工，然后再点击 `对话测试` 按钮，进入测试界面。

> 提示：对话测试仅用于检查大语言模型是否可用，无法调用业务系统。

#### 3.5 将数字员工分配给用户

数字员工的使用需要受控严格管控。您可以在 AIOS 管理控制台中点击【数字员工】菜单，点击数字员工的【管理用户】按钮，输入有权限使用该数字员工的用户名。

这里的用户指活字格用户，您可以在活字格管理控制台的 `内建用户` 页面中查询。

### 4、对接 AIOS 对话应用

#### 活字格版 AIOS 对话应用

使用活字格 v12.0 或更高版本设计器，打开协同工程：`https://gitee.com/low-code-dev-lab/aios-cui-hzg` 将其发布到接入 AIOS 的应用所在的活字格服务器。然后在活字格管理控制台下 `应用管理` 页面中打开该应用，依次修改以下全局变量，然后重启该应用即可使用。

- AIOS_MQTT_CHANNEL_HOST： AIOS 宿主机的 IP 地址
- AIOS_MQTT_CHANNEL_PASSWORD： 在 AIOS 宿主机的 `/var/aios_root/credentials.json` 文件中获取，mqtt的密码
- AIOS_S3_ENDPOINT： `http://docker-host-ip:9000`，其中 `docker-host-ip` 是 AIOS 宿主机的 IP 地址
- AIOS_S3_SECRET_ACCESS_KEY： 在 AIOS 宿主机的 `/var/aios_root/credentials.json` 文件中获取，minio的密码
- AIOS_MANAGEMENT_CONSOLE_BASE_URL： `http://docker-host-ip:3030`，其中 `docker-host-ip` 是 AIOS 宿主机的 IP 地址
- AIOS_MANAGEMENT_CONSOLE_TOKEN： 在 AIOS 管理控制台【系统设置】页面下【访问令牌】选项卡中获取

## 常见问题

Q1：如何将 AIOS 部署在使用 ARM CPU 的信创服务器？
A：请发送邮件联系作者 `will.ning@grapecity.com`。

Q2：AIOS 如何升级？
A：先使用 `docker rm -f` 删除旧版本的容器，然后再次执行采用了新版本号的 `docker run` 命令即可，旧版本的文件会被保留。

Q3：如何定制 AIOS 的对话界面？
A： 将 `https://gitee.com/low-code-dev-lab/aios-cui-hzg` fork 到您自己的 Git 仓库，然后使用活字格设计器进行修改后发布。

Q4：AIOS 的对话应用和接入 AIOS 的业务应用必须部署在同一台活字格服务器？
A： 是的。AIOS的业务系统权限校验机制基于活字格的权限功能构建，为了确保登录对话应用的用户，能够将访问凭证“传递”给业务应用，这些应用必须部署在同一个活字格服务管理器上。

Q5：我想在 Windows 电脑上部署 AIOS 怎么办？
A：在 Windows 上安装 `Docker Desktop`，[点击查看安装方案](https://docs.docker.com/desktop/setup/install/windows-install/)；然后，从“2、启动 AIOS 容器”开始，记得将命令行中 `/var/aios_root/` 替换为提前创建好的 Windows 的目录，如 `D:\aios_root` 。