Agent Server 为图提供版本化 registry、Assistant、Thread、Run、REST/SSE、队列和 Studio。本地开发模式使用内存 repository 与内嵌 Worker,无需 PostgreSQL 或 Redis。
安装并创建项目
脚手架包含图模块、lingxigraph.json、Dockerfile 与 Compose 配置。Worker 只加载清单中受信任的 import path。 启动开发服务器
- Studio:
http://localhost:8124/studio/
- REST:
http://localhost:8124/v1
- 健康检查:
http://localhost:8124/health
通过 REST 创建运行
开发模式启用了明确的不安全认证,可使用 X-Tenant-ID:复制返回的 assistant id,再创建 thread 与 run。完整流程见 Thread 与 Run API。
LINGXIGRAPH_INSECURE_DEV_AUTH=true 与 X-Tenant-ID 仅用于本机开发。生产环境必须配置 OIDC/JWT,并从已验证 token claim 派生 tenant。
使用 Docker Compose
在本仓库根目录运行:
Compose 启动 PostgreSQL 16、Redis 7.2、迁移任务和带内嵌 Worker 的 API。数据写入命名 volume。停止服务使用 docker compose down;只有确认不再需要数据时才添加 -v。
CLI 速查