SuperAPI AI 工具集

mindtickle-sdk-patterns

智能体与模型

查看项目

更新于 10-15 23:27

技能介绍

用途:把一份经授权的租户 API 契约转化为范围明确的适配器,包含显式操作、校验、重试、租户隔离与证据留存,不虚构 SDK 或路由。

前提:具备带来源、允许操作与数据分类的版本化租户 API 资料;确认认证、环境、容量、支持与变更通知契约;测试夹具不含生产密钥或学员 PII。

当前契约:公开 Mindtickle 资料确认存在基于 REST 的 Content、User 与 Reporting API,但未定义通用公开 SDK、基础 URL、路由集或凭据头。应以租户资料为可执行权威,并记录其摘要与有效期。

认证:通过批准的运行时密钥提供方注入凭据,将配置绑定到单一租户与环境,脱敏请求日志;当租户、主机或凭据来源不明确时拒绝启动。

主要步骤:仅盘点业务工作流所需的已记录操作并分类读写、幂等与隐私属性;冻结来源摘要、租户、环境、认证方案、模式、分页、错误与容量信号;在产品专属接口后生成或手写内部传输类型,避免厂商载荷泄漏进领域逻辑;在边界校验请求与响应,拒绝未记录字段或状态假设;仅对已记录的瞬时条件做有界重试,写入需幂等或对账;为成功、授权失败、校验失败、分页、限流信号、超时歧义与模式漂移添加夹具;首次租户写入前生成变更预览并需审批;记录契约摘要、测试结果、已部署适配器版本与回滚兼容性。

边界:不得逆向租户流量、抓取已认证 UI、发布机密 API 资料、添加未记录操作,或在无资源所有者批准下执行写入。

错误处理:运行时响应违反契约时隔离载荷、停止写入并开启契约澄清;写入超时歧义时先通过已记录读取或支持回执对账再重试;仅有营销文档时产出接口提案与厂商问题,不实现网络调用。

输出:契约清单与摘要、适配器边界、认证与租户控制、夹具覆盖、重试/对账策略、变更预览与回滚计划。

限制:公开资料未提供通用 SDK、基础 URL、路由集或凭据头,具体实现细节需以租户授权资料为准;其余平台、收费与效果信息暂未提供。