资源即工具:从 ERP API 到 function calling

xclaw-hub Connector 实现解析 · 第 3 期配图

① 资源登记(管理端)

每个 API 登记为一个资源:编码、描述、方法/端点、参数结构、风险等级。描述是写给模型看的"交接文档"。

// 资源:查询价格记录 编码: query_price_records 风险: 只读 L1 入参: org / product / price_type / range…

② 权限解析(运行时)

会话启动时计算:用户 → 实例 → 角色 → 资源。只有授权资源会进入工具清单;组织参数按授权收窄取值范围。

// org 参数自动收窄 "org": { "enum": ["华东集团"] } // 模型无法填未授权组织

③ 工具注入(模型协议)

授权资源投影为 function calling 工具清单,技能文档拼入系统提示词,Agent "原生"具备 ERP 能力。

tools: [ yonyou_query_orgs, yonyou_query_materials, yonyou_query_price_records ]

一次工具调用的生命周期

1

会话绑定实例

用户在对话中选择要使用的连接实例。

2

权限解析

用户→角色→资源,工具列表是权限计算的产物。

3

模型发起调用

按技能文档自主多步编排,无需人工逐步指令。

4

执行器路由

内置 Provider 直调,或适配器进程转发到业务系统。

5

结果回填 + 审计

结果回给模型,调用写入审计日志(失败全量、成功采样)。

工具列表是权限计算的产物,不是配置的罗列。