智能路由
智能路由是 1Panel AI 网关根据请求内容自动选择合适模型并实现分类转发的核心功能。系统通过预置分类样本识别请求复杂度，结合本地规则、向量相似度等来源作出路由决策，将每次决策记录到日志，并通过统计页面展示整体分布情况。
本文内容基于 1Panel AI 网关实测验证，截图取自测试环境，实时数据以当前网关配置为准。
1 功能简介
智能路由用于根据请求内容自动匹配并选择合适的模型，实现请求的分类转发与模型调度。系统通过预置的分类样本来识别请求的复杂度，结合本地规则、向量相似度等来源作出路由决策，并将每次决策记录到决策日志中，最终通过统计页面展示整体分布情况。
智能路由包含三个模块：
样本管理：维护用于请求分类的样本数据，支持设置样本标签以及单样本阈值。 决策日志：可查看每一次请求的路由分类、决策来源、选中模型和置信度等相关信息。 统计：支持按照标签、来源、模型、Token 维度查看决策分布情况。
2 前提条件
使用智能路由功能前，需满足以下条件：
- 已安装并启动 1Panel AI 网关，并以管理员账号登录后台。
- 已在 模型组 中配置可用的模型与账号池。
- 网关已产生真实请求流量，决策日志与统计模块才有数据可查。
3 功能入口
登录 1Panel AI 网关后台后，在左侧菜单栏中单击 智能路由，进入智能路由功能页。页面顶部提供三个标签页：样本管理、决策日志、统计。
4 样本管理
样本管理用于维护请求分类所需的路由样本。系统根据样本与请求的相似度对请求进行分类，分类结果决定请求被路由到简单或复杂模型。
4.1 样本列表
进入智能路由后默认显示样本管理页。样本列表按分页展示全部样本，包含标签、样本文本、向量与操作等信息。
4.2 添加样本
单击 添加样本，在弹出的表单中填写样本信息后保存，即可新增一个路由样本。
可在样本列表中选择多条样本后，单击 构建选中向量 批量构建；单击 构建全部向量 可为全部样本一次性构建向量。
4.3 决策预览
单击 决策预览，可输入一条请求样本，先查看路由决策的预判结果，确认无误后再决定是否添加为正式样本。
5 决策日志
决策日志用于记录网关每一次请求的路由决策结果，可按分类、来源、请求类型与时间进行筛选查询。
5.1 日志列表
进入决策日志页后，可查看每次请求的决策记录，包括请求 ID、路由分类、决策来源、选中模型、置信度、请求类型与决策耗时等。
5.2 查看决策详情
在决策日志列表中，单击某条记录所在行的 查看，可查看该次决策的完整详情，包括路由分类、决策来源、置信度、选中模型、各类评分以及 Top K 命中样本等。
6 统计
统计模块以时间维度（默认近 30 天）汇总展示智能路由的整体决策情况，包含核心指标与多维度分布。
统计页支持切换时间维度查看不同周期的数据，包括近 24 小时、近 7 天与近 30 天。
7 注意事项
- 样本的标签与阈值设置会直接影响路由分类结果，设置前建议先通过决策预览验证效果。
- 构建向量需要消耗一定时间与资源，样本较多时建议使用 构建全部向量 一次性完成。
- 决策日志与统计模块的数据来自真实请求流量，仅当网关产生请求后才有记录。
- 统计中的数值为动态数据，本文截图中的具体数值仅作示例展示。