SuperAPI AI 工具集

integrating-agentkit

智能体与模型

查看项目

更新于 10-16 04:32

技能介绍

用途:把 Scalekit AgentKit 集成进项目,让智能体代表用户在 Gmail、Slack、Notion、Calendar 等连接器上执行操作。Scalekit 负责完整 OAuth 生命周期——授权、令牌存储与刷新。

必要环境变量:SCALEKIT_CLIENT_ID、SCALEKIT_CLIENT_SECRET、SCALEKIT_ENVIRONMENT_URL,从 app.scalekit.com 的 Developers → Settings → API Credentials 获取。注意部分文档使用 SCALEKIT_ENV_URL,本技能统一用 SCALEKIT_ENVIRONMENT_URL。

核心概念 connection name:每个连接器在仪表盘有 Connection Name,须原样传入每次 SDK 调用(Python 为 connection_name,Node 为 connectionName)。它可能与连接器 slug 不同(如 slug 为 gmail,名称为 MY_GMAIL_PROD),必须使用仪表盘中的值,不得猜测或使用连接器字段。

约束:必须用环境变量读取凭据,禁止硬编码密钥;除 Gmail 外,其他连接器须先在仪表盘配置(AgentKit → Connections → + Create Connection → 选择连接器 → 设置 Connection Name → 保存)后才能创建授权链接,否则调用失败。

安装与初始化:Python 执行 pip install scalekit-sdk-python python-dotenv requests,Node 执行 npm install @scalekit-sdk/node,然后用上述三个环境变量初始化客户端。

流程:(1)用 get_or_create_connected_account 创建已连接账户,identifier 填实际用户 ID;(2)若状态不是 ACTIVE,用 get_authorization_link 获取链接让用户完成 OAuth(Web 应用重定向,CLI/非交互打印后停止,OAuth 后从第 3 步重跑);(3)调用 get_connected_account 获取令牌,务必在任何 API 调用前即时获取,以利用自动刷新;(4)以 access_token 作为 Bearer 令牌调用第三方 HTTP API,示例为拉取 5 封未读 Gmail 邮件。

其他连接器只需替换 Connection Name,SDK 流程相同,下游 API 调用不同。

构建智能体:可用 LangChain 工具或 Google ADK,需额外安装框架包(如 langchain、langchain-openai、google-adk);工具发现的 providers 参数是连接器类型 slug(如 GMAIL),不是仪表盘的 Connection Name。这些辅助目前以 Python 为主,Node 可走令牌路径或通过 MCP 暴露工具。

限制:文中未提供收费、价格、平台支持与效果数据;具体连接器 API 细节需参考 Scalekit Connectors catalog。