跳转到主要内容
Agent Server 为图提供版本化 registry、Assistant、Thread、Run、REST/SSE、队列和 Studio。本地开发模式使用内存 repository 与内嵌 Worker,无需 PostgreSQL 或 Redis。
1

安装并创建项目

脚手架包含图模块、lingxigraph.json、Dockerfile 与 Compose 配置。Worker 只加载清单中受信任的 import path。
2

启动开发服务器

  • Studio:http://localhost:8124/studio/
  • REST:http://localhost:8124/v1
  • 健康检查:http://localhost:8124/health
3

通过 REST 创建运行

开发模式启用了明确的不安全认证,可使用 X-Tenant-ID
复制返回的 assistant id,再创建 thread 与 run。完整流程见 Thread 与 Run API
LINGXIGRAPH_INSECURE_DEV_AUTH=trueX-Tenant-ID 仅用于本机开发。生产环境必须配置 OIDC/JWT,并从已验证 token claim 派生 tenant。

使用 Docker Compose

在本仓库根目录运行:
Compose 启动 PostgreSQL 16、Redis 7.2、迁移任务和带内嵌 Worker 的 API。数据写入命名 volume。停止服务使用 docker compose down;只有确认不再需要数据时才添加 -v

CLI 速查