SuperAPI AI 工具集

netra-custom-spans-and-actions

通用与其它

查看项目

更新于 10-15 23:45

技能介绍

用途:当自动或装饰器追踪不够用时,使用该技能对关键操作进行显式 span 生命周期控制,例如外部 API、工具调用或批处理步骤。

主要能力:为每个关键操作创建 Netra span;设置 span 属性(如 model、llm_system、operation 等键);通过 UsageModel 附加用量与成本;通过 ActionModel 记录 DB/API 副作用;添加事件用于检查点与失败标记。

使用方式:Python 中用 Netra.start_span(...) 包裹操作,调用 set_attribute、set_model、set_llm_system、set_usage、set_action、add_event。TypeScript 中用 Netra.startSpan(...) 创建 span,调用 setModel、setLlmSystem、setUsage、setAction、addEvent,成功时 setSuccess,异常时 setError 并在 finally 中 end。

适用场景:需要按操作追踪用量/成本、需要结构化动作记录、需要围绕外部调用或批处理步骤建立有意义业务边界时。

限制与检查项:每个自定义 span 应对应有意义的业务边界;付费模型调用需填充用量与成本字段;动作记录应包含成功/失败状态;异常时 span 必须干净关闭。具体安装命令、价格与平台支持暂未提供。