minions-ai-agents/docs/tasks/athena/athena_task_2_2_semantic_router.md

Task 2.2: Roteador Semântico (Implementação)

Contexto: Gateway e Governança

Objetivo

Implementar lógica de roteamento e detecção de OOD (Out-of-Domain).

Dependências

• Task 1.1 (Configuração do Índice Qdrant)

Saída Esperada

• src/governance/router.py: Módulo Python com a lógica de roteamento.

Instruções

1. Criar Classe SemanticRouter: Implementar a classe SemanticRouter em src/governance/router.py.
2. Implementar route_intent: Criar o método route_intent(query: str) -> dict.
3. Busca Vetorial: Realizar busca do vetor mais próximo na coleção routing_index do Qdrant.
4. Lógica de Decisão:
   • Se o score de similaridade for menor que ROUTING_THRESHOLD: Retornar {"target": "OOD", "reason": "Low confidence"}.
   • Se o score for maior ou igual ao threshold: Retornar {"target": payload.target_crew} (nome da crew encontrada no payload).