Gateway 逻辑路由：一个 HTTP 入口，多个 Agent 后端
logic.json 如何按路径、方法与 Header 将请求路由到工作流、记忆库或外部 API——无需为每个新 Agent 重新部署 Gateway。
为何需要逻辑路由
Agent 产品很快会超出单一 /chat 端点：需要 webhook、工具回调、按客户分路径、A/B 后端——却共用同一 TLS 域名与 API Key 面。Engra Gateway 将物理部署与逻辑路由规则分离。
路由在 logic.json 中声明并按请求求值；Gateway 概览 说明 Gateway 如何绑定到项目。
路由匹配什么
每条路由可匹配： • HTTP 路径（前缀或精确） • 方法（GET、POST 等） • Header 条件（API 版本、租户 ID） • JSON 请求体的可选形状提示
除非显式定义优先级，否则先匹配先生效。高流量公开路由放在文件靠前位置以降低延迟波动。
流量去向
目标包括： • 内联工作流步骤（转换、校验、扇出） • 经 Gateway 绑定的记忆操作（唤醒、搜索、保存） • 注入鉴权的上游 HTTP 代理 • 健康检查与元数据的静态响应
生产环境常用模式见 路由示例。
运维建议
logic.json 纳入 git 版本管理。按环境（预发 / 生产）使用独立 Gateway，避免路由实验与线上流量共用 API Key。