ITPub博客

首页 > 人工智能 > 人工智能 > 智能体接入业务库前的权限、日志与回滚配置清单

智能体接入业务库前的权限、日志与回滚配置清单

原创 人工智能 作者:成就数智企业 时间:2026-11-06 17:09:47 0 删除 编辑

一次版本升级之后,跑顺了两个月的审批链路突然多出一条重复单据。排查结果不是模型变了,是工具绑定的写回接口被重命名,重试逻辑把同一笔请求发了两遍。

这类故障有个共同点:上线时只验了正常路径。

下面按接入前、运行中、回滚三段列配置,尽量写到可以直接拿去做 checklist 的颗粒度。

一、接入前:权限范围必须落到行与列

不要让智能体持有高权限服务账号。执行身份从现有 IAM 取,按会话绑定真实用户,再继承该用户的组织、角色、数据范围三类约束。行列级过滤要在业务服务层生效,不能只在前端展示层做隐藏。
配置表建议至少包含这些字段:agent_id、principal_type(用户代理/系统任务)、iam_subject、role_set、row_scope_expr、column_mask、tool_allowlist、write_scope、expire_at。其中 row_scope_expr 与 column_mask 要有版本,变更走评审,不能由编排脚本临时拼。

交叉验证用两个账号:同岗位、不同区域,让智能体执行同一条查询,比对结果集条数与字段可见性。结果一致,说明行列级约束没接住,只接了登录态。

越权时返回明确的错误码,别用空结果代替。空结果会被编排层当成「没查到」,继续往下走。

二、写回接口:幂等键与事务边界

查询可以重试,写回不能裸重试。每个命令接口要带业务幂等键,建议由「业务单据类型+业务主键+操作类型+发起会话 ID」组成,服务端建唯一索引,重复请求直接返回原结果。
事务边界也要写明:智能体发起的是一条命令,服务端内部可能跨多张表。要么一次事务提交,要么用补偿任务,并在日志里记下补偿状态。超时策略要区分「已提交但响应丢失」与「未提交」,这两者的重试动作相反。
配置里容易被漏掉的是并发控制。同一张单据被两个会话同时发起写回时,需要版本号或悲观锁,否则后写覆盖先写,审计里只看到两条都成功。

三、运行中:日志字段要能还原一次完整操作

日志不是只记成功失败。建议每次工具调用落一行结构化记录,字段包含:trace_id、发起用户、agent_version、prompt_version、tool_name、参数摘要(脱敏)、目标系统、写回前后关键字段、审批人、耗时、错误码、幂等键命中与否。

保留周期按 180 天起算,导出格式用 CSV 或 JSONL,别只留在厂商内部页面。验收时让安全团队不依赖厂商,自己从导出文件还原出「某天某人让智能体做了什么」,包括那次失败的重试。

一条判定标准就够: 能还原,才算有审计。

另外把配置本身版本化:提示词、工具绑定、权限映射三类各自留版本号。升级后出问题,先 diff 这三类,多数「流程变了」的报障能在几分钟内定位,不用去翻模型日志。

四、回滚:先写脚本,再谈时间窗

回滚预案至少包含四步:钉住上一个 agent_version 与 prompt_version;把工具绑定切回旧契约;按权限映射版本恢复 row_scope_expr 与 column_mask;对升级窗口内已写回的单据按幂等键做一次盘点,列出需要补偿的记录。
时间窗要实测量出来,不要拍脑袋写「30 分钟内」。做法是在预发环境按真实数据量跑一次完整回滚,记录切配置、验权限、补数据三段各自耗时,取最大值再留一倍余量。
回归用例别只写正常路径。异常分支至少覆盖:审批驳回、单据撤回、并发写回、接口超时、权限越界、断网重连。每条用例标注预期结果与日志特征,升级前后各跑一遍,diff 结果。

五、断网与外联核查

在隔离网络里跑一条含推理、检索、调度、写回的完整任务,同时抓取进程外联清单。重点看有没有默认调用外部接口的组件、 telemetry 上报、模型服务兜底路由。断网后任务能跑完且无外联,才符合「数据不出域」的验收口径。

国产环境另按四层逐项记录版本号:芯片、操作系统、数据库、中间件。每层给兼容清单,别只验「能装能启动」。

热点问答

最小可上线的配置集是什么?

执行身份绑定真实用户、行列级过滤在服务层生效、写回接口带幂等键、日志能导出 180 天、回滚脚本在预发跑通过。这五项缺一项,先别接写回。

升级后流程变慢,先查哪里?

先 diff 提示词版本,多数步骤增加来自编排拆分变化;再看工具绑定是否换了接口;最后才看模型耗时。按这个顺序排查,比直接回滚省一次停机。

日志里要不要记模型输入输出全文?

不建议默认全记。记参数摘要与关键字段前后值即可,全文涉及业务数据,脱敏与存储成本都难控。需要排障时按 trace_id 单独开短周期采集。

来自 “ ITPUB博客 ” ,链接:https://blog.itpub.net/70035284/viewspace-3188097/ ,如需转载,请注明出处,否则将追究法律责任。

请登录后发表评论 登录
全部评论

注册时间:2023-11-14

  • 博文量
    174
  • 访问量
    214259