跳到主要内容

配置系统

CountBot 的配置不是围绕“单次聊天”设计的，而是围绕“一个可长期运行的系统”来组织。

理解这套配置的最好方式，不是盯着单个表单，而是先看清楚配置层次。

配置分层​

1. 全局默认配置​

这是系统的基础运行层，主要决定：

  • 默认模型与提供商
  • 工作空间路径
  • 安全策略
  • 默认人格

2. 人格与会话行为​

这一层决定：

  • AI 如何称呼用户
  • 输出语言与风格
  • 默认历史窗口
  • 问候助手等持续行为

3. 智能体团队​

团队层负责定义：

  • 协作模式
  • 成员职责
  • 团队是否使用独立模型
  • 多成员任务怎么拆解与汇总

4. 渠道账号​

渠道层负责定义：

  • 接入哪个 IM 平台
  • 每个平台下有哪些机器人账号
  • 哪些群组或用户允许访问
  • 某个账号默认走 AI 模式还是直通模式

5. 外部编程工具​

编程工具层负责定义：

  • 外部 CLI 如何启动
  • 工作目录如何传递
  • 会话模式如何选择
  • 哪些环境变量需要透传

6. 工作空间​

工作空间是所有运行时产物的落点，通常包含：

  • skills/
  • memory/
  • temp/
  • 业务生成文件
  • 外部编程工具配置文件

推荐理解方式​

全局默认值是“底座”​

如果没有团队级覆盖、会话级覆盖或渠道级覆盖，系统会优先使用全局默认值。

团队是“组织方式”​

团队不负责替代全局配置，而是基于全局配置去定义多角色协作。

渠道账号是“入口”​

渠道账号决定消息从哪里进来、由哪个机器人回复，以及默认路由如何工作。

外部编程工具是“执行扩展”​

它不是模型替代品，而是 CountBot 在需要时调用的外部编码执行器，也可以被渠道账号设置为默认直通目标。

建议先配哪些项​

第一优先级​

  • 模型提供商
  • API Key
  • 默认模型
  • 工作空间路径

第二优先级​

  • 人格
  • 安全策略
  • 审计与工作空间限制

第三优先级​

  • 团队与角色
  • 渠道账号
  • 外部编程工具

一个稳妥的配置顺序​

  1. 先配全局模型与安全策略
  2. 再确认工作空间
  3. 再设默认人格
  4. 再建团队和角色
  5. 再接渠道账号
  6. 最后接外部编程工具与默认路由

为什么这样安排​

因为团队、渠道和外部编程工具都依赖稳定的基础运行层。先把默认值配稳，后面的结构才不会每个地方都重复补字段。

常见误区​

误区一：团队配置等于全部配置​

不是。团队只解决协作问题，不替代模型、工作空间、安全和渠道这些基础层。

误区二：渠道配置只是一组机器人凭证​

不是。现在的渠道配置还决定多账号、多路由、会话归属和默认编程工具接入方式。

误区三：外部编程工具只是一个附加按钮​

不是。它已经是渠道路由与聊天工作流的一部分，可以直接影响 IM 会话如何被处理。

相关文档​