在实际生产中，许多开发者不会完全依赖 LangChain、AgentScope 等框架，而是自己实现关键流程，比如：
- 使用 RESTful API 访问自部署的 LLM 或网关
- 自主实现 ReAct 迭代过程
- 完全用代码"手搓"整个 Agent 以获得灵活的上下文管理
这些自定义流程无法被自动插桩识别，需要手动埋点。手动埋点需要处理：Span 父子关系、GenAI 语义规范合规性、错误异常捕获、指标记录、多模态上传等。
LoongSuite GenAI Util 极大简化了这个过程 — 你只需构造 Invocation 对象、填入必要信息，剩下的可观测细节由 Util 自动完成，产出的数据和自动插桩一样完整准确。
