Docker Demo · 百灵中枢开发者文档

quickstart

docker compose up --build

# 控制台
http://localhost:18900/console/

# Demo 业务系统
http://localhost:19080/

全新服务器一键安装

如果是在一台新的 Ubuntu/Debian 服务器上快速体验，可以用安装脚本自动完成 Docker 安装、开源分发包下载、.env 生成、启动和 smoke 验证。脚本不会覆盖已有 .env，生成的后台密码会在结束时打印。

one-line install

curl -fsSL https://www.bailinghub.com/install.sh | sh

透明 Docker Compose 仍是推荐主路径。一键脚本只是把标准流程自动化，默认下载 /connect/bailing-ai-source.tgz；源码见仓库 scripts/install.sh。

中枢服务

bailing-ai 提供控制台、/run、任务追踪、审批账本、工具治理和 smoke 验证。

状态库

mysql 保存配置、任务、trace、审批、限速、预算和运行期租约。

Demo 业务系统

demo-business 暴露订单、工单、退款和故障排障工具，并承接业务侧审批意图。

确定性 Agent

demo-agent 不调用外部 LLM，但完整走中枢工具运行面，适合开源首体验。

默认账号与接入方

控制台	`admin / bailing-demo-admin`
接入方	`demo-app`
接入方 token	`bailing-demo-client-token`
触发路由	`demo_support`

正常工具调用

POST/run

curl -sS http://localhost:18900/run \
  -H 'content-type: application/json' \
  -H 'authorization: Bearer bailing-demo-client-token' \
  -d '{
    "request_id": "demo-001",
    "route": "demo_support",
    "source": "quickstart",
    "input": "帮我查一下订单 SO-1001 的状态，并创建一个售后工单说明需要人工跟进",
    "metadata": {
      "visitor_uid": "visitor-001",
      "operator_uid": "demo-user-001"
    }
  }'

业务侧审批闭环

发起退款诉求后，中枢会冻结高风险工具调用快照，并把审批意图签名投递到 demo 业务系统。打开 http://localhost:19080/，在“业务侧审批意图”里直接点击批准或拒绝，demo 业务系统会回调中枢 /approvals/{approval_id}/decision。

POST/run

curl -sS http://localhost:18900/run \
  -H 'content-type: application/json' \
  -H 'authorization: Bearer bailing-demo-client-token' \
  -d '{
    "request_id": "demo-refund-001",
    "route": "demo_support",
    "source": "quickstart",
    "input": "帮 SO-1001 申请退款 199 元",
    "metadata": {
      "visitor_uid": "visitor-001",
      "operator_uid": "demo-user-001"
    }
  }'

故障排障演示

demo_failure_probe 会固定返回 500。控制台「任务」里可以查看 trace，确认请求、响应、错误正文和排障包脱敏结果。

POST/run

curl -sS http://localhost:18900/run \
  -H 'content-type: application/json' \
  -H 'authorization: Bearer bailing-demo-client-token' \
  -d '{
    "request_id": "demo-failure-001",
    "route": "demo_support",
    "source": "quickstart",
    "input": "演示一次业务工具失败排障",
    "metadata": {
      "visitor_uid": "visitor-001",
      "operator_uid": "demo-user-001"
    }
	  }'

Docker 拉取排障

如果新服务器卡在 mysql:8.4 或 node:22-bookworm-slim 拉取，通常是 Docker Hub 网络问题。给 Docker 配置当前环境可访问的 registry mirror 后重试。

registry mirror

sudo mkdir -p /etc/docker
sudo tee /etc/docker/daemon.json >/dev/null <<'JSON'
{
  "registry-mirrors": [
    "https://mirror.ccs.tencentyun.com"
  ]
}
JSON
sudo systemctl restart docker
docker compose up -d --build

一键 smoke

smoke

docker compose exec bailing-ai npm run smoke

完整端到端自测

demo:e2e 会自动验证查单、建工单、退款审批、业务侧批准、退款落业务系统和故障排障链路。

demo-e2e

docker compose exec bailing-ai npm run demo:e2e