LoongSuite GenAI Util 是独立发布的 PyPI 包(loongsuite-util-genai),在多个能力上比上游更完整:
- 更多 Span 类型:新增 invoke_agent、create_agent、embedding、execute_tool、retrieve、rerank、memory 等操作类型
- 多模态分离上传:支持将图片/音频/视频等 Base64/Blob/URI 自动上传到 OSS、SLS 或本地存储,消息中只保留 URI 引用,默认异步上传避免拖慢链路
- 增强语义属性:新增 gen_ai.usage.total_tokens、gen_ai.response.time_to_first_token 等
- 可扩展 Hook:支持通过 entry point 扩展 PreUploader/Uploader
- 阿里云集成:通过 fsspec 支持阿里云 OSS/SLS 存储
这些增强让手动埋点更加轻松,同时保证与自动插桩数据一致。




