SuperAPI AI 工具集

integrate-agentkit

智能体与模型

查看项目

更新于 10-16 09:52

技能介绍

本技能用于把仓库从连接配置推进到“已连接账户 + 授权链接 + 一次工具调用”,走 Scalekit 文档快速开始路径(https://docs.scalekit.com/agentkit/quickstart/)。

用途:让智能体集成 AgentKit,创建已连接账户、完成授权并执行一次 execute_tool 调用。默认语言为 Python;若仓库是 Node,则查阅 references/node.md;语言未知时保持 Python。

主要步骤与约束:

  1. 确认 Connection Name。必须传入仪表盘中显示的准确名称(Python 用 connection_name,Node 用 connectionName),不得虚构 slug,也不得用 connector 字段代替。未记录时:用户未指定连接器则用 GitHub 的 github-connect;指定了连接器则用其仪表盘名称;若该连接器尚无连接,则先执行 setup-agentkit 并停止。
  2. 初始化 SDK。凭据从 SCALEKIT_ENVIRONMENT_URL、SCALEKIT_CLIENT_ID、SCALEKIT_CLIENT_SECRET 读取(部分示例用 SCALEKIT_ENV_URL,此处用 SCALEKIT_ENVIRONMENT_URL)。缺失时向用户索取,不得从其他项目或目录复制。安装:pip install scalekit-sdk-python python-dotenv。
  3. 用 get_or_create_connected_account 创建已连接账户,identifier 使用项目稳定用户 id。
  4. 若状态非 ACTIVE,用 get_authorization_link 生成授权链接并打印;非交互进程须打印链接后停止,用户完成 OAuth 后重跑脚本,再检查状态,仍非 ACTIVE 则报错退出。Web 应用则重定向浏览器并返回后复查。
  5. 用 execute_tool 调用工具(Node 为 executeTool)。默认只读工具 github_user_get_authenticated,输入为空。其他连接器须在 https://docs.scalekit.com/agentkit/connectors.md 确认工具名,或使用 list_tools 按 Connection Name 列出工具。仅改 tool_name 与 tool_input,保持步骤 3–4。

注意事项:Scalekit 会把用户令牌加入出站请求,不向应用返回原始用户令牌。连接是仪表盘连接器配置,已连接账户是某用户在该连接上的授权。新环境自带一个连接:GitHub,Connection Name 为 github-connect;其他连接器(含 Gmail)需在 AgentKit → Connections 自建,setup-agentkit 可创建。相关技能:setup-agentkit、discover-connectors、integrate-agentkit-host、expose-agentkit-mcp;框架参考 references/frameworks.md。

限制:官方资料未提供收费、价格、平台支持范围、具体效果数据;这些信息暂未提供。