核心概念/路由
路由
v1.1.x · 已更新 2026-06-26
当一条消息到达时,会做出两个路由决策: 哪个代理 应该处理它,并 哪个模型类 应该运行该轮次。第一个问题由路由器解决;第二个问题由模型层路由解决。两者都发生在编排器驱动函数调用循环之前。
解析目标代理
路由器按定义的顺序解析目标代理:
- 绑定 — 一个将频道、对话或
将上下文发送给特定代理。这是主要的确定性路径。
@-提及 ——在群聊中,提到某个代理的名字会引导
向那个代理发送消息。这就是群组路由的工作原理。
- 后备 — 如果没有其他匹配项,消息将发送到已配置的
备用代理,以确保对话永远不会无人回应。
inbound ─▶ binding? ─▶ @-mention? ─▶ fallback ─▶ agent
[!NOTE]
@-提及是使多代理群聊可用的原因:多个代理可以
分享一次对话,每条消息都会发送给被指定的人。
绑定
A 绑定 是路由的确定性核心。通过将入站上下文(例如特定的渠道或对话)绑定到某个代理,您可以获得可预测的行为:除非出现某种情况,否则相同的来源总是到达相同的代理。 @-mention 会覆盖单条消息的设置。
通道绑定在管理员用户界面中配置: 绑定 在……上阻止 频道 页面分配一个 默认代理 对每个频道(每个工作区)。当来自该频道的新对话没有明确指定的代理时,该绑定将生效。
[!TIP]
为每个生产通道设置绑定,以便路由永远不依赖于
回退。将回退保留给真正无法匹配的流量。
模型层路由
无论选择哪个代理,AiHummer 都可以将一次交互转发给一个 模型层级 基于它的要求程度:
| 层 |
意在 |
| 简单 |
短而常规的转弯 |
| 标准 |
日常工作 |
| 复杂 |
困难的多步骤推理 |
模型分层路由配置在 大型语言模型 路由器设置。它让你为简单的对话提供廉价、快速的模型,同时为复杂的对话保留更强大的模型,从而在不手动调整每个代理的情况下控制成本。
[!NOTE]
模型层级路由与代理自身的每个代理模型是分开的。
每个代理的模型是代理的默认模型;分级路由可以选择模型类别
对于给定的回合。参见 代理与角色.
接下来去哪儿
当一条消息到达时,会做出两个路由决策: **哪个代理** 应该处理它,并 **哪个模型类** 应该运行该轮次。第一个问题由路由器解决;第二个问题由模型层路由解决。两者都发生在编排器驱动函数调用循环之前。
## 解析目标代理
路由器按定义的顺序解析目标代理:
1. **绑定** — 一个将频道、对话或
将上下文发送给特定代理。这是主要的确定性路径。
2. **`@`-提及** ——在群聊中,提到某个代理的名字会引导
向那个代理发送消息。这就是群组路由的工作原理。
3. **后备** — 如果没有其他匹配项,消息将发送到已配置的
备用代理,以确保对话永远不会无人回应。
```text
inbound ─▶ binding? ─▶ @-mention? ─▶ fallback ─▶ agent
```
> [!NOTE]
> `@`-提及是使多代理群聊可用的原因:多个代理可以
> 分享一次对话,每条消息都会发送给被指定的人。
## 绑定
A **绑定** 是路由的确定性核心。通过将入站上下文(例如特定的渠道或对话)绑定到某个代理,您可以获得可预测的行为:除非出现某种情况,否则相同的来源总是到达相同的代理。 `@`-mention 会覆盖单条消息的设置。
通道绑定在管理员用户界面中配置: **绑定** 在……上阻止 **频道** 页面分配一个 **默认代理** 对每个频道(每个工作区)。当来自该频道的新对话没有明确指定的代理时,该绑定将生效。
> [!TIP]
> 为每个生产通道设置绑定,以便路由永远不依赖于
> 回退。将回退保留给真正无法匹配的流量。
## 模型层路由
无论选择哪个代理,AiHummer 都可以将一次交互转发给一个 **模型层级** 基于它的要求程度:
| 层 | 意在 |
|---|---|
| **简单** | 短而常规的转弯 |
| **标准** | 日常工作 |
| **复杂** | 困难的多步骤推理 |
模型分层路由配置在 **大型语言模型** 路由器设置。它让你为简单的对话提供廉价、快速的模型,同时为复杂的对话保留更强大的模型,从而在不手动调整每个代理的情况下控制成本。
> [!NOTE]
> 模型层级路由与代理自身的每个代理模型是分开的。
> 每个代理的模型是代理的默认模型;分级路由可以选择模型类别
> 对于给定的回合。参见 [代理与角色](/zh/v1.0/concepts/agents-personas).
## 接下来去哪儿
- 看看所选代理接下来会做什么
[编排与子代理](/zh/v1.0/concepts/orchestration-subagents).
- 配置路由目标中的代理
[代理与角色](/zh/v1.0/concepts/agents-personas).