Add Cloud Tour Libo knowledge graph platform

docs/DEPLOYMENT.md

@@ -148,6 +148,11 @@ LLM_API_BASE=你的OpenAI兼容模型地址
 LLM_API_KEY=你的模型Key
 ```
 
+部署后也可以在后台 `系统 -> Agent 设置` 中配置：
+
+- `全局 LLM 配置`：填写 OpenAI 兼容模型地址、模型 ID、LLM API Key。
+- `外部图谱问答 API`：位于页面底部，维护给其他系统调用的 `X-KG-API-Key`，设置默认图谱、默认 LLM 策略和“问答环节 LLM 模型”。该模型优先用于外部客服问答，留空则继承全局 LLM。
+
 | 变量 | 说明 |
 | --- | --- |
 | `POSTGRES_USER`、`POSTGRES_PASSWORD`、`POSTGRES_DB` | PostgreSQL 容器账号、密码、库名 |
@@ -173,33 +178,41 @@ LLM_API_KEY=你的模型Key
 给外部系统对接时，只开放这个接口即可：
 
 ```text
-POST http://8.163.40.99:8102/v1/admin/travel/customer-service-query
+POST http://8.163.40.99:8102/v1/openapi/knowledge-qa/query
 ```
 
+`/v1/admin/travel/customer-service-query` 会继续保留为兼容旧调用，新接入的第三方系统建议统一使用 `/v1/openapi/knowledge-qa/query`。
+
 服务器安全组需要放行 TCP `8102`。如果服务器本机 `curl http://127.0.0.1:8102/v1/admin/health` 正常，但外部访问 `http://8.163.40.99:8102` 超时，优先检查云控制台安全组/防火墙入方向规则。
 不要把 `5433`、`6380`、`3002` 暴露到公网；默认 Compose 已把这些数据端口绑定到 `127.0.0.1`。
+生产环境必须在后台 `外部图谱问答 API` 或环境变量 `INGEST_API_KEYS` 中配置至少一个接口 Key；未配置时，对外问答接口会返回 `503`，避免无鉴权开放。
+接口 Key 是给第三方系统调用本接口用的访问凭证；问答环节 LLM 的 API Key 是本系统调用大模型用的凭证，两者不要混用。
 
 请求示例：
 
 ```bash
-curl http://8.163.40.99:8102/v1/admin/travel/customer-service-query \
+curl http://8.163.40.99:8102/v1/openapi/knowledge-qa/query \
   -H 'Content-Type: application/json' \
   -H 'X-KG-API-Key: 你的INGEST_API_KEYS之一' \
   -d '{
+    "request_id": "crm-msg-20260610-0001",
     "question": "黄小西三日游多少钱？",
-    "knowledge_graph": "百姓惠",
+    "graph_name": "baixinghui_travel_agency",
     "session_id": "demo-001",
+    "channel": "online_service",
     "use_llm": true,
     "llm_fusion": true
   }'
 ```
 
-`llm_fusion=true` 需要配置 `LLM_API_BASE` 和 `LLM_API_KEY`。未配置 key 时，接口仍会返回图谱模板答案，但不会调用 LLM 融合。
+默认问答链路需要配置问答环节 LLM；可在后台 `外部图谱问答 API -> 问答环节 LLM 模型` 单独配置，也可以继承全局 LLM。
 
 主要返回字段：
 
 | 字段 | 说明 |
 | --- | --- |
+| `request_id` | 外部请求 ID，原样回传或由服务端生成 |
+| `trace_id` | 服务端链路追踪 ID |
 | `answer` | 给外部系统展示的完整回答 |
 | `customer_reply` | 可以直接发给客户的话术 |
 | `follow_up_questions` | 建议追问 |