用途:为 LaunchDarkly 的 AI 配置(configs)设置定向规则,决定不同上下文获得哪个变体,适用于 completion 与 agent 两种模式。
前提:需启用 AgentControl 的 LaunchDarkly 账户、具写权限的 API 访问令牌、项目键与环境键,以及已含变体的配置(可用 configs-create 技能创建)。优先使用 LaunchDarkly MCP 服务器工具(OAuth 认证,无需令牌);若无 MCP 对应步骤需直接调用 REST API,需用户在本会话粘贴令牌替代 {api_token},不应从环境变量或配置文件中搜索凭据。
评估顺序:个体目标(最高)→ 细分受众规则 → 自定义属性规则 → 默认规则(fallthrough)→ 定向关闭时的 off 变体。
核心机制:定向使用语义补丁 API,路径为 PATCH /api/v2/projects/{projectKey}/ai-configs/{configKey}/targeting,请求头需 Content-Type: application/json; domain-model=launchdarkly.semanticpatch 与 LD-API-Version: beta。变体用 UUID(_id)而非 key,需先 GET 定向获取;权重以千分比表示(50000=50%)。多条款为 AND,多值为 OR,属性为 null 的规则会被跳过。
典型操作:先用 GET 获取变体 ID;用 updateFallthroughVariationOrRollout 设置默认规则(注意 turnTargetingOn 对配置无效,配置默认已启用定向);用 addRule 添加属性规则或百分比发布;用 addTargets 定向特定上下文键;用 segmentMatch 定向细分受众;用 replaceRules 清空规则。
支持运算符:in、contains、startsWith、endsWith、matches、greaterThan/lessThan、before/after、semVerEqual/semVerGreaterThan、segmentMatch;negate 可反转。发布类型包括手动百分比、渐进式、守护式发布。
限制与错误:指令中运算符须小写;400 表示补丁无效,403 表示权限不足,404 表示配置未找到,422 表示变体无效(需用索引或 UUID)。后续可提供配置 URL、用 built-in-metrics 监控、用 online-evals 附加评判、配置守护式发布检测回归。