Modular RAG - Query Analysis

Query Analysis
* Introduce Query Analysis Module
* Define QueryTransformer API and TranslationQueryTransformer implementation
* Define QueryExpander API and MultiQueryExpander implementation
* Support QueryTransformer in RetrievalAugmentationAdvisor (support for QueryExpander will be in the next PR together with the needed DocumentFuser API).

Improvements
* Refine Retrieval and Augmentation Modules for increased robustness
* Expand test coverage for both modules
* Define clone() method for ChatClient.Builder

Tests
* Introduce “spring-ai-integration-tests” for full-fledged integration tests
* Add integration tests for RAG modules
* Add integration tests for RAG advisor

Relates to #gh-1603

Signed-off-by: Thomas Vitale <[email protected]>

Author: ThomasVitale

spring-ai-core/src/main/java/org/springframework/ai/chat/client/advisor/RetrievalAugmentationAdvisor.java

@@ -80,7 +80,7 @@ public RetrievalAugmentationAdvisor(List<QueryTransformer> queryTransformers, Do
 		this.queryTransformers = queryTransformers;
 		this.documentRetriever = documentRetriever;
 		this.queryAugmentor = queryAugmentor != null ? queryAugmentor : ContextualQueryAugmentor.builder().build();
-		this.protectFromBlocking = protectFromBlocking != null ? protectFromBlocking : false;
+		this.protectFromBlocking = protectFromBlocking != null ? protectFromBlocking : true;
 		this.order = order != null ? order : 0;
 	}
 

spring-ai-integration-tests/src/test/resources/application.yml

@@ -3,6 +3,7 @@ spring:
     web-application-type: none
   ai:
     openai:
+      api-key: ${OPENAI_API_KEY}
       chat:
         options:
           model: gpt-4o-mini