用途:为支持智能体(基于 Mastra 的 Agent)定义可执行工具,即智能体的“手”。每个工具包含参数、审批要求与执行逻辑,用于新增退款处理、许可证转移、知识查询等动作。
主要能力:提供 createTool 工厂模式,用 Zod 定义参数;requiresApproval 可按上下文动态判断是否需要人工批准;execute 中通过 getApp 读取应用配置(5 分钟 TTL 缓存),经 Stripe Connect 发起退款,经 IntegrationClient 以签名请求撤销访问权限。标准工具包括 lookup_user(查询用户与购买记录,永不需批准)、process_refund(超过 30 天需批准)、generate_magic_link、transfer_purchase(超过 14 天需批准)、draft_response、escalate_to_human。权限分三档:自动批准(30 天内退款、14 天内转移、魔法链接、密码重置、邮箱/姓名更新)、需批准(30-45 天退款、14 天后转移、批量席位管理、账户删除)、必须升级(愤怒客户、法律措辞、反复失败、不确定情况)。
使用方式:在 packages/core/src/agent/config.ts 绑定工具,工具实现放在 packages/core/src/tools/,工厂在 create-tool.ts,应用配置查询在 services/app-registry.ts,SDK 调用在 packages/sdk/src/client.ts。执行逻辑中应抛出错误而非返回 {success:false},由 createTool 包装器统一生成 {success:true,data:...} 或 {success:false,error:{code:'EXECUTION_ERROR',message:'...'}}。
限制:资料未提供安装命令、收费与价格、支持平台等细节;具体实现依赖 Skill Recordings 内部包与 Stripe、Front、Slack 等外部服务。