用途:当用户询问如何让 SaaS 产品具备“agent-usable”能力时使用本技能。它把产品能力重构为稳定的执行模型,而非零散接口。
架构分三层:连接器层负责认证与事件管道(OAuth/API key、webhook 摄取、身份映射、可选 SCIM);工具层定义六种可复用工具形状——Search(定位实体与关系)、Summarize(带引用的结构化要点)、Draft(生成可提交草稿但不自动发送)、Update(有界、幂等的写回)、Notify(通知负责人/关注者/审批者)、Approve(高风险操作的人工门控);策略层覆盖 RBAC、预算、速率限制、PII 控制、日志与重试。设计原则是优先可预测、可审计、可回滚的操作。
使用方式:先界定目标 SaaS 领域与实体(如工单、联系人、问题、页面、交易、订单),标出高风险动作(付款、删除、对外发布、权限变更)与成功目标;再设计三层架构;然后把能力映射到六种工具形状;接着补充强制护栏——明确错误分类(401、403、404、空结果、冲突、超时)、变更操作的幂等键、Update 的字段允许列表、Summarize 的引用要求、面向用户输出的 dry-run 与仅草稿默认值、高风险类别的审批门,以及完整审计轨迹(谁请求、谁批准、改了什么、何时、结果)。
交付物结构:领域范围与实体、三层架构、六工具契约表、护栏设计、端到端示例流程、分批上线计划(0-30、31-90、90+ 天)、KPI 表与最大未决风险。KPI 至少包含任务完成率、首次调用成功率、API 成功率、p95 延迟、集成前置时间与单位结果成本。
适用场景:客服分流与回复、销售跟进自动化、需审批门控外部更新的故障助手等。
限制:资料中未提供具体价格、平台绑定或效果数据;工具契约函数模板、审批与审计 schema、工作流模式示例需查阅技能内 references/tool-contracts.md、references/approval-and-audit.md 与 references/workflow-patterns.md。