SuperAPI AI 工具集

make-endpoints

通用与其它

查看项目

更新于 10-15 22:38

技能介绍

用途:从 JavaScript、TypeScript 或终端调用 Make 各应用动作,使用 Make 托管的连接。入口是 @makehq/endpoints-sdk,一个包内含 SDK、make-endpoints-cli 与 agent 工具定义,并通过 @makehq/sdk 发起已认证的 Make 请求。它不是 make-cli、场景运行或直接使用提供方 SDK。

主要能力:先确认项目、接口、Make zone 与团队,检查已安装包、Node 引擎要求与导出接口,并固定版本。用 make-endpoints-cli list 后缩小到某个应用/版本,用 describe 查看该 Endpoint 的输入 schema、账户类型、scope、上下文与注解,必要时再取输出 schema,并区分内置目录与实际团队可用性。

使用方式:代码中构造带 SdkTransport 与 teamId 的作用域客户端,调用 client.endpoints.<name>({ connectionId, input });或使用 execute(pointer, options) 返回 { output }。面向智能体时,仅从 @makehq/endpoints-sdk/tools 暴露相关定义,由可信宿主保管凭据并校验参数与审批。组合键包括 zone、团队、应用名、应用版本、Endpoint 名及必要时连接 ID,来自实际发现或明确输入,不擅自修正。

执行与限制:读取也通过 HTTP POST 传输,需按分页契约完整拉取,限制页数与输出大小,拒绝不前进的游标,并按稳定 ID 去重。写入前须绑定到确切目标、资源与载荷,完成后回读校验。包可公开安装,但 Endpoints 处于封闭测试,需组织启用;安装与本地目录发现不等于具备执行权限。权限确认需分别检查 Make 密钥与应用连接提供方权限,不得扩大权限或更换账户绕过拒绝。缺失访问不能当作空目录,应说明区别。