SuperAPI AI 工具集

iii-http-invoked-functions

智能体与模型

查看项目

更新于 10-15 22:17

技能介绍

用途:当 iii 需要把外部 HTTP 端点当作函数调用时使用此模式,适合适配遗留 API、第三方 webhook 或不可修改的系统。

主要能力:registerFunction(id, HttpInvocationConfig, options?) 注册一个出站 HTTP 调用函数;trigger({ function_id, payload }) 像调用普通函数一样触发它;基于 JSON 的调用中,触发 payload 会成为请求体;非 2xx 响应和网络失败都视为调用失败。

使用方式:先 registerWorker(url, { workerName }),再准备小型端点描述列表(形如 [{ path, id }]),循环调用 registerFunction(id, { url: base + path, method: 'POST' })。认证配置可选,使用环境变量键(token_key、secret_key、value_key)。

选择规则:任务要求“用 registerFunction 注册 HTTP 端点”时用本模式;任务给出端点列表/映射(如 { path, id })并循环注册时用本模式;被适配系统无法修改时用本模式。若目标是暴露 iii 自己拥有的入站路由,应改用 registerTrigger({ type: 'http' })。

限制与护栏:不要把出站 HTTP 端点适配建模为 registerTrigger({ type: 'http' });不要在 auth 字段中传原始密钥,只传环境变量名;函数 ID 应保持稳定并带域前缀(例如 legacy::orders)。参考实现见 ../references/http-invoked-functions.js,另有 Python 与 Rust 版本。应用示例前须先确认环境与安全约束。