
`tool.completed` 不等于业务动作已完成。本文用一个需要确认的写工具说明事件、权限和业务回执的最小接线。

在 AI 助手里，`tool.completed` 不是“业务动作已完成”的同义词。要让一次创建工单、提交采购申请或发送通知可追溯，应用需要把四种事件串起来：工具提议、权限决定、工具生命周期和业务系统回执。下面用一个需要用户确认的写工具说明最小接线边界。

## 先定义审计链的四个锚点

1. `tool.proposed`：记录工具名、`toolCallId` 和经过筛选的参数摘要，回答模型准备做什么。
2. `tool.permission.decided`：记录 `allow`、`deny` 或 `ask`，以及 `decisionSource`；它回答为什么放行或拒绝。
3. `tool.started`、`tool.completed`、`tool.failed`：记录是否真正进入 handler、耗时和错误类型。
4. 业务回执：由 handler 调用的业务服务返回 `businessRequestId`、状态和查询入口，回答外部系统到底发生了什么。

第一到第三项来自运行链，第四项必须由业务服务提供。不要用模型最后一句话代替第四项。

## 让权限决定进入自己的审计出口

下面是接线示意，省略模型客户端、真实业务服务和 UI；它展示责任边界，不是复制即上线的完整教程：

~~~ts
const createTicket = defineTool({
  name: 'create_ticket',
  description: '创建当前用户有权提交的工单',
  readOnly: false,
  parameters: {
    title: { type: 'string' },
    priority: { type: 'string' }
  },
  handler: async (args) => ticketService.create({
    tenantId: auth.tenantId,
    userId: auth.userId,
    idempotencyKey: requestContext.idempotencyKey,
    ...args
  })
});

const session = await createSession({
  client,
  tools: { custom: [createTicket] },
  permission: {
    rules: { ask: ['create_ticket'] },
    askUser: async (call) => ui.confirm(call.name)
  },
  onDecision: (record) => audit.write({
    ...record,
    userId: auth.userId,
    tenantId: auth.tenantId
  })
});
~~~

这里的 `onDecision` 只接住权限决定；它不能替代业务回执。审计表还应在 handler 开始、结束或失败时补运行状态，并在业务服务返回后写入 `businessRequestId` 和权威状态。参数是否完整落盘由应用按敏感级别决定，不能把令牌、客户资料或完整请求体无条件写进审计日志。

## 权限决定的三种结果不能混成一个布尔值

`allow` 表示这次调用通过权限判断，`deny` 表示被拒绝，`ask` 表示需要确认或进入询问面。没有接入 `askUser` 时，涉及确认的调用可能按 fail-closed 被拒绝；应用应把这个结果显示为“需要确认/策略拒绝”，而不是空数据。`decisionSource` 能帮助排查是用户、规则、模式、策略还是钩子做出的决定；`matchedRule` 若存在，也可以用于管理者复盘。

`createSessionView` 适合把这些会话事件投影成工具卡、确认提示和错误状态，但它不替应用保存审计数据库。页面要同时显示工具状态和业务状态：工具完成后仍要查询业务请求号，才能决定显示“已受理”“处理中”还是“结果未知”。

## 超时后先查回执，再决定重试

业务写工具至少需要一个稳定请求号。调用超时可分成三类：尚未提交、已受理但未返回、已经有明确结果。应用先按请求号查询业务系统；只有确认未受理且业务接口允许重试时，才重新提交。SDK 的会话事件可以帮助你标记运行阶段，去重和补偿仍属于业务服务。

## 什么时候采用这条链

它适合 Node.js 或 Electron 应用中同时存在多轮任务、需要用户确认的工具和可查询的业务回执。Tansr 可以组织工具、权限和会话事件，把决定通过 `onDecision` 暴露给应用；应用仍负责身份、租户、幂等、审计存储和数据脱敏。一次固定查询或已经具备完整审计链的运行框架，不需要为了增加一条事件而迁移。

最小验收包括：允许、拒绝、等待确认各跑一次；确认工具开始和完成事件可见；超时后能按业务请求号查到最终状态；审计记录不会泄露参数中的敏感字段。完成这些检查后，再决定是否扩大写工具范围。

接口依据见 Tansr 的[PermissionOptions](https://docs.tansr.com/sdk/api/interfaces/permissionoptions/)、[PermissionRules](https://docs.tansr.com/sdk/api/interfaces/permissionrules/)、[会话与事件流](https://docs.tansr.com/sdk/sessions-and-events/)和[createSession](https://docs.tansr.com/sdk/api/functions/createsession/)。

示意代码省略真实模型和业务服务；上线前必须在自己的 Node.js 或 Electron 宿主中验证。


tool.completed 不等于业务动作已完成。本文用一个需要确认的写工具说明事件、权限和业务回执的最小接线。

企业 AI 工具调用审计：PermissionOptions、事件和业务回执如何分工

记录工具提议、权限决定、执行过程和业务回执，说明 Tansr 运行层与企业审计责任的分工。

前端

tool.completed不等于业务完成，需将工具提议、权限决定、生命周期及业务回执四类事件串联，实现写操作的可追溯性。通过onDecision记录权限结果，以业务请求号查询权威状态，区分允许、拒绝、等待确认及超时场景，确保审计日志不泄露敏感参数，并满足最小验收标准。

数据脱敏

数据库

文章

问答

视频

教程

学习中心

腾讯云实验室

直播

竞赛

腾讯云代码分析专区

腾讯iOA零信任安全管理系统专区

腾讯云架构师技术同盟交流圈

腾讯云数据库专区

腾讯云智能顾问专区

腾讯云原生专区

腾讯混元专区

腾讯云TCE专区

腾讯云Lighthouse专区

腾讯云HAI专区

腾讯云Edgeone专区

腾讯云存储专区

腾讯云智能专区

腾讯轻联专区 

腾讯云开发专区

TAPD专区

腾讯轻量云游戏服专区

EdgeOne AI 安全实战专区

腾讯云最具价值专家

腾讯云架构师技术同盟

腾讯云创作之星

腾讯云开发者先锋

腾讯云代码助手

云原生构建

TAPD 敏捷项目管理

Cloud Studio

SDK中心

API中心

命令行工具

涵盖代码开发、场景应用、自动测试全流程，助你从零构建专属AI助手

一站式MCP教程库，解锁AI应用新玩法

聚焦“写作效率、视觉美观与运行性能”三方面进行全面升级，为您提供更高效、稳定的创作环境

社区富文本&Markdown编辑器全新改版上线，欢迎大家体验!

诚挚邀请您参与本次调研，分享您的真实使用感受与建议。您的反馈至关重要，感谢您的支持与参与！

社区新版编辑器体验调研

企业 AI 工具调用审计：PermissionOptions、事件和业务回执如何分工-腾讯云开发者社区-腾讯云

企业 AI 工具调用审计：PermissionOptions、事件和业务回执如何分工

企业 AI 工具调用审计：PermissionOptions、事件和业务回执如何分工

社区

活动

圈层

关于

腾讯云开发者

热门产品

热门推荐

更多推荐