Update comments

applications/tests/Evaluation.Tests/appsettings.json

@@ -73,7 +73,14 @@
         "UseHybridSearch": false,
         // Helps improve relevance score consistency for search services with multiple replicas by
         // attempting to route a given request to the same replica for that session. Use this when
-        // favoring consistent scoring over lower latency.
+        // favoring consistent scoring over lower latency. Can adversely affect performance.
+        //
+        // Whether to use sticky sessions, which can help getting more consistent results.
+        // When using sticky sessions, a best-effort attempt will be made to target the same replica set.
+        // Be wary that reusing the same replica repeatedly can interfere with the load balancing of
+        // the requests across replicas and adversely affect the performance of the search service.
+        //
+        // See https://learn.microsoft.com/rest/api/searchservice/documents/search-post?view=rest-searchservice-2024-07-01&tabs=HTTP#request-body
         "UseSessionId": false
       },
       "OpenAI": {

examples/002-dotnet-Serverless/appsettings.json

@@ -73,7 +73,14 @@
         "UseHybridSearch": false,
         // Helps improve relevance score consistency for search services with multiple replicas by
         // attempting to route a given request to the same replica for that session. Use this when
-        // favoring consistent scoring over lower latency.
+        // favoring consistent scoring over lower latency. Can adversely affect performance.
+        //
+        // Whether to use sticky sessions, which can help getting more consistent results.
+        // When using sticky sessions, a best-effort attempt will be made to target the same replica set.
+        // Be wary that reusing the same replica repeatedly can interfere with the load balancing of
+        // the requests across replicas and adversely affect the performance of the search service.
+        //
+        // See https://learn.microsoft.com/rest/api/searchservice/documents/search-post?view=rest-searchservice-2024-07-01&tabs=HTTP#request-body
         "UseSessionId": false
       },
       "OpenAI": {

examples/210-KM-without-builder/appsettings.json

@@ -251,7 +251,14 @@
         "UseHybridSearch": false,
         // Helps improve relevance score consistency for search services with multiple replicas by
         // attempting to route a given request to the same replica for that session. Use this when
-        // favoring consistent scoring over lower latency.
+        // favoring consistent scoring over lower latency. Can adversely affect performance.
+        //
+        // Whether to use sticky sessions, which can help getting more consistent results.
+        // When using sticky sessions, a best-effort attempt will be made to target the same replica set.
+        // Be wary that reusing the same replica repeatedly can interfere with the load balancing of
+        // the requests across replicas and adversely affect the performance of the search service.
+        //
+        // See https://learn.microsoft.com/rest/api/searchservice/documents/search-post?view=rest-searchservice-2024-07-01&tabs=HTTP#request-body
         "UseSessionId": false
       },
       "AzureAIDocIntel": {

examples/401-evaluation/appsettings.json

@@ -73,7 +73,14 @@
         "UseHybridSearch": false,
         // Helps improve relevance score consistency for search services with multiple replicas by
         // attempting to route a given request to the same replica for that session. Use this when
-        // favoring consistent scoring over lower latency.
+        // favoring consistent scoring over lower latency. Can adversely affect performance.
+        //
+        // Whether to use sticky sessions, which can help getting more consistent results.
+        // When using sticky sessions, a best-effort attempt will be made to target the same replica set.
+        // Be wary that reusing the same replica repeatedly can interfere with the load balancing of
+        // the requests across replicas and adversely affect the performance of the search service.
+        //
+        // See https://learn.microsoft.com/rest/api/searchservice/documents/search-post?view=rest-searchservice-2024-07-01&tabs=HTTP#request-body
         "UseSessionId": false
       },
       "OpenAI": {

extensions/AzureAISearch/AzureAISearch/AzureAISearchConfig.cs

@@ -34,7 +34,14 @@ public enum AuthTypes
     /// <summary>
     /// Helps improve relevance score consistency for search services with multiple replicas by
     /// attempting to route a given request to the same replica for that session. Use this when
-    /// favoring consistent scoring over lower latency.
+    /// favoring consistent scoring over lower latency. Can adversely affect performance.
+    ///
+    /// Whether to use sticky sessions, which can help getting more consistent results.
+    /// When using sticky sessions, a best-effort attempt will be made to target the same replica set.
+    /// Be wary that reusing the same replica repeatedly can interfere with the load balancing of
+    /// the requests across replicas and adversely affect the performance of the search service.
+    ///
+    /// See https://learn.microsoft.com/rest/api/searchservice/documents/search-post?view=rest-searchservice-2024-07-01&tabs=HTTP#request-body
     /// </summary>
     public bool UseSessionId { get; set; } = false;
 

service/Service/appsettings.json

@@ -280,7 +280,18 @@
         "APIKey": "",
         // Hybrid search is not enabled by default. Note that when using hybrid search
         // relevance scores are different, usually lower, than when using just vector search
-        "UseHybridSearch": false
+        "UseHybridSearch": false,
+        // Helps improve relevance score consistency for search services with multiple replicas by
+        // attempting to route a given request to the same replica for that session. Use this when
+        // favoring consistent scoring over lower latency. Can adversely affect performance.
+        //
+        // Whether to use sticky sessions, which can help getting more consistent results.
+        // When using sticky sessions, a best-effort attempt will be made to target the same replica set.
+        // Be wary that reusing the same replica repeatedly can interfere with the load balancing of
+        // the requests across replicas and adversely affect the performance of the search service.
+        //
+        // See https://learn.microsoft.com/rest/api/searchservice/documents/search-post?view=rest-searchservice-2024-07-01&tabs=HTTP#request-body
+        "UseSessionId": false
       },
       "AzureAIDocIntel": {
         // "APIKey" or "AzureIdentity".

service/tests/Core.FunctionalTests/appsettings.json

@@ -12,11 +12,7 @@
         "Auth": "AzureIdentity",
         "Endpoint": "https://<...>",
         "APIKey": "",
-        "UseHybridSearch": false,
-        // Helps improve relevance score consistency for search services with multiple replicas by
-        // attempting to route a given request to the same replica for that session. Use this when
-        // favoring consistent scoring over lower latency.
-        "UseSessionId": false
+        "UseHybridSearch": false
       },
       "LlamaSharp": {
         "TextModel": {