38 lines
986 B
Markdown
38 lines
986 B
Markdown
|
# 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
|