图_13Agent与工具运行时
原生 Excalidraw 可编辑画布，基于 SuperMew-0.1.0。请使用 Obsidian 的 Excalidraw 视图打开。
所属模块： M4 Agent 与工具运行时。总图与详图使用相同模块编号；画布右侧也包含以下读图说明。
运行时
- MODEL 与 System Prompt 创建外层 Agent；绑定天气工具和请求专属知识工具。
流程
- MODEL 可直接回复，或发出 tool call；结果作为 ToolMessage 回到模型。
- 知识工具申请 ctx 一次额度，运行 RAG，并保存 Trace/恢复快照。
- service 对 HITL 结果改为澄清提示。
约束
- 知识调用次数有硬额度；收到知识结果后不再调工具主要由提示词约束。
- FAST/GRADE 分别用于笔记/规划/改写与评分，不是外层 Agent 的重复回路。
源码对应
backend/chat/runtime.py：create_agent_for_request()backend/tools/knowledge.py：make_search_knowledge_base()backend/tools/weather.py：get_current_weather()
Excalidraw Data
Text Elements
13 Agent 与工具运行时 ^065fab4c
M4 决定调用工具和生成答案；M5 返回证据/控制状态，M3 负责跨轮编排。 ^ea0fb7db
M4 Agent 与工具运行时 · 对应总图 01 ^3ff9e82c
M3 输入 上下文 messages + 本请求 ctx ^decafcd8
create_agent_for_request(ctx) 绑定 MODEL / System Prompt 天气工具 + 请求专属知识工具 ^145dc49d
MODEL 选择 直接回复 / tool call ^683d5cf0
get_current_weather 请求高德 API / 校验与异常文本 ^7dd606b5
search_knowledge_base ctx.acquire_knowledge_tool_slot 每轮最多一次 ^fe53b095
再次调用：直接返回 TOOL_CALL_LIMIT_REACHED ^fb514e33
M5 run_rag_graph(query, ctx) 检索与评分 / 必要时一次改写或子问题 ctx 保存 Trace + 可选恢复快照 ^e3b34e0b
工具输出 ToolMessage 编号证据 / NO_KNOWLEDGE 或 NEEDS_CLARIFICATION / SCOPE_SELECTION ^b087b67b
外层最终回复 → 交给 M3 有工具时，MODEL 基于 ToolMessage 回答 M3 负责 Trace / HITL 覆盖 / 保存 / SSE ^4f943893
不需要工具：直接给出 AI 内容 ^39427c17
知识额度由代码硬控制；收到知识工具结果后停止其他工具调用主要由 System Prompt 约束。 ^739bbb4f
读图说明 · M4 Agent 与工具运行时 ^3c51aaf4
运行时 ^06dc0da9
• MODEL 与 System Prompt 创建外层 Agent；绑 定天气工具和请求专属知识工具。 ^a4c37bef
流程 ^72807773
• MODEL 可直接回复，或发出 tool call；结果作 为 ToolMessage 回到模型。 ^3a26a4cf
• 知识工具申请 ctx 一次额度，运行 RAG，并保 存 Trace/恢复快照。 ^139ba69a
• service 对 HITL 结果改为澄清提示。 ^41e40d8c
约束 ^88fc0d5a
• 知识调用次数有硬额度；收到知识结果后不再调 工具主要由提示词约束。 ^fa4b277e
• FAST/GRADE 分别用于笔记/规划/改写与评分， 不是外层 Agent 的重复回路。 ^fb4aab3d
Element Links
3ff9e82c: [[图_1项目设计]]
%%
Drawing
1 | N4IgLgngDgpiBcIYA8DGBDANgSwCYCd0B3EAGhADcZ8BnbAewDsEAmcm+gV31TkQAswYKDXgB6MSgw4CxAHSp6AWzJJMMJTEZgaCANqg8CELnQBOXDADMABnSrIsY/hiow6RgHN1q5AgCMZgBsNuQQAQDsoSBEeGD8CACsLNH8MNiegkmJ/uQe3nzRNGD49ADWMADC9Jj0+MYAxKgARriJMP6qzeioZZ6lnIy41bX1iA0AZgAcE+gTqKoT2JiYAM |
%%
