more_dots/agent/README.md

Agent 模块

目录说明

agent 负责定义 Agent 运行时状态、节点逻辑与具体代理类型。

agent/
├── agents/        # 具体代理实现（ConversationAgent / ToolAgent）
├── core/          # 状态图与共享节点
├── utils.py       # Agent 通用工具函数
└── README.md

核心能力

• 统一的 SQL 工作流编排
• 多轮对话上下文维护
• 节点级状态推进与错误收集

关键流程

共享 SQL 主链路：

process_input -> normalize_input -> classify_query_mode -> match_table -> load_sql_prompt -> build_sql_plan -> generate_sql -> execute_sql -> generate_response

对话代理会在前后追加：

analyze_intent 与 update_context

文件

• core/base_agent.py：共享图注册和节点编排
• core/nodes.py：SQL 主流程节点实现
• core/state.py：AgentState 与上下文同步
• agents/conversation.py：会话型 Agent
• agents/tool.py：工具调用型 Agent