Keyword Signal

Overview

keyword matches explicit lexical patterns in the request. It maps to config/signal/keyword/ and is declared under routing.signals.keywords.

This family is heuristic: it routes from configured words, phrases, or lightweight retrieval methods instead of learned intent classifiers.

Key Advantages

• Gives deterministic routing for obvious lexical cases.
• Supports simple regex-style matching and stronger BM25 or n-gram variants.
• Is easy to audit because the trigger phrases are explicit.
• Often provides the fastest path to a useful routing graph.

What Problem Does It Solve?

Some routes do not need a full classifier. They just need to recognize stable words such as billing, password reset, or urgent support.

keyword solves that by turning lexical matches into reusable named signals instead of scattering string checks across decisions.

When to Use

Use keyword when:

• lexical cues are stable and high-signal
• you want deterministic routing for support or policy keywords
• you need a low-latency first pass before learned signals
• prompt wording matters more than semantic paraphrase coverage

Configuration

Source fragment family: config/signal/keyword/

routing:
  signals:
    keywords:
      - name: code_keywords
        operator: OR
        method: bm25
        keywords: ["code", "function", "debug", "algorithm", "refactor"]
        bm25_threshold: 0.1
        case_sensitive: false
      - name: urgent_keywords
        operator: OR
        method: ngram
        keywords: ["urgent", "immediate", "asap", "emergency"]
        ngram_threshold: 0.4
        ngram_arity: 3
        case_sensitive: false

Use plain keyword lists for simple matching, then add method: bm25 or method: ngram when exact text matching becomes too brittle.