用途:把 Latitude 遥测接入后端项目,实现 LLM 调用追踪、日志与可观测性。
前提:需要 Latitude 账号和项目,注册地址 https://app.latitude.so。缺少二者则任何方式都无法使用。
环境变量:LATITUDE_API_KEY(在账号 Settings 中获取);LATITUDE_PROJECT_ID(项目 URL 中的数字,如 https://app.latitude.so/projects/30403/... 中为 30403);LATITUDE_PROMPT_PATH(已保存提示词用其路径,否则用任意字符串作为分组标签);LATITUDE_PROMPT_VERSION_UUID 默认 "live"。LLM 提供方 API Key 由用户项目决定。
选择方式:先确认是否用 Latitude 作为 LLM 推理网关;若是,由 Latitude 调用提供方并自动处理遥测,Python/TypeScript 用 prompts.run(),其他语言用 HTTP API 的 Run a Prompt 端点。若否,再确认是否用其作为提示词管理器(需 Python/TypeScript SDK)。最后按语言与可观测性需求选择:有 SDK(Python、TypeScript)用 SDK 遥测,Python 为 latitude-telemetry 包与 @telemetry.capture() 装饰器,TypeScript 为 @latitude-data/telemetry 包与 telemetry.capture();无 SDK 且需 token/成本追踪,用原生 OpenTelemetry OTLP,向 https://gateway.latitude.so/api/v4/traces 发送 span,需手动构建父子 span 与约 20 个属性,较复杂;无 SDK 且求最简,用 Create Log API,LLM 调用后向 /api/v3/projects/{id}/versions/{uuid}/documents/logs 发一次 HTTP POST,消息须为 PromptL 格式,但无 token、成本与延迟明细。API 基础地址为 https://gateway.latitude.so。
限制:Log API 实现简单但牺牲用量与成本可观测性;需 token 与成本数据必须用原生 OTLP。具体代码示例与属性清单见各参考文档,资料未提供更多细节。