Aster Studio 是一个内置的 Web 控制台,提供实时监控、事件流查看、Agent 管理等功能。
# 构建前端
cd studio
npm install
npm run build
# 复制前端资源
cp -r dist ../server/studio/
# 构建带 Studio 的服务端
cd ..
go build -tags studio -o aster-server-studio ./cmd/aster-server
# 使用默认 JSON 存储
PORT=3032 ./aster-server-studio
# 使用 MySQL 存储
ASTER_STORE_TYPE=mysql \
ASTER_MYSQL_DSN="root:root@tcp(localhost:3306)/aster?charset=utf8mb4&parseTime=True&loc=Local" \
PORT=3032 ./aster-server-studio
# 使用 Redis 存储
ASTER_STORE_TYPE=redis \
ASTER_REDIS_ADDR="localhost:6379" \
PORT=3032 ./aster-server-studio
打开浏览器访问 http://localhost:3032/studio
Aster Studio 支持三种存储后端:
适合开发和测试环境,数据存储在本地文件系统。
ASTER_DATA_DIR=.data ./aster-server-studio
适合生产环境,支持持久化和多实例部署。
# 环境变量
ASTER_STORE_TYPE=mysql
ASTER_MYSQL_DSN="user:password@tcp(host:port)/database?charset=utf8mb4&parseTime=True&loc=Local"
# 可选配置
ASTER_MYSQL_MAX_OPEN_CONNS=25
ASTER_MYSQL_MAX_IDLE_CONNS=10
自动创建的表:
agent_infos - Agent 元信息agent_messages - 消息历史agent_snapshots - 快照agent_todos - Todo 列表agent_tool_records - 工具调用记录aster_collections - 通用 KV 存储适合需要高性能缓存的场景。
# 环境变量
ASTER_STORE_TYPE=redis
ASTER_REDIS_ADDR=localhost:6379
ASTER_REDIS_PASSWORD=
ASTER_REDIS_DB=0
ASTER_REDIS_PREFIX=aster: