用途:为 commerce 参考智能体定义在代码层强制执行的信任与安全规则,覆盖第三方内容、写入、接地、身份与记忆,规则与文档 docs/safety.md 一致,三条路径共享同一执行器。
主要能力:工具返回的目录、评论、政策、订单、指标、消息或网页内容统一经 Fence.fence_payload 处理,做 NFKC 归一化、去不可见与控制字符、替换围栏标记与伪造轮次标记,并按角色标签包裹、按 max_fenced_chars 截断;模型给出的结果数量经 clamp_limit 限制到 max_search_results。写入按溯源与上限把关:购物车只接受会话中已见商品,商户暂存只接受已见列表与变更,并有 max_quantity_per_item 与 max_cart_lines;溯源存于会话状态并受 PROVENANCE_CAP 限制,两角色均不对商品计价或下单,结账仅渲染购物车。涉及数字或术语的问题由 GROUNDING_RULES 先走对应读取,Messages API 运行时用 tool_choice 强制,SDK 运行时预取,托管路径仅有提示。身份由服务端绑定:会话开始把已认证主体绑到不可猜测的会话 id,后续请求只携带该 id,工具参数不命名用户或商户。记忆写入经 validate_fact 校验,受 MemoryWriteFilter、memory_retention_days、MemoryStore 删除与清空控制。
使用方式:按资料中的模块路径调用,如 commerce_common/fencing.py、commerce_common/execution.py、各角色的 gates.py、grounding.py、config.py 及 commerce_common/memory.py;被拦截的调用返回标注 gate 的正常结果,失败返回错误结果,execute 不抛出异常。工具列表由配置决定,enable_web_search 默认关闭。
适用场景:需要在参考智能体中统一实施内容围栏、写入溯源、接地、身份与记忆约束的场景。
限制:资料未提供安装命令、收费、价格、具体部署步骤与效果数据;词表与开关由部署方按配置追加,托管路径仅有提示而无强制;MCP 参考服务器默认仅绑定回环,除非有认证网关前置。评测方面,被投毒的列表、评论与消息存于评测夹具,每条拒绝用例在同一细分场景有对应应服务用例。