渠道¶

在这里可以管理 NewAPI 的上游渠道

渠道创建/编辑页面¶

渠道管理1

渠道管理2

渠道管理3

参数覆盖设置文档¶

概述¶

参数覆盖系统支持两种模式：简单覆盖模式（向前兼容）和高级操作模式。通过灵活的条件判断和操作类型，可以实现复杂的参数动态调整。

使用方式¶

简单覆盖模式¶

向前兼容性，直接指定要覆盖的字段和值，系统会将这些字段合并到原始请求中

{
  "temperature": 0.8,
  "max_tokens": 2000,
  "model": "gpt-4"
}

高级操作模式¶

通过 operations 数组定义复杂的参数操作，支持条件判断、数组操作、字符串拼接等高级功能

基本结构¶

{
  "operations": [
    {
      "path": "temperature",
      "mode": "set",
      "value": 0.8,
      "conditions": [...],
      "logic": "AND"
    }
  ]
}

操作模式 (mode)¶

1. set - 设置值¶

设置指定路径的值

{
  "path": "temperature",
  "mode": "set",
  "value": 0.8,
  "keep_origin": false
}

参数说明： - keep_origin: 为 true 时，如果目标路径已存在值则跳过设置

2. delete - 删除字段¶

删除指定路径的字段

{
  "path": "messages.0",
  "mode": "delete"
}

3. move - 移动字段¶

将一个字段的值移动到另一个位置

{
  "mode": "move",
  "from": "messages.0.content",
  "to": "system"
}

4. append - 追加内容¶

在现有内容后追加新内容

{
  "path": "messages.0.content",
  "mode": "append",
  "value": "\n\n请用中文回答。"
}

支持的数据类型： - 字符串: 在原字符串末尾追加 - 数组: 在数组末尾添加元素（支持添加单个元素或数组） - 对象: 合并对象属性

5. prepend - 前置内容¶

在现有内容前添加新内容

{
  "path": "messages.0.content",
  "mode": "prepend",
  "value": "重要提示：请仔细阅读以下内容。\n\n"
}

支持的数据类型： - 字符串: 在原字符串开头前置 - 数组: 在数组开头添加元素（支持添加单个元素或数组） - 对象: 合并对象属性

条件判断¶

通过 conditions 数组设置操作执行的条件，只有满足条件时才会执行操作

条件结构¶

{
  "conditions": [
    {
      "path": "model",
      "mode": "contains",
      "value": "gpt-4",
      "invert": false,
      "pass_missing_key": false
    }
  ],
  "logic": "AND"
}

条件匹配模式¶

full: 完全匹配（默认）
prefix: 前缀匹配
suffix: 后缀匹配
contains: 包含匹配
gt: 大于（仅数字类型）
gte: 大于等于（仅数字类型）
lt: 小于（仅数字类型）
lte: 小于等于（仅数字类型）
须知：
数值比较只能用于数字类型
字符串操作（prefix、suffix、contains）会将值转换为字符串进行比较

条件参数说明¶

invert: 反选功能，true 表示取反结果
pass_missing_key: 当指定路径不存在时的行为
true: 路径不存在时条件通过
false: 路径不存在时条件不通过（默认）

逻辑关系 (logic)¶

AND: 所有条件都必须满足
OR: 任意条件满足即可（默认）

路径语法¶

使用 JSON 路径语法访问嵌套字段：

temperature - 根级字段
messages.0.content - 数组第一个元素的 content 字段
messages.-1.content - 数组最后一个元素的 content 字段
metadata.user.name - 嵌套对象字段

实用示例¶

1. 动态调整模型参数¶

根据消息内容动态调整温度参数：

{
  "operations": [
    {
      "path": "temperature",
      "mode": "set",
      "value": 0.3,
      "conditions": [
        {
          "path": "messages.0.content",
          "mode": "contains",
          "value": "代码"
        }
      ]
    },
    {
      "path": "temperature",
      "mode": "set",
      "value": 0.9,
      "conditions": [
        {
          "path": "messages.0.content",
          "mode": "contains",
          "value": "创意"
        }
      ]
    }
  ]
}

2. 添加系统提示¶

在消息数组开头添加系统消息：

{
  "operations": [
    {
      "path": "messages",
      "mode": "prepend",
      "value": [
        {
          "role": "system",
          "content": "你是一个专业的AI助手，请始终保持礼貌和专业。"
        }
      ]
    }
  ]
}

3. 根据模型类型调整参数¶

根据不同模型设置不同的 max_tokens：

{
  "operations": [
    {
      "path": "max_tokens",
      "mode": "set",
      "value": 4000,
      "conditions": [
        {
          "path": "model",
          "mode": "prefix",
          "value": "gpt-4"
        }
      ]
    },
    {
      "path": "max_tokens",
      "mode": "set",
      "value": 2000,
      "conditions": [
        {
          "path": "model",
          "mode": "prefix",
          "value": "gpt-3.5"
        }
      ]
    }
  ]
}

4. 多条件组合（AND逻辑）¶

同时满足多个条件时才执行操作：

{
  "operations": [
    {
      "path": "stream",
      "mode": "set",
      "value": false,
      "conditions": [
        {
          "path": "model",
          "mode": "contains",
          "value": "claude"
        },
        {
          "path": "messages.0.content",
          "mode": "contains",
          "value": "长文"
        }
      ],
      "logic": "AND"
    }
  ]
}

5. 数值比较条件¶

根据数值大小进行条件判断：

{
  "operations": [
    {
      "path": "temperature",
      "mode": "set",
      "value": 0.1,
      "conditions": [
        {
          "path": "max_tokens",
          "mode": "gt",
          "value": 1000
        }
      ]
    }
  ]
}

6. 反选条件¶

使用 invert 实现反选逻辑：

{
  "operations": [
    {
      "path": "stream",
      "mode": "set",
      "value": true,
      "conditions": [
        {
          "path": "model",
          "mode": "contains",
          "value": "gpt-3.5",
          "invert": true
        }
      ]
    }
  ]
}

7. 处理缺失字段¶

使用 pass_missing_key 处理可能不存在的字段：

{
  "operations": [
    {
      "path": "temperature",
      "mode": "set",
      "value": 0.7,
      "conditions": [
        {
          "path": "custom_field",
          "mode": "full",
          "value": "special",
          "pass_missing_key": true
        }
      ]
    }
  ]
}

8. 字符串拼接示例¶

在用户消息后追加指导语：

{
  "operations": [
    {
      "path": "messages.-1.content",
      "mode": "append",
      "value": "\n\n请详细解释你的思考过程。"
    }
  ]
}

注意事项¶

执行顺序: 操作按照在 operations 数组中的顺序依次执行，前面的操作会影响后续操作