feat: DashScopeChatModel add EnableSearch, To use web search (#169)

Author: yaohuitc

agentscope-core/src/main/java/io/agentscope/core/model/DashScopeChatModel.java

@@ -69,6 +69,7 @@ public class DashScopeChatModel extends ChatModelBase {
     private final String modelName;
     private final boolean stream;
     private final Boolean enableThinking; // nullable
+    private final Boolean enableSearch; // nullable
     private final GenerateOptions defaultOptions;
     private final String protocol; // HTTP or WEBSOCKET
     private final String baseUrl; // Optional custom base URL
@@ -105,6 +106,7 @@ private boolean requiresMultiModalConversationAPI() {
      * @param modelName the model name (e.g., "qwen-max", "qwen-vl-plus")
      * @param stream whether streaming should be enabled (ignored if enableThinking is true)
      * @param enableThinking whether thinking mode should be enabled (null for disabled)
+     * @param enableSearch whether search enhancement should be enabled (null for disabled)
      * @param defaultOptions default generation options (null for defaults)
      * @param protocol the protocol to use ("HTTP" or "WEBSOCKET", null for HTTP)
      * @param baseUrl custom base URL for DashScope API (null for default)
@@ -115,6 +117,7 @@ public DashScopeChatModel(
             String modelName,
             boolean stream,
             Boolean enableThinking,
+            Boolean enableSearch,
             GenerateOptions defaultOptions,
             String protocol,
             String baseUrl,
@@ -123,6 +126,7 @@ public DashScopeChatModel(
         this.modelName = modelName;
         this.stream = enableThinking != null && enableThinking ? true : stream;
         this.enableThinking = enableThinking;
+        this.enableSearch = enableSearch;
         this.defaultOptions =
                 defaultOptions != null ? defaultOptions : GenerateOptions.builder().build();
         this.protocol = protocol != null ? protocol : Protocol.HTTP.getValue();
@@ -431,6 +435,11 @@ private void applyModelSpecificOptions(
                 param.setIncrementalOutput(Boolean.TRUE);
             }
         }
+
+        // Model-specific settings for search mode
+        if (Boolean.TRUE.equals(enableSearch)) {
+            param.setEnableSearch(Boolean.TRUE);
+        }
     }
 
     /**
@@ -638,6 +647,7 @@ public static class Builder {
         private String modelName;
         private boolean stream = true;
         private Boolean enableThinking;
+        private Boolean enableSearch;
         private GenerateOptions defaultOptions = null;
         private String protocol = Protocol.HTTP.getValue();
         private String baseUrl;
@@ -699,6 +709,20 @@ public Builder enableThinking(Boolean enableThinking) {
             return this;
         }
 
+        /**
+         * Sets whether search enhancement should be enabled.
+         *
+         * <p>When enabled, the model can access internet search to provide more up-to-date
+         * and accurate responses.
+         *
+         * @param enableSearch true to enable search mode, false to disable, null for default (disabled)
+         * @return this builder instance
+         */
+        public Builder enableSearch(Boolean enableSearch) {
+            this.enableSearch = enableSearch;
+            return this;
+        }
+
         /**
          * Sets the default generation options.
          *
@@ -765,6 +789,7 @@ public DashScopeChatModel build() {
                     modelName,
                     stream,
                     enableThinking,
+                    enableSearch,
                     effectiveOptions,
                     protocol,
                     baseUrl,

agentscope-core/src/test/java/io/agentscope/core/model/DashScopeChatModelTest.java

@@ -248,6 +248,28 @@ void testThinkingModeConfiguration() {
         assertNotNull(normalModel);
     }
 
+    @Test
+    @DisplayName("Should handle search mode configuration")
+    void testSearchModeConfiguration() {
+        DashScopeChatModel searchEnabledModel =
+                DashScopeChatModel.builder()
+                        .apiKey(mockApiKey)
+                        .modelName("qwen-plus")
+                        .enableSearch(true)
+                        .build();
+
+        assertNotNull(searchEnabledModel);
+
+        DashScopeChatModel searchDisabledModel =
+                DashScopeChatModel.builder()
+                        .apiKey(mockApiKey)
+                        .modelName("qwen-plus")
+                        .enableSearch(false)
+                        .build();
+
+        assertNotNull(searchDisabledModel);
+    }
+
     @Test
     @DisplayName("Should create vision model with qwen-vl model name")
     void testVisionModelCreation() {