33 lines
1.9 KiB
Markdown
33 lines
1.9 KiB
Markdown
# 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.
|