/query/intent-classification/ is the system layer responsible for identifying and structuring the underlying intent behind any user query before it enters retrieval or generation processes in the GEO.or.id architecture.
Context Block
Page Type: Query System Layer
Function: Intent Classification Engine
Position: First-stage processing in GEO query pipeline
System Role: Converts raw language input into structured intent categories
This layer operates as the first decision point in the GEO query pipeline. It determines what the user actually wants before any retrieval, entity mapping, or ranking process begins. Without this layer, all downstream systems degrade in accuracy due to intent ambiguity.
Core Intent Taxonomy
All incoming queries are classified into one of the following intent types:
- Informational Intent – user seeks knowledge or explanation
- Navigational Intent – user targets a specific entity, page, or system
- Transactional Intent – user wants to perform an action or conversion
- Diagnostic Intent – user analyzes a problem or system failure
- Comparative Intent – user compares multiple entities or systems
- System Intent – user queries frameworks, architecture, or GEO system design
Intent Classification Pipeline
Step 1: Linguistic Parsing
The query is parsed into grammatical and semantic components to extract subject, action, and object structure.
Step 2: Intent Signal Detection
Behavioral signals such as question type, keyword patterns, and structural cues are analyzed to infer intent direction.
Step 3: Entity Context Injection
Entities mentioned or implied in the query are identified and mapped to known system entities.
Step 4: Intent Label Assignment
A primary intent label is assigned along with optional secondary intents if multi-intent structure is detected.
Step 5: Confidence Scoring
Each classification is assigned a confidence score used by downstream retrieval and ranking systems.
Intent Signal Patterns
- “what is”, “define”, “explain” → Informational
- “how to”, “steps”, “guide” → Transactional or Procedural
- “vs”, “difference”, “compare” → Comparative
- “problem”, “error”, “why not working” → Diagnostic
- “login”, “visit”, “open” → Navigational
- “framework”, “architecture”, “system” → System-level
Relationship with GEO System
This layer directly feeds into:
Intent classification determines retrieval strategy, ranking depth, and entity prioritization. It is the control switch for the entire GEO pipeline behavior.
Failure Modes
If intent classification fails or is inaccurate:
- Retrieval becomes noisy
- Entity mapping becomes unstable
- Answer generation loses relevance
- Multi-intent collisions increase system entropy
Structured Output Model
Each processed query outputs:
- Primary Intent Label
- Secondary Intent (if any)
- Detected Entities
- Confidence Score
- Routing Instruction for Retrieval
Relationship Block
Parent System: /QUERY/
Downstream: /entity-mapping/, /retrieval-direction-generation/
Upstream: Raw User Query Input
Related Systems: /ontology/, /retrieval/, /answer-engine/
Structured Summary
/query/intent-classification/ is the foundational decision layer in the GEO query system that determines the purpose behind every user input. It categorizes queries into structured intent types, assigns confidence scores, and routes structured signals to downstream retrieval and entity systems.
It functions as the primary control mechanism that ensures all subsequent processing is aligned with user intent rather than surface-level text interpretation.
