fix(platform): 让"工具用不了"的三种原因可区分,并消掉选端点的隐式顺序依赖
基座层面的两处缺陷,都属于"静默失败"——排查成本高,且本项目已经各踩过一次。
1. tool_executor.py 的拒绝原因原先无法区分:
- "意图压根没发布白名单"与"白名单里没这个工具"共用一句「工具不在当前意图白名单」,
运维不知道该去补发布配置、还是改白名单内容(客服与风控的意图码都要求三处对齐,
两次都因此多花排查时间);
- 权限与角色两处只说「缺少工具权限」,不说是哪一个。
现在四种情况各有独立 message,各自指向不同的处置动作。
同时把**审计与异常分离**:白名单内容、权限码、角色集属于内部配置,只写进审计;
异常 message 会随 API 响应返回给调用方,保持通用、不泄漏配置。
2. model_gateway.py 的 TASK_CAPABILITY 补齐风控的几处 task_type
(risk_agent_chat / risk_analysis / risk_script / risk_summary / daily_report_suggestion)。
它们要的都是文本生成端点;不登记就会落到"未映射 → 返回全部 active 端点"的分支,
而能否选对端点取决于 model_endpoint_config 的**行顺序**——实测风控能跑通,仅仅因为
deepseek-flash(id=3) 恰好排在 qwen-embedding(id=5) 前面。这个隐式依赖现在消掉了。
未登记的 task_type 仍退回全部端点(保持原有保守策略:让故障表现为调用失败而不是
解析为空),但会记 warning,不再静默。
新增 tests/unit/service/test_tool_executor_denials.py(4 条),锁住"四种拒绝可区分"
与"内部细节只进审计、不进 message"。
ruff / mypy(135 文件) / 607 unit+contract 全绿。
This commit is contained in:
@@ -65,16 +65,39 @@ class ToolExecutor:
|
||||
configured_tools: dict[str, tuple[str, ...]], context: RequestContext,
|
||||
) -> ToolExecution:
|
||||
definition = self.registry.get(name)
|
||||
allowed = configured_tools.get(intent, ())
|
||||
reason = None
|
||||
if name not in allowed:
|
||||
# 把三种"用不了"分开,并且**审计写详细、异常给通用**:
|
||||
#
|
||||
# 原先前两种情况共用一句"工具不在当前意图白名单",运维无法判断该去补发布配置、
|
||||
# 还是该改白名单内容——本项目已经因此踩坑两次(客服、风控的意图码都要求三处对齐,
|
||||
# 而缺配置时是静默失败关闭)。权限与角色两处也只说"缺少工具权限",不说是哪一个。
|
||||
#
|
||||
# 细节只进审计:异常 message 会随 API 响应返回给调用方,
|
||||
# 白名单内容、权限码、角色集属于内部配置,不该出现在客户可见的响应里。
|
||||
reason = ""
|
||||
detail = ""
|
||||
if intent not in configured_tools:
|
||||
reason = "该意图未配置工具白名单"
|
||||
detail = (
|
||||
f"意图 {intent!r} 在发布版本里没有任何工具白名单"
|
||||
f"(agent_tools / <agent_type>:{intent}),工具失败关闭"
|
||||
)
|
||||
elif name not in configured_tools[intent]:
|
||||
reason = "工具不在当前意图白名单"
|
||||
detail = (
|
||||
f"工具 {name!r} 不在意图 {intent!r} 的白名单 "
|
||||
f"{list(configured_tools[intent])} 内"
|
||||
)
|
||||
elif definition.required_permission not in context.permissions:
|
||||
reason = "缺少工具权限"
|
||||
detail = f"缺少权限 {definition.required_permission!r}"
|
||||
elif not set(definition.allowed_roles).intersection(context.roles):
|
||||
reason = "角色不能使用工具"
|
||||
detail = (
|
||||
f"角色 {list(context.roles)} 与工具允许的角色 "
|
||||
f"{list(definition.allowed_roles)} 无交集"
|
||||
)
|
||||
if reason:
|
||||
await self._audit(name, intent, context, "denied", reason)
|
||||
await self._audit(name, intent, context, "denied", detail)
|
||||
raise ForbiddenAgentError(reason)
|
||||
try:
|
||||
validated = definition.input_model.model_validate(arguments)
|
||||
|
||||
Reference in New Issue
Block a user