Ontos-AI · EricNGOntos · May 13, 2026 · May 13, 2026
diff --git a/apps/api/.env.example b/apps/api/.env.example
@@ -94,6 +94,10 @@ RETRIEVAL_WALLET_PER_RETRIEVE_STEP_BUDGET=40000
 RETRIEVAL_WALLET_PER_SYNTHESIZE_STEP_BUDGET=6000
 RETRIEVAL_WORKFLOW_PARALLEL_MAX=3
 
+# Agentic retrieval (LLM-driven hierarchical navigation).
+# Set to false to fall back to legacy 3-channel RRF mode.
+RETRIEVAL_AGENTIC_ENABLED=true
+
 # File handling defaults
 SUPPORTED_EXTENSIONS=.doc,.docx,.pdf,.txt,.xls,.xlsx,.csv,.pptx,.jpg,.jpeg,.png,.md
 MAX_FILE_SIZE=104857600
@@ -128,4 +132,4 @@ ILOVEAPI_TIMEOUT=120
 
 # Legacy parser compatibility fields.
 ALL_DF_COLS=content,path,type,length,keywords,summary,know_id,tokens,connectto,addtime,page_nums
-SPLIT_CHAR=-->
+SPLIT_CHAR=/
diff --git a/apps/worker/.env.example b/apps/worker/.env.example
@@ -94,6 +94,10 @@ RETRIEVAL_WALLET_PER_RETRIEVE_STEP_BUDGET=40000
 RETRIEVAL_WALLET_PER_SYNTHESIZE_STEP_BUDGET=6000
 RETRIEVAL_WORKFLOW_PARALLEL_MAX=3
 
+# Agentic retrieval (LLM-driven hierarchical navigation).
+# Set to false to fall back to legacy 3-channel RRF mode.
+RETRIEVAL_AGENTIC_ENABLED=true
+
 # Required for specific features: billing and analytics
 BILLING_ENABLED=false
 STRIPE_SECRET_KEY=
@@ -118,5 +122,5 @@ MAX_FILE_SIZE=104857600
 
 # Legacy parser compatibility fields.
 ALL_DF_COLS=content,path,type,length,keywords,summary,know_id,tokens,connectto,addtime,page_nums
-SPLIT_CHAR=-->
+SPLIT_CHAR=/
 
diff --git a/docs/agentic-rag-audit-20260513.md b/docs/agentic-rag-audit-20260513.md
diff --git a/docs/external-services.md b/docs/external-services.md
diff --git a/docs/testing-guidance.md b/docs/testing-guidance.md
diff --git a/packages/shared-python/shared/services/retrieval/app_service.py b/packages/shared-python/shared/services/retrieval/app_service.py
@@ -1100,7 +1100,7 @@ async def run_retrieval_query(
         return await _to_public_response(response)
 
     # ══ Route: agentic (unified workflow) vs legacy ══
-    _agentic_enabled = os.environ.get('RETRIEVAL_AGENTIC_ENABLED', 'false') == 'true'
+    _agentic_enabled = os.environ.get('RETRIEVAL_AGENTIC_ENABLED', 'true') == 'true'
     if _agentic_enabled:
         # ── Unified agentic path via WorkflowOrchestrator ──
         # Simple queries: planner returns a single-step plan (no decomposition).

diff --git a/packages/shared-python/shared/tests/test_workflow_orchestrator.py b/packages/shared-python/shared/tests/test_workflow_orchestrator.py
diff --git a/packages/shared-python/shared/tests/test_workflow_planner.py b/packages/shared-python/shared/tests/test_workflow_planner.py