Prompt-Router 技能

🚀 基于文本匹配的快速路由引擎，为简单任务提供 零 LLM 决策 的快速路径。

核心价值

• ⚡ 极速响应 - <5ms 路由决策（vs 500ms+ LLM 推理）
• 💰 零成本 - 简单任务无需 LLM 调用
• 🛡️ 可降级 - LLM 故障时仍可工作
• 🎯 确定性 - 相同输入始终相同输出

⚡ 快速开始

1. 加载技能

from skills.prompt_router.scripts.router import PromptRouter

# 创建路由器
router = PromptRouter(
    skills_dir='skills/',
    confidence_threshold=0.6  # 置信度阈值
)

# 加载技能元数据
router.load_skills()

2. 路由 Prompt

# 路由用户输入
result = router.route("搜索 Python 教程")

if result.match:
    print(f"匹配技能：{result.match['name']}")
    print(f"置信度：{result.confidence:.2f} ({result.confidence_level})")
else:
    print("未找到匹配，降级到 LLM")

3. 决策流程

if router.should_invoke_skill(result):
    # 高置信度：直接调用技能
    skill_name = result.match['name']
    invoke_skill(skill_name)
else:
    # 低置信度：降级到 LLM
    fallback_to_llm()

🎯 工作原理

路由流程

用户 Prompt
    ↓
分词处理（Tokenizer）
    ↓
评分匹配（Scorer）
    ↓
排序选择（Router）
    ↓
{
    高置信度 (≥0.8) → 直接调用技能
    中置信度 (0.6-0.8) → 建议用户确认
    低置信度 (<0.6) → 降级到 LLM
}

评分算法

# 多字段加权匹配
总分 = Σ(字段匹配分 × 权重)

字段权重：
- name: 3.0（名称匹配最重要）
- triggers: 2.5（触发词权重高）
- keywords: 2.0（关键词）
- description: 1.5（描述）

📋 配置选项

置信度阈值

调整建议：

• 提高阈值 → 更准确，但更多降级到 LLM
• 降低阈值 → 更快，但可能误匹配

技能目录

# 默认：当前 skills/ 目录
router = PromptRouter()

# 自定义目录
router = PromptRouter(skills_dir='/path/to/skills')

🔍 路由示例

示例 1：天气查询

prompt = "北京今天天气怎么样"
result = router.route(prompt)

# 输出：
# 匹配：weather
# 分数：8.50
# 置信度：0.85 (high)
# 调用技能：True

示例 2：文件读取

prompt = "读取 config.json 文件"
result = router.route(prompt)

# 输出：
# 匹配：read
# 分数：7.20
# 置信度：0.72 (medium)
# 调用技能：True

示例 3：复杂任务

prompt = "帮我搭建一个完整的自动化工作流"
result = router.route(prompt)

# 输出：
# 匹配：None
# 分数：2.10
# 置信度：0.21 (low)
# 调用技能：False
# 降级到 LLM：True

📊 性能指标

🎯 适用场景

✅ 推荐使用

⚠️ 不推荐

🔧 高级功能

1. 自定义同义词

# 添加同义词映射
synonyms = {
    '搜索': ['查找', 'search', 'find'],
    '天气': ['气温', 'weather', 'temperature'],
    '读取': ['打开', '查看', 'read'],
}

# 在分词时扩展
tokens = tokenizer.tokenize(prompt)
expanded_tokens = set()
for token in tokens:
    expanded_tokens.add(token)
    if token in synonyms:
        expanded_tokens.update(synonyms[token])

2. 路由日志