#自定义术语

"自定义术语"允许你用一个关键词直接指向一段完整的 Logicform，从而把复杂语义封装成可复用的业务概念。配置后，用户在对话或搜索中只需输入该词，就能自动触发预设的查询逻辑。

• 入口：控制台 → 系统搭建 → 知识库配置 → 自定义术语
• 适用场景：将"销售情况"等泛化逻辑固化，等问到销售情况的场景下，同时出现销售额、销量、达成率三个指标。
• 依赖：业务建模中的语义层（指标、维度、权限）已配置完成，同时了解 Logicform 简介 中的字段含义。

#创建步骤

1. 在自定义术语列表中点击 新增词汇，录入关键词，例如：销售情况。
2. 在 Logicform 区域粘贴或手动编写 JSON。例如：

   {
     "schema": "sales",
     "query": { "渠道": "自营" },
     "preds": [
       { "name": "销售额", "operator": "$sum", "pred": "amount" },
       { "name": "订单数", "operator": "$count" }
     ],
   }

3、 保存并发布。已发布的词汇会立即对问答、API 生效。

#支持变量

自定义术语中的 Logicform 支持使用变量占位。系统会在执行前自动把这些占位符替换成当前请求上下文中的实际值，常见用法是放在 query 过滤条件里。

当前支持的变量：

• $username：当前登录用户的用户名。
• $role：当前请求中的角色名。它是一个字符串，不是角色数组。

例如，可以把"我的销售额"这样的逻辑封装成：

{
  "schema": "sales",
  "query": {
    "负责人": "user-$username",
    "$role": true
  },
  "preds": [{ "name": "销售额", "operator": "$sum", "pred": "amount" }]
}

#使用说明

• 支持在字符串中拼接使用，例如 "负责人": "user-$username"。
• 支持在 key 中使用变量，例如 "$role": true。
• $role 取的是当前生效角色，不是用户拥有的全部角色。
• 如果你的场景只需要按用户过滤，通常优先使用 $username。

#维护建议

• 命名规范：使用业务团队熟悉的语言，可同时配置中英文别名，方便跨团队协作。
• 版本管理：修改 Logicform 前先复制旧版，确保回滚路径；重大调整后同步通知依赖该词汇的团队。
• 测试验证：配置完成后，在问答中直接输入关键词，确认生成的结果与预期一致，并检查权限/过滤条件是否正确。

自定义术语与语义层共同构建了"一个词描述复杂问题"的能力，让 AI 员工和业务用户都能更快获得准确答案。