部署

本机跑 Studio，或挂反向代理。

部署

Near 默认是本机 agx serve。远程 / 高可用是额外路径，不是产品默认。没有 agenticx.server:app 模块——FastAPI 应用是 agenticx.studio.server 里的 create_studio_app()。

示意图：客户端打 agx serve；Nginx 可选；状态留在 ~/.agenticx。

本机 API

bash

1agx serve --host 127.0.0.1 --port 8000
2# Desktop 托管启动还会写 ~/.agenticx/serve.port 和 serve.token

参数	默认	说明
`--host`	`0.0.0.0`	笔记本上建议 `127.0.0.1`
`--port`	`8000`	Near 可能用随机端口并落盘
`--token`	空	写入 `AGX_DESKTOP_TOKEN`
`--reload`	false	仅开发

agx studio 是终端 REPL，不是这套 HTTP 进程。

Docker（示例）

deploy/ 下有 Compose（docker-compose.minimal.yml、docker-compose.core.yml、docker-compose.yml）。需要把 Postgres / Redis 和 Studio 放一起时再用。笔记本跑 Near 不必上这套。

dockerfile

1FROM python:3.11-slim
2WORKDIR /app
3RUN pip install agenticx
4EXPOSE 8000
5CMD ["agx", "serve", "--host", "0.0.0.0", "--port", "8000"]

bash

1docker compose -f deploy/docker-compose.minimal.yml up

反向代理

SSE 需要 HTTP/1.1 和升级连接。代理要指到实际 Studio 端口（见 ~/.agenticx/serve.port）。

nginx

1location / {
2    proxy_pass http://127.0.0.1:8000;
3    proxy_http_version 1.1;
4    proxy_set_header Upgrade $http_upgrade;
5    proxy_set_header Connection "upgrade";
6    proxy_set_header Host $host;
7    proxy_buffering off;
8}

探测

bash

1curl --noproxy '*' http://127.0.0.1:8000/api/health
2# {"status":"ok"}

供应商健康是 GET /api/health/providers，设置了桌面令牌时必须带上。

本页不是什么

Enterprise Go 网关（独立进程，OpenAI 兼容中继）
集群 Agent Runtime（规划中）
uvicorn agenticx.server:app --workers N（该模块不存在）

见 Studio、配置、CLI。