关于 iii-node-sdk
iii-node-sdk 是用于将 TypeScript/JavaScript Worker 连接到 iii engine 的 SDK,支持函数与触发器注册、调用、流处理、日志和遥测。
主要功能
- 01连接 Worker 与 iii engine
- 02注册异步函数处理器
- 03将触发器绑定到函数
- 04同步或异步调用函数
- 05支持二进制流和自定义流
- 06添加结构化日志与 OpenTelemetry
适用场景
- 01将 TypeScript Worker 接入 iii engine
- 02注册处理器并配置触发器执行
- 03以队列或即发即弃模式调用函数
安装
复制下面的命令,在终端中运行。
$
npx skills add https:/ / github.com/ iii-hq/ skills --skill iii-node-sdk安装后在 Claude Code 中输入/iii-node-sdk确认已加载。
详细介绍
Node.js SDK
用于将工作器连接到 iii 引擎的 TypeScript/JavaScript SDK。
文档
完整 API 参考:https://iii.dev/docs/api-reference/sdk-node
安装
npm install iii-sdk
主要导出项
| 导出项 | 用途 |
|---|---|
registerWorker(url, { workerName }) | 连接到引擎并返回客户端 |
registerFunction({ id }, handler) | 注册异步函数处理程序 |
registerTrigger({ type, function_id, config }) | 将触发器绑定到函数 |
trigger({ function_id, payload, action? }) | 调用函数 |
TriggerAction.Void() | 即发即弃调用模式 |
TriggerAction.Enqueue({ queue }) | 持久化异步调用模式 |
Logger | 结构化日志 |
withSpan, getTracer, getMeter | OpenTelemetry 埋点 |
createChannel() | 工作器之间的二进制流传输 |
createStream(name, adapter) | 自定义流实现 |
registerTriggerType(id, handler) | 注册自定义触发器类型 |
模式边界
- 有关使用模式和可运行示例,请参阅
iii-functions-and-triggers - 有关 HTTP 端点模式,请参阅
iii-http-endpoints - 有关 Python SDK,请参阅
iii-python-sdk - 有关 Rust SDK,请参阅
iii-rust-sdk
评论
支持 Markdown