用途
setup 是 Scalekit AgentKit 集成的起点技能,用于在用户不确定从何入手时,将其路由到正确的具体技能。该技能本身不实现集成,只负责判断和指引。
主要能力
- 通过提问确认用户要构建的内容:需要代表用户调用第三方工具(Gmail、Slack、Salesforce 等)的新智能体;为现有智能体添加连接器访问或修复认证;通过 MCP 暴露 AgentKit 工具的 MCP 服务器。
- 确认用户当前状态:从零开始、已有 Scalekit 账号和环境、已设置 AgentKit 但卡在某一步。
- 根据匹配结果,明确告知用户应运行的技能命令,然后停止,由目标技能负责实现。
使用方式
该技能会一次只问一个问题,以确定用户意图。确定后,它会告诉用户运行对应命令:
- 新智能体代表用户调用第三方工具(Gmail、Slack、Salesforce 等):/agentkit:integrating-agentkit
- 发现某连接器可用工具、检查 schema:/agentkit:discovering-connector-tools
- 通过 MCP 为 Claude Desktop、Cursor、VS Code 暴露 AgentKit 工具:/agentkit:exposing-agentkit-via-mcp
- 上线前检查清单、进入生产环境:/agentkit:production-readiness-agentkit
- SDK 错误、导入错误、认证调用损坏:/saaskit:scalekit-code-doctor
如果用户已经明确需求,可以跳过本技能直接调用目标技能。若需要为应用添加 B2B 认证(登录、SSO、SCIM),则切换到 saaskit 插件:/saaskit:setup。
环境准备
对于新项目,在开始任何技能前需确认以下凭据存在:
SCALEKIT_ENVIRONMENT_URL=https://your-env.scalekit.com SCALEKIT_CLIENT_ID=<from dashboard> SCALEKIT_CLIENT_SECRET=<from dashboard>
这些凭据可从 app.scalekit.com → Developers → Settings → API Credentials 获取。Scalekit MCP 服务器(https://mcp.scalekit.com)已在 .mcp.json 中预配置,Claude Code 会自动处理 OAuth 2.1 认证,无需额外设置。
核心概念
- Connector:第三方应用(Gmail、Slack、Salesforce、GitHub 等)。
- Connection:你的应用与某连接器之间的约定(在仪表盘中配置)。
- Connected account:特定用户对某连接的使用授权。
- Tool:智能体可执行的动作(发送邮件、创建 issue 等)。
流程:用户授权 → 创建 connected account → 智能体发现工具 → 智能体使用该账号执行工具调用。
仪表盘设置说明:Gmail 无需额外配置即可使用。其他所有连接器(Slack、Salesforce、GitHub、Google Calendar 等)必须先在其 Scalekit 仪表盘中启用并配置,用户才能连接。
适用场景
适合刚开始接触 Scalekit AgentKit、不确定该用哪个技能、或需要确认环境变量与核心概念的用户。
限制
该技能不生成实现代码,也不执行集成本身;它只做路由和指引。具体实现由目标技能完成。