new feature: Integration with kbdb Autonomous

.env.example

@@ -361,3 +361,25 @@ TOOL_POLICIES_PATH=./config/tool_policies.yaml
 SKIP_RAG_WHEN_MCP_SUFFICIENT=true
 MCP_TOOL_CACHE_ENABLED=true
 MCP_TOOL_CACHE_TTL_SECONDS=60
+
+###############################################################################
+# RAG provider selection (mutually exclusive at runtime)
+###############################################################################
+# standard = RAG original do agent_framework_oci (default, backward compatible)
+# kbdb     = KBDB enterprise via PKG_KB_SERVING.SEARCH_KNOWLEDGE_BASE
+RAG_PROVIDER=kbdb
+
+# Somente usados quando RAG_PROVIDER=kbdb. Se vazios, credenciais caem para ADB_*.
+KBDB_DB_USER=<DB_USER>
+KBDB_DB_PASSWORD=<DB_PASSWORD>
+KBDB_DB_DSN=db_dsn_high
+KBDB_DB_WALLET_LOCATION=/ORACLE/Wallet_kbdb
+KBDB_DB_WALLET_PASSWORD=<DB_WALLET_PASSWORD>
+KBDB_SEARCH_TYPE=hybrid
+KBDB_NODE_EXPANSION=true
+KBDB_NODE_MAX_RELATED=8
+KBDB_GRAPH_CROSS_REF=false
+KBDB_MAX_CROSS_REF_HOPS=1
+KBDB_DOCUMENT_TYPE=customer_safe
+KBDB_METADATA_JSON=
+KBDB_MIN_SCORE=0.5