iii-node-sdk について
iii-node-sdkは、TypeScript/JavaScriptのワーカーをiii engineに接続するSDKです。関数やトリガーの登録、呼び出し、ストリーム処理、ログ、テレメトリーに対応します。
主な機能
- 01ワーカーをiii engineに接続
- 02非同期関数ハンドラーの登録
- 03トリガーを関数に関連付け
- 04関数の同期・非同期呼び出し
- 05バイナリ・カスタムストリーム対応
- 06構造化ログとOpenTelemetry
活用シーン
- 01TypeScriptワーカーを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 対応