agent/docs/intent-router-mvp.md

DOCS Intent Router MVP

Supported Intents

• DOCS_QA.API_METHOD_EXPLAIN
• DOCS_DISCOVERY.LIST_API_METHODS
• DOCS_DISCOVERY.FIND_DOCUMENTS_BY_DOMAIN
• DOCS_GENERATION.GENERATE_OPENAPI
• DOCS_FALLBACK.GENERAL_DOCS_QA

Routing Flow

1. Stage A: deterministic pre-routing нормализует запрос, извлекает anchors и scope, считает rule-based confidence.
2. Stage B: confidence gating пропускает high-confidence кейсы напрямую и эскалирует ambiguous/weak запросы в LLM.
3. Stage C: LLM classifier выбирает только один из 5 MVP саб-интентов и возвращает строгий JSON.
4. После выбора саб-интента router всегда прикрепляет декларативный retrieval_plan.

Confidence And Escalation

• >= 0.8 и без конфликтующих сигналов: routing_mode=deterministic.
• Ниже порога, при пересечении интентов, слабых anchors или коротком неоднозначном запросе: routing_mode=llm_assisted.
• Если LLM недоступен или вернул невалидный класс: routing_mode=llm_fallback c fallback в GENERAL_DOCS_QA.

Retrieval Plan Mapping

• API_METHOD_EXPLAIN -> docs_api_method_explain_v1
• LIST_API_METHODS -> docs_list_api_methods_v1
• FIND_DOCUMENTS_BY_DOMAIN -> docs_find_documents_by_domain_v1
• GENERATE_OPENAPI -> docs_generate_openapi_v1
• GENERAL_DOCS_QA -> docs_general_docs_qa_v1

retrieval_plan хранится декларативно в src/app/modules/agent/intent_router_v2/docs_mvp/retrieval_plans.py, а legacy retrieval_spec.filters обогащается теми же anchors и scope для совместимости с текущим runtime.