快速开始
本章节帮助你在最短时间内完成 Data Agent 的首次部署、数据接入与体验验证。按照以下步骤操作即可得到一个可回答基础问题的 Agent。
1. 环境准备
2. 获取并启动服务
在任意目录下创建 docker-compose.yml（可放在独立目录中方便后续维护），根据网络环境选择下方“国外版”或“国内版”：
version: "3"
services:
app:
image: chatbi/yiask:latest
container_name: yiask
environment:
- PROJECT=test
# PG元数据库的配置
- DB_HOST=postgres
- DB_DATABASE=mydatabase
- DB_USER=postgres
- DB_PASSWORD=postgres
# MONGODB的配置（未来版本会废弃）
- MONGO_URL=mongodb://root:rootPassXXX@mongo:27017
volumes:
- ./storage:/app/nocobase/storage
links:
- mongo
- postgres
ports:
- "3052:80"
init: true
extra_hosts:
- "host.docker.internal:host-gateway"
postgres:
container_name: yiask_postgres
image: pgvector/pgvector:pg17-trixie
restart: always
command: postgres -c wal_level=logical
environment:
POSTGRES_USER: postgres
POSTGRES_PASSWORD: postgres
POSTGRES_DB: mydatabase
volumes:
- ./storage/db/postgres:/var/lib/postgresql/data
mongo:
container_name: yiask_mongo
restart: always
image: docker.1ms.run/mongo:8.2
environment:
- MONGO_INITDB_ROOT_USERNAME=root
- MONGO_INITDB_ROOT_PASSWORD=rootPassXXX
volumes:
- ./storage/db/mongo:/data/db
# 若需暴露端口，可取消注释
# ports:
# - "27017:27017"
version: "3"
services:
app:
image: docker.1ms.run/chatbi/yiask:latest
container_name: yiask
environment:
- PROJECT=test
# PG元数据库的配置
- DB_HOST=postgres
- DB_DATABASE=mydatabase
- DB_USER=postgres
- DB_PASSWORD=postgres
# MONGODB的配置（未来版本会废弃）
- MONGO_URL=mongodb://root:rootPassXXX@mongo:27017
volumes:
- ./storage:/app/nocobase/storage
links:
- mongo
- postgres
ports:
- "3052:80"
init: true
extra_hosts:
- "host.docker.internal:host-gateway"
postgres:
container_name: yiask_postgres
image: docker.1ms.run/pgvector/pgvector:pg17-trixie
restart: always
command: postgres -c wal_level=logical
environment:
POSTGRES_USER: postgres
POSTGRES_PASSWORD: postgres
POSTGRES_DB: mydatabase
volumes:
- ./storage/db/postgres:/var/lib/postgresql/data
mongo:
container_name: yiask_mongo
restart: always
image: docker.1ms.run/mongo:8.2
environment:
- MONGO_INITDB_ROOT_USERNAME=root
- MONGO_INITDB_ROOT_PASSWORD=rootPassXXX
volumes:
- ./storage/db/mongo:/data/db
# 若需暴露端口，可取消注释
# ports:
# - "27017:27017"
保存文件后执行 docker compose up -d 即可启动所有依赖服务；可通过 docker compose logs -f 查看实时日志，确认服务启动成功后访问 http://<server-ip>:3052 进入系统。
默认用户名/密码为：superadmin/admin123
Info
MongoDB 仅在早期版本中用于部分存储场景，后续版本将逐步移除对 MongoDB 的依赖。
3. 配置大模型
在初次进入时，会有一个引导页面。跟随引导页面配置好大模型API连接。
4. 连接数据源
如需了解更详细的配置步骤与排查建议，可阅读《连接数据库》章节。
在控制台点击导航栏的【系统搭建】，在左侧侧边栏依次选择【数据管理】→【数据源管理】，随后点击“添加”按钮即可新建数据源。
我们准备了一份示例数据库，里面预填了一些示例数据，用以快速体验本系统使用方式。
示例数据源配置：
Info
可以通过我们提供的AI员工：表单助理Avery，通过自然语言描述数据源，自动生成连接配置。
5. 业务建模
在左侧侧边栏依次选择【数据管理】→【业务建模】，随后在标签页：“Schema列表”中，点击目录右侧的➕按钮，选择【AI建模】。 在弹出的对话窗口输入“帮我做一下建模”，我们的AI员工 Sage 会引导你完成建模任务。
6. 进行问答
点击导航栏的【智能问答】，选择默认 Agent “Alisa”，并提出业务问题，例如“销售金额”。通过实际问答来验证模型是否能够返回正确结果，如有异常再返回语义模型或数据配置进行调整。
完成以上步骤后，你就拥有了一个可服务业务团队的 Data Agent。接下来阅读“使用指南”，继续深挖数据建模、权限、AI员工配置与运维策略。
