SuperAPI AI 工具集

iii-python-sdk

智能体与模型

查看项目

更新于 10-15 22:17

技能介绍

用途:iii-python-sdk 是 iii 引擎的异步 Python SDK,用于把 worker 连接到 iii 引擎,并在 Python 中注册函数、绑定触发器、调用函数。

主要能力:提供 register_worker(address, options?) 连接引擎并返回客户端;InitOptions(worker_name, otel?) 配置连接;register_function(id, handler) 注册异步函数处理器;register_trigger(type, function_id, config) 将触发器绑定到函数;trigger(request) 同步调用函数;trigger_async(request) 异步调用函数;get_context() 在处理器内访问日志与追踪上下文;ApiRequest / ApiResponse 为基于 pydantic 的 HTTP 请求/响应类型;IStream 为自定义流实现接口;on_functions_available(callback) 监听函数发现;on_connection_state_change(callback) 监控连接状态。

使用方式:安装 pip install iii-sdk。register_worker() 返回同步客户端,而处理器为异步。异步处理器内应使用 await iii.trigger_async({...}),同步脚本或线程中可使用阻塞的 iii.trigger({...})。worker 结束时用 while True: await asyncio.sleep(60) 保持事件循环存活;处理器内的 CPU 密集同步工作应使用 asyncio.to_thread()。注意 ApiResponse 使用 camelCase 的 statusCode(pydantic 别名),而非 status_code。

适用场景:构建 worker、注册函数、在 Python 中调用触发器。使用模式与示例可参考 iii-functions-and-triggers;Node.js 见 iii-node-sdk,Rust 见 iii-rust-sdk。

限制:不应作为无关任务的通用回退方案;当存在更具体的 iii 技能时不应使用本技能;应用示例前需先确认环境与安全约束。完整 API 参考见 https://iii.dev/docs/api-reference/sdk-python。