用途:在 Netra 追踪中统一应用身份与对话上下文,为每次请求、会话、用户和租户建立一致的追踪信息。
主要能力:设置 user_id、session_id、tenant_id;附加稳定的自定义属性(如 tier、region、plan、channel);记录关键里程碑的业务事件;为多轮应用添加用户输入与助手输出的对话日志。
使用方式:在请求入口、任何下游 LLM 或工具调用之前设置 ID;附加自定义属性;记录业务事件;添加对话条目;在下一个请求边界清除或替换上下文。资料提供了 Python 与 TypeScript 两种模式,Python 使用 from netra import Netra 与 from netra.session_manager import ConversationType,TypeScript 使用 import { Netra } from "netra-sdk"。
适用场景:需要在追踪中携带每请求身份信息、希望为 span 附加自定义属性与业务事件、需要多轮应用对话输入输出日志的场景。
限制与检查项:ID 每请求设置一次,不得跨用户复用;上下文须在首个被追踪操作前设置;事件负载避免密钥与原始 PII;仅在策略允许处启用对话日志。
参考:https://docs.getnetra.ai/sdk-reference/sdk/overview、https://docs.getnetra.ai/Observability/Traces/overview、https://docs.getnetra.ai/sdk-reference/sdk/typescript。