用途:在 AgentKit 正式上线(go-live)前完成核查记录,逐项标记 PASS 或 WAIVE 并附一行原因,记录不完整不得签核。
主要能力与步骤:
- 建立核查记录,每个项目一行,列为 item、result(PASS/WAIVE)、reason(WAIVE 必填)。
- 快速检查:确认 SCALEKIT_ENVIRONMENT_URL 以 https://<子域>.scalekit.com 结尾、SCALEKIT_CLIENT_ID 与 SCALEKIT_CLIENT_SECRET 已设置、token 端点返回 200、所有认证端点走 HTTPS、源码中无硬编码密钥(可用 grep 搜索 skc_ 前缀),并核对 Dashboard→AgentKit→Connections 的回调 URI 与提供方 OAuth 应用一致。
- OAuth 与令牌流程:授权 URL 作用域正确、回调校验 state、授权码换取 access/refresh token、令牌不写入 localStorage 或日志、过期前刷新、并发刷新无竞态、refresh token 过期后提示重新授权、登出或撤销时清除已存令牌。
- 按连接核查:每个已上线连接需验证 OAuth 端到端、最小必要作用域、一次 execute_tool 调用成功、过期令牌触发刷新、第三方权限被撤销时能被处理。连接工具目录见 https://docs.scalekit.com/agentkit/connectors.md。
- 安全与监控:令牌不记录日志、refresh token 静态加密、令牌存储按用户隔离、有 webhook 时校验签名;在 Dashboard→Auth Logs 开启认证日志监控、错误追踪覆盖 OAuth 与刷新失败、重复授权失败触发告警、设置日志保留、准备事件处理手册。
- 最终冒烟测试:默认语言 Python,默认连接为已记录的 Connection Name,否则用 GitHub 及 github-connect;确认工具名后可调用。验证 get_or_create_connected_account 返回测试用户的已连接账户、认证链接完成后状态为 ACTIVE、execute_tool 成功、提供方令牌过期后仍能成功(Scalekit 自动刷新)、第三方撤销后报错不泄露令牌。
- 签核:打印完整记录,存在无结果项则回到对应步骤,不得签核。
使用方式:需使用生产凭据,凭据只放在环境变量中;SDK 与 curl 命令可自行执行,Dashboard 与浏览器 OAuth 步骤需用户操作,需暂停等待。若应用在每次调用前重新获取已连接账户,可对本地令牌存储项按此理由 WAIVE,不新增本地 vault;若由 Scalekit 托管 OAuth,可对 app-callback、auth-code、CSRF-state 项按此理由 WAIVE,不新增本地回调。连接若在 setup-agentkit 中已创建则沿用,否则指出 setup-agentkit 并停止。
适用场景与限制:适用于 AgentKit 生产上线前的合规核查与签核;依赖 Scalekit 生产环境与相关连接已配置。文档索引 https://docs.scalekit.com/llms.txt,MCP 地址 https://mcp.scalekit.com。其他具体平台、定价与效果信息暂未提供。