SuperAPI AI 工具集

17-ai-agent-action-catalogue-spec

智能体与模型

查看项目

更新于 10-16 03:40

技能介绍

用途 本技能用于定义 AI 智能体可调用的、受模式约束的工具集合,即「AI 智能体动作目录」。当智能体动作目录是当前生命周期应交付的下一项产物,且所需源材料齐备时使用。若相邻路线 ai-agent-feature-prd-spec 才拥有该决策或交付物,则不应使用本技能;缺失的项目证据、标准条款、阈值或干系人决策不得臆造。

主要能力 动作目录是智能体可调用工具的唯一事实来源:规划器只能发出目录中出现的工具调用,调度器拒绝任何不在目录中的调用。工作流包括:盘点候选工具(含读、写、外部 API 与内部 RPC);按可逆性分类为 idempotent(幂等,如读 API、查找、搜索)、compensable(可补偿,如发退款可用重新扣款逆转、建草稿可用删草稿逆转)、irreversible(不可逆,如向客户发邮件、扣卡、删文件、公开发布、执行交易);声明模式与副作用类别(read、write-internal、write-external、billing、network-egress);声明按层级的可用性(free/pro/enterprise 与 L0-L3 自主级别);声明审计字段;声明限流类别;声明终止开关行为;最终写出 Action_Catalogue_Spec.md。

使用方式 目录条目需给出 name、description、input_schema、output_schema、side_effect_class、reversibility_class、compensating_tool。审计需记录 tenant_id、user_id、agent_run_id、plan_id、step_index、tool_name、脱敏输入输出、latency_ms、cost_usd、outcome、调用时可逆性快照、适用时的人工审批事件 ID。限流类别分 cheap-read(60/min,每运行 100,突发 20)、expensive-read(10/min,20,5)、internal-write(30/min,50,10)、external-write(5/min,10,2)、billing(2/min,5,1)。终止开关方面,全部写操作受全局开关拒绝,廉价读不受;每租户开关亦需声明及用户可见提示。

适用场景与限制 适用于智能体运行时、安全、评估与运维团队共享契约。副作用类别非 read 的工具不得在 Free 层可用。变更需 PR + ADR + 合并前红队冒烟。引用 OWASP LLM 与 Agentic 2026 编号、Anthropic 工具使用指南、NIST AI RMF MEASURE-2、ISO/IEC 42001 第 8 条。涉及 SOC 2、ISO 27001、HIPAA 时需附加 phi_touch、cardholder_touch、protected_class_decision、evidence_class、retention_minimum 元数据。必需源文件、责任人、标准源、渲染器或执行能力缺失时,返回最窄的合格结果并标记该项检查未评估,绝不将未评估转为通过。能力边界上,读取与搜索为必需,编辑仅在请求授权创建或修复指定需求产物时允许,发布、生产变更、破坏性操作、支出与认证需明确授权。