Add Lens 是 redis/agent-skills 提供的一项技能,用于为现有 AI 智能体接入 Redis Iris Lens 追踪。接入后,智能体的每一轮(turn)都会在 Lens UI 中呈现为一条 trace,涵盖该轮内的 LLM 调用、token、工具调用与检索跨度。Lens 内置于 redis-iris,无需单独开通服务,也没有命令行工具。
用途与接入顺序 该技能按以下步骤引导接入:发现项目结构、通过 MCP 获取当前事实、安装与配置、接线、补齐缺口、与现有遥测共存、验证,最后输出报告。它强调保留用户原有的框架、图和提示词,尽量缩小改动范围。
主要能力
- 为每个智能体轮次生成一条 trace,并按 agent_id 过滤、按 session 分组显示。
- 通过 [llm-tracing] 附加依赖,为 OpenAI、Anthropic、Bedrock、LangChain 提供 LLM 跨度与 token 统计;其他客户端需另行添加 instrumentor。
- 提供 lens.turn() 上下文管理器来包裹单轮;支持 lens.span() 记录 .client 调用,用 lens.retrieval()、lens.prompt_assembly()、lens.memory_recall() 记录检索与记忆读取。
- 支持线程池、跨进程跳转(lens.inject() 与 lens.continue_from())以及短生命周期进程的 lens.shutdown() 收尾。
- 与已有的 OpenTelemetry 共存:不会替换已有的 provider,而是向其中添加处理器,或在没有时自行安装。
使用方式 安装:uv add 'redis-iris[llm-tracing]'、poetry add 'redis-iris[llm-tracing]',或在 requirements 文件中添加 redis-iris[llm-tracing]。 配置环境变量:IRIS_LENS_ENDPOINT 与 IRIS_LENS_API_KEY,端点与密钥需在 Lens UI 中获取。 启动时调用:lens.init(agent_id="..."),随后检查 lens.instrumentation() 返回状态是否为 on。 在需要的位置用 lens.turn(thread_id, user_id=...) 包裹一轮执行,并调用 t.set_outcome() 设置结果。
适用场景 适用于使用 LangGraph、workflows、Google ADK、OpenAI Agents SDK、Pydantic AI、CrewAI 或手写循环的智能体项目,尤其是需要观测 LLM 调用、token 消耗、工具与检索行为的场景。
限制 部分框架(如 Google ADK 的 attach)不会自动开启轮次,需要手动包裹;未被 Lens 内置插桩的模型客户端不会产生 LLM 跨度与 token 统计;Lens 的导出器不读取 OTEL_EXPORTER_OTLP_* 变量;如果 tracer provider 不是 OpenTelemetry SDK 的,Lens 无法附加。其他细节暂未提供。