墨台 MUOTAI

Appearance

请求链路与核心时序 ​

HTTP／智能体请求 ​

text
客户端
  -> Gateway(9999)
  -> Auth/UPMS 校验身份与租户
  -> AI Controller
  -> AgentChatServiceImpl 创建消息
  -> AgentMessageQueue
  -> CentralizedAgentMessageDispatcher(session 单线程执行器)
  -> LangGraph/Agent 节点
  -> LLM、RAG、Skill、MCP/Feign/本地工具
  -> StreamHandler / AgentResponseChannel
  -> SSE 或外部 IM

同一 sessionId 的消息必须按序执行；跨 session 才能并行。模型、工具和节点事件使用同一个 Trace 记录，失败时先写终态和日志，再关闭流。

自主规划请求进入 Agent 后会再经过一层图路由：

text
load_config
  -> intent_recognition
  -> web_search_prefetch
  -> planning
  -> agentic_loop(init/reasoning/acting/refining/checkpoint)
  -> task_end

agentic_loop 只有在规划节点返回 ACTION_EXECUTE_LOOP 时执行；简单问答可以从 web_search_prefetch 或 planning 直接到 task_end。循环中的 TOOL_EXECUTION、LENGTH、STOP 由 FinishReason 路由，暂停则在安全 checkpoint 后以 ACTION_PAUSED 结束本次图运行。不要把所有请求都假定为一次 LLM 调用，也不要把 SSE 断开当作图取消。

异步领域请求 ​

支付、计费、向量化和审计任务通常先落库，再通过 RocketMQ、定时任务或任务执行器推进状态。消费者必须以业务唯一键做幂等，状态机不允许回退到已完成状态。