用途
本技能指导开发者将应用从旧版 LaunchDarkly AI SDK 迁移至当前基于处理器的 AI SDK。迁移仅涉及代码层面,LaunchDarkly 中的 AgentControl 配置(原 AI Configs)键、变体、工具和评判器均保持不变。
主要能力
- 盘点旧版导入与调用点,记录文件与行号,并确认提供方、模式、工具、回退行为及额外功能。
- 为每个调用点选择当前 SDK 的替代方案(便捷函数、config().invoke()、graph().invoke() 等)。
- 重写代码:替换包、删除旧初始化、迁移模板变量与工具注册、保留回退逻辑、移除追踪代码、集中共享注册表。
- 验证迁移结果:检查无旧版引用、构建与测试通过、正常路径与回退路径行为正确、指标正常上报。
使用方式
技能按以下步骤执行:
- 探索(只读):搜索旧版包与调用模式,记录提供方、模式、工具、回退行为等,向用户展示清单并等待确认。
- 评估:为每个调用点选定目标替换方案,列出需添加和移除的包及回退保留方式,与用户确认计划。
- 执行:逐调用点迁移,包括换包、替换初始化、重写调用、迁移模板变量与工具、保留回退、替换追踪代码、集中注册表、清理死代码。
- 验证:搜索确认无旧版引用,运行类型检查、linter 和测试,验证正常路径与回退路径,检查指标上报,输出迁移报告。
适用场景
- 应用已使用旧版 LaunchDarkly AI SDK,且配置已在 LaunchDarkly 中存在。
- 需要将 Python 或 Node.js 应用迁移到当前处理器式 SDK。
- 涉及完成模式、智能体模式、流式、多轮对话、工具调用循环、智能体图、评判器等场景。
限制
- Python 要求 3.12 或更高版本(launchdarkly-ai-server 1.0.0+),API 为异步。
- 当前 SDK 不接收回退参数;调用点需显式 try/except 或 try/catch 保留降级行为。
- 处理器包仅转发模型参数的固定白名单,未知键会被丢弃;应用级参数应移至 model.custom。
- 若提供方无对应处理器包,需使用 litellm-、langchain-、vercel-* 或自定义处理器。
- 1.0+ 版本默认捕获提示、模型输出、工具负载和评判推理到 OpenTelemetry 跨度;处理敏感数据时需配置关闭内容捕获。