深度研究使用教程

Java

• 添加依赖

  <dependency>
          <groupId>com.aliyun.opensearch</groupId>
          <artifactId>aliyun-sdk-opensearch</artifactId>
          <version>6.0.0</version>
  </dependency>

• 请求示例

  package com.aliyun.opensearch;
  
  import com.aliyun.opensearch.OpenSearchClient;
  import com.aliyun.opensearch.sdk.generated.OpenSearch;
  import com.aliyun.opensearch.sdk.generated.commons.OpenSearchClientException;
  import com.aliyun.opensearch.sdk.generated.commons.OpenSearchException;
  import com.aliyun.opensearch.sdk.generated.commons.OpenSearchResult;
  
  import java.util.HashMap;
  import java.util.Map;
  
  public class LLMSearch {
      private static String accesskey = System.getenv("ALIBABA_CLOUD_ACCESS_KEY_ID");
      private static String secret = System.getenv("ALIBABA_CLOUD_ACCESS_KEY_SECRET");
      
      private static String appName = "替换为应用名称";
      private static String host = "替换应用的API访问地址";
      private static String path = "/apps/%s/actions/multi-search";
  
      public static void main(String[] args) {
  
          String appPath = String.format(path, appName);
          //ApiReadTimeOut
          OpenSearch openSearch = new OpenSearch(accesskey, secret, host);
          openSearch.setTimeout(90000);
  
          OpenSearchClient openSearchClient = new OpenSearchClient(openSearch);
  
          Map<String, String> params = new HashMap<String, String>() {{
              put("format", "full_json");
              put("_POST_BODY", "{\"question\":{\"text\":\"最近杭州流行病趋势如何\",\"type\":\"TEXT\"},\"options\":{\"retrieve\":{\"entry\":{\"sf\":\"\",\"filter\":\"\"},\"image\":{\"sf\":\"\",\"dense_weight\":\"0.7\"},\"web_search\":{\"enable\":true},\"return_hits\":false,\"graph\":{\"enable\":true},\"doc\":{\"filter\":\"\",\"top_n\":5,\"sf\":\"\",\"dense_weight\":\"0.7\",\"formula\":\"\",\"operator\":\"AND\"},\"qp\":{\"query_extend\":false,\"query_extend_num\":5},\"rerank\":{\"enable\":true,\"model\":\"ops-bge-reranker-larger\"}},\"chat\":{\"stream\":true,\"enable_deep_research\":true,\"enable_deep_research\":false,\"model\":\"deepseek-v3\",\"agent\":{\"tools\":[],\"max_think_round\":10,\"think_process\":true,\"language\":\"CN\"},\"prompt_config\":{\"attitude\":\"normal\",\"rule\":\"detailed\",\"noanswer\":\"sorry\",\"language\":\"Chinese\",\"role\":false,\"role_name\":\"AI小助手\",\"out_format\":\"text\"},\"csi_level\":\"strict\",\"output_format\":\"markdown\",\"history_max\":\"\",\"link\":\"true\",\"rich_text_strategy\":\"inside_response\",\"enable_llm_knowledge\":true,\"model_generation\":\"\"}}}");
          }};
          try {
              OpenSearchResult openSearchResult = openSearchClient
                      .callAndDecodeResult(appPath, params, "POST");
              System.out.println("RequestID=" + openSearchResult.getTraceInfo().getRequestId());
              System.out.println(openSearchResult.getResult());
          } catch (
                  OpenSearchException e) {
              System.out.println("RequestID=" + e.getRequestId());
              System.out.println("ErrorCode=" + e.getCode());
              System.out.println("ErrorMessage=" + e.getMessage());
          } catch (
                  OpenSearchClientException e) {
              System.out.println("ErrorMessage=" + e.getMessage());
          }
      }
  }

curl

发起任务请求

curl --location '{host}/v3/openapi/apps/{app_group_identity}/actions/multi-search' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer {API Key}' \
--data '{
    "question": {
        "text": "最近杭州流行病趋势如何？", 
        "type": "TEXT"
    }, 
    "options": {
        "retrieve": {
            "entry": {"sf": "", "filter": ""}, 
            "image": {"sf": "", "dense_weight": "0.7"}, 
            "web_search": {"enable": true}, 
            "return_hits": false, 
            "graph": {"enable": true}, 
            "doc": {
                "filter": "", 
                "top_n": 5, 
                "sf": "", 
                "dense_weight": "0.7", 
                "formula": "", 
                "operator": "AND"
            }, 
            "qp": {"query_extend": false, "query_extend_num": 5}, 
            "rerank": {"enable": true, "model": "ops-bge-reranker-larger"}
        }, 
        "chat": {
            "stream": true, 
            "enable_deep_search": false, 
            "enable_deep_research": true, 
            "model": "deepseek-v3", 
            "agent": {
                "tools": [], 
                "max_think_round": 10, 
                "think_process": true, 
                "language": "CN"
            }, 
            "prompt_config": {
                "attitude": "normal", 
                "rule": "detailed", 
                "noanswer": "sorry", 
                "language": "Chinese", 
                "role": false, 
                "role_name": "AI小助手", 
                "out_format": "text"
            }, 
            "csi_level": "strict", 
            "output_format": "markdown", 
            "history_max": "", 
            "link": "true", 
            "rich_text_strategy": "inside_response", 
            "enable_llm_knowledge": true, 
            "model_generation": ""
        }
    }
}'