Tool 是 Agent 调用 ERP 能力的唯一受控入口——可以把它理解成「AI 能按的按钮」，而不是「AI 能写的 SQL」。
实现分布在：
src/AiNativeERP.WebApi/ToolHandlers/BusinessToolHandlers.cssrc/AiNativeERP.Agent/ToolHandlers/RagToolHandlers.cs
| 用户说的话 | 更可能落到的 Tool 类型 |
|---|---|
| 「查 / 有哪些 / 多少」 | query_* / analyze_* |
| 「怎么操作 / 制度 / 流程」 | query_knowledge |
| 「创建 / 新建 / 下单」 | create_*（草稿） |
| 「批准 / 驳回」 | approve_* / workflow_approval |
所有 Tool 必须：
- 经过 ToolGateway / 权限 / 业务规则
- 写操作标记审批（
RequiresHumanApproval） - 记录审计
- 禁止万能 SQL / 任意表读写
场景对照见 user-scenarios.md。
| Tool | 说明 | 典型风险 |
|---|---|---|
query_sales_report |
销售报表 | Low |
analyze_sales_trend |
销售趋势分析 | Low |
query_sales_order |
销售订单查询 | Low |
query_customer |
客户查询 | Low |
query_quotation |
报价单查询 | Low |
create_quotation |
创建报价草稿 | Medium（需确认） |
create_sales_order |
创建销售订单草稿 | High（需确认/审批） |
approve_sales_order |
审批销售订单 | High |
approve_quotation |
审批报价单 | High |
| Tool | 说明 | 典型风险 |
|---|---|---|
query_supplier |
供应商查询 | Low |
query_purchase_order |
采购订单查询 | Low |
create_purchase_order |
创建采购订单草稿 | High |
approve_purchase_order |
审批采购订单 | High |
| Tool | 说明 | 典型风险 |
|---|---|---|
query_inventory |
库存查询 | Low |
query_stock_alert |
库存预警 | Low |
| Tool | 说明 | 典型风险 |
|---|---|---|
query_invoice |
发票查询 | Low |
query_expense |
费用查询 | Low |
query_payment |
付款/收款查询 | Low |
expense_audit |
费用审核辅助 | Medium / High |
| Tool | 说明 | 典型风险 |
|---|---|---|
query_employee |
员工查询 | Low |
query_attendance |
考勤查询 | Low |
attendance_statistics |
考勤统计 | Low |
query_salary |
薪资查询 | High |
query_leave |
请假记录查询 | Low |
| Tool | 说明 | 典型风险 |
|---|---|---|
query_bom |
BOM 查询 | Low |
query_production_order |
生产订单查询 | Low |
create_production_order |
创建生产订单草稿 | High |
manage_production_order |
生产订单状态管理 | High |
| Tool | 说明 | 典型风险 |
|---|---|---|
query_pending_approvals |
待审批列表查询 | Low |
workflow_approval |
审批流操作（销售/采购等） | High |
generate_report |
报表生成 | Low / Medium |
query_data |
受控业务数据查询（非万能 SQL） | Low / Medium |
llm_answer |
纯 LLM 回答（无业务写库） | Low |
query_knowledge |
RAG 知识检索（仅 knowledge_article） |
Low |
add_knowledge |
新增知识条目 | Medium |
| 等级 | 要求 |
|---|---|
| Low | 权限 + 审计 |
| Medium | 权限 + 审计 + 草稿确认 |
| High | 权限 + 业务规则 + 审批/确认 + 审计 |
| Critical | 多级审批 + 完整审计（付款、删除等） |
- 在 Application 层实现业务服务方法（唯一写库入口）
- 新增 Tool Handler，声明
ToolName、权限、风险、是否需审批 - 在
IntentSchemaRegistry增加对应 Schema（如需直达路由） - 注册到 DI / Tool Registry
- 补充单元测试与（如适用）域分类负样本
- 更新本文档中英文版本