配置与设置

摘要

数字员工的配置不是让人填表单，而是用业务语言说，它翻译成配置动作。配置本身分成几类：岗位（它是谁、管什么、能用什么工具）、身份与关系（谁找它、什么身份、什么权限）、通道（从哪进来）、模型（用什么模型）。本页说清它们在哪儿配、怎么生效、以及配置不生效时怎么查。

入口	载体	适合放什么	生效方式
主配置	实例的主配置文件	全部字段，唯一能配全的地方	重启，或在线上触发重载
环境变量	环境变量文件 / 进程环境	只有标注了环境变量支持的字段	随配置加载一起生效
运行时重载	调用实例的重载接口	通道集、路由绑定、岗位、部分设备表	即时生效

两点要记住：

一条通道要真正跑起来，必须同时过三道：

第 1 关  这个通道编译进了当前版本      不过 ⇒ 完全无日志
第 2 关  通道已注册到实例              不过 ⇒ 日志里一条「未注册」告警
第 3 关  通道已启用且必填项齐备        不过 ⇒ 静默跳过，没有任何日志

排障顺序是倒着查：先看配置判据（最容易漏），再看注册告警，最后核对版本里有没有编入这条通道。

最常见的坑：开了开关但没填必填项

不同通道的必填项不一样：有的只要一个令牌，有的要地址 + 分机 + 密码三项齐全。启用 为真不等于通道会启动——缺一项就是静默跳过，什么日志都没有。

各通道字段不同，但下面几个字段在多数通道里含义一致：

allow_from 的方向性一定要讲清：空=全开放。现场按"空=禁止"理解，会把通道配成谁都能进。

每一次配置改动都留痕：时间、改了什么、改动前后取值、这份配置的指纹。

按这个顺序往下走，绝大多数问题在前三步能定位：

顺序	查什么
1	开关与必填项是否齐备（最易漏，且失败无日志）
2	字段写的位置对不对（有些字段不在你以为的那一段里）
3	环境变量文件里有没有同名键重复（重复时只有第一处生效）
4	通道是否已注册、版本里是否编入了这条通道
5	改完是否触发了生效动作（有的要重载、有的要重启）

配置能直接看原文吗？ 能。工作台的配置视图展示各配置域的当前取值与条目数；看板只读，改动在对话里做。

换模型会丢记忆吗？ 不会。模型是可替换的资源，记忆与资料在实例里。

多渠道配置会不会互相影响？ 不会。每条通道一组开关与凭据，逐条独立，接错了随时关。