Call an agent application

Prerequisites

In the Model Studio console, enable your agent application and turn on the knowledge base switch. Then, publish the application.

Specify a retrieval scope

1. You can retrieve from a specific knowledge base in three ways:

   1. In your application, click Configure knowledge base to associate a specific knowledge base, and then publish the application.

   2. Do not associate a knowledge base in your application. Instead, pass the knowledge base ID in the rag_options parameter during the API call.

   3. Associate a knowledge base in your application and pass the knowledge base ID in the rag_options parameter during the API call.

      In this case, only the knowledge base passed in the API call is used for retrieval. For example, if your web-based agent application is linked to Knowledge Base A, but your API call specifies only Knowledge Base B, then only Knowledge Base B is retrieved, not Knowledge Base A.

   Obtain the knowledge base ID (pipeline_ids): You can find it on the Knowledge Base page. You can also obtain it from the Data.Id field in the response from the CreateIndex API call (for unstructured knowledge bases only).

   The knowledge base can be one already associated with your agent application, or one that is not yet associated.

   For example, you can use Bailian Series Mobile Product Introduction.docx as an unstructured data knowledge base file.

   Python

   Request example

   import os
   from http import HTTPStatus
   # We recommend DashScope SDK version >= 1.20.11
   from dashscope import Application
   response = Application.call(
       # If you have not set an environment variable, replace the next line with: api_key="sk-xxx". However, avoid hard-coding your API key in production code to reduce the risk of exposure.
       api_key=os.getenv("DASHSCOPE_API_KEY"), 
       app_id='YOUR_APP_ID',  # Replace YOUR_APP_ID with your actual application ID
       prompt='Please recommend a smartphone under ¥3,000',
       rag_options={
           "pipeline_ids": ["YOUR_PIPELINE_ID1","YOUR_PIPELINE_ID2"],  # Replace with actual knowledge base IDs, separated by commas
       }
   )
   
   if response.status_code != HTTPStatus.OK:
       print(f'request_id={response.request_id}')
       print(f'code={response.status_code}')
       print(f'message={response.message}')
       print(f'For more information, see https://help.aliyun.com/en/model-studio/developer-reference/error-code')
   else:
       print('%s\n' % (response.output.text))  # Process text-only output
       # print('%s\n' % (response.usage))

   Response example

   Based on your budget, I recommend the **Bailian Zephyr Z9**. Its reference price ranges from ¥2,499 to ¥2,799—well within your budget. It features a lightweight 6.4-inch 1080 × 2340 pixel display, 128 GB storage, and 6 GB RAM—ideal for everyday use. It also includes a 4,000 mAh battery and a 30× digital zoom lens, delivering strong performance for both photography and battery life. If you value portability and all-around functionality, the Bailian Zephyr Z9 is an excellent choice.

   Java

   Request example

   // We recommend DashScope SDK version >= 2.16.8
   import com.alibaba.dashscope.app.*;
   import com.alibaba.dashscope.exception.ApiException;
   import com.alibaba.dashscope.exception.InputRequiredException;
   import com.alibaba.dashscope.exception.NoApiKeyException;
   import java.util.Arrays;
   
   public class Main {
       public static void streamCall() throws NoApiKeyException, InputRequiredException {
           ApplicationParam param = ApplicationParam.builder()
                   // If you have not set an environment variable, replace the next line with: .apiKey("sk-xxx"). However, avoid hard-coding your API key in production code to reduce the risk of exposure.
                   .apiKey(System.getenv("DASHSCOPE_API_KEY"))
                   .appId("YOUR_APP_ID") // Replace with your actual application ID
                   .prompt("Please recommend a smartphone around ¥3,000")
                   .ragOptions(RagOptions.builder()
                           // Replace with actual knowledge base IDs, separated by commas
                           .pipelineIds(Arrays.asList("PIPELINES_ID1", "PIPELINES_ID2"))
                           .build())
                   .build();
   
           Application application = new Application();
           ApplicationResult result = application.call(param);
           System.out.printf("%s\n",
                   result.getOutput().getText());// Process text-only output
       }
   
       public static void main(String[] args) {
           try {
               streamCall();
           } catch (ApiException | NoApiKeyException | InputRequiredException e) {
               System.out.printf("Exception: %s", e.getMessage());
               System.out.println("For more information, see https://help.aliyun.com/en/model-studio/developer-reference/error-code");
           }
           System.exit(0);
       }
   }

   Response example

   Within a ¥3,000 budget, I recommend the **Bailian Zephyr Z9**, priced between ¥2,499 and ¥2,799—perfect for your needs. Key features include the following:
   
   - **Lightweight design**: A 6.4-inch screen ideal for one-handed use.
   - **Balanced performance**: 128 GB storage and 6 GB RAM—enough for daily tasks.
   - **All-day battery**: A 4,000 mAh battery meets typical usage needs.
   - **Strong camera**: A 30× digital zoom lens captures distant details.
   
   If you prioritize gaming or have other special requirements, let me know—I’ll tailor my suggestions!

   HTTP

   curl

   Request example

   curl -X POST https://dashscope.aliyuncs.com/api/v1/apps/{YOUR_APP_ID}/completion \
   --header "Authorization: Bearer $DASHSCOPE_API_KEY" \
   --header 'Content-Type: application/json' \
   --data '{
       "input": {
           "prompt": "Please recommend a smartphone under ¥3,000"
       },
       "parameters":  {
                       "rag_options" : {
                       "pipeline_ids":["YOUR_PIPELINE_ID1"]}
       },
       "debug": {}
   }'

   Replace YOUR_APP_ID with your actual application ID. Replace YOUR_PIPELINE_ID1 with your actual knowledge base ID.

   Response example

   {"output":{"finish_reason":"stop","session_id":"d1208af96f9a4d8390e9b29e86f0623c",
   "text":"Within a ¥3,000 price range, I recommend the Bailian Zephyr Z9.\nThis phone is priced between ¥2,499 and ¥2,799—perfectly matching your budget.\nIt features a lightweight 6.4-inch 1080 × 2340 pixel display, paired with 128 GB of storage and 6 GB of RAM—enough for everyday apps and multitasking.\nPlus, it has a 4,000 mAh battery to last you all day, and a 30× digital zoom lens to capture life's little details.\nIn short, the Bailian Zephyr Z9 delivers great value, design, and features."},
   "usage":{"models":[{"output_tokens":158,"model_id":"qwen-max","input_tokens":1025}]},
   "request_id":"eb2d40f7-bede-9d48-88dc-08abdcdd0351"}% 

   PHP

   Request example

   <?php
   # If you have not set an environment variable, replace the next line with: $api_key="sk-xxx". However, avoid hard-coding your API key in production code to reduce the risk of exposure.
   $api_key = getenv("DASHSCOPE_API_KEY");
   $application_id = 'YOUR_APP_ID'; // Replace with your actual application ID
   
   $url = "https://dashscope.aliyuncs.com/api/v1/apps/$application_id/completion";
   
   // Build request data
   $data = [
       "input" => [
           'prompt' => 'Please recommend a smartphone under ¥3,000'
       ],
       "parameters" => [
           'rag_options' => [
               'pipeline_ids' => ['YOUR_PIPELINE_ID1','YOUR_PIPELINE_ID2']//Replace with your actual knowledge base IDs, separated by commas
           ]
       ]
   ];
   // Encode data as JSON
   $dataString = json_encode($data);
   
   // Check if json_encode succeeded
   if (json_last_error() !== JSON_ERROR_NONE) {
       die("JSON encoding failed with error: " . json_last_error_msg());
   }
   
   // Initialize cURL session
   $ch = curl_init($url);
   
   // Set cURL options
   curl_setopt($ch, CURLOPT_CUSTOMREQUEST, "POST");
   curl_setopt($ch, CURLOPT_POSTFIELDS, $dataString);
   curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
   curl_setopt($ch, CURLOPT_HTTPHEADER, [
       'Content-Type: application/json',
       'Authorization: Bearer ' . $api_key
   ]);
   
   // Execute request
   $response = curl_exec($ch);
   
   // Check if cURL execution succeeded
   if ($response === false) {
       die("cURL Error: " . curl_error($ch));
   }
   
   // Get HTTP status code
   $status_code = curl_getinfo($ch, CURLINFO_HTTP_CODE);
   // Close cURL session
   curl_close($ch);
   // Decode response data
   $response_data = json_decode($response, true);
   // Process response
   if ($status_code == 200) {
       if (isset($response_data['output']['text'])) {
           echo "{$response_data['output']['text']}\n";
       } else {
           echo "No text in response.\n";
       }
   }else {
       if (isset($response_data['request_id'])) {
           echo "request_id={$response_data['request_id']}\n";}
       echo "code={$status_code}\n";
       if (isset($response_data['message'])) {
           echo "message={$response_data['message']}\n";} 
       else {
           echo "message=Unknown error\n";}
   }
   ?>

   Response example

   Within a ¥3,000 budget, I recommend the **Bailian Zephyr Z9**, priced between ¥2,499 and ¥2,799—ideal for your needs. It features a lightweight design with a 6.4-inch 1080 × 2340 pixel display, 128 GB storage, and 6 GB RAM—great for everyday use. Its 4,000 mAh battery lasts all day, and its 30× digital zoom lens captures distant details—lightweight, powerful, and versatile.

   Node.js

   Install dependencies:

   npm install axios

   Request example

   const axios = require('axios');
   async function callDashScope() {
       // If you have not set an environment variable, replace the next line with: apiKey='sk-xxx'. However, avoid hard-coding your API key in production code to reduce the risk of exposure.
       const apiKey = process.env.DASHSCOPE_API_KEY;
       const appId = 'YOUR_APP_ID';//Replace with your actual application ID
   
       const url = `https://dashscope.aliyuncs.com/api/v1/apps/${appId}/completion`;
   
       const data = {
           input: {
               prompt: "Please recommend a smartphone under ¥3,000"
           },
           parameters: {
               rag_options:{
                   pipeline_ids:['YOUR_PIPELINE_ID1','YOUR_PIPELINE_ID2']  // Replace with your actual knowledge base IDs, separated by commas
               }
           },
           debug: {}
       };
   
       try {
           const response = await axios.post(url, data, {
               headers: {
                   'Authorization': `Bearer ${apiKey}`,
                   'Content-Type': 'application/json'
               }
           });
   
           if (response.status === 200) {
               console.log(`${response.data.output.text}`);
           } else {
               console.log(`request_id=${response.headers['request_id']}`);
               console.log(`code=${response.status}`);
               console.log(`message=${response.data.message}`);
           }
       } catch (error) {
           console.error(`Error calling DashScope: ${error.message}`);
           if (error.response) {
               console.error(`Response status: ${error.response.status}`);
               console.error(`Response data: ${JSON.stringify(error.response.data, null, 2)}`);
           }
       }
   }
   
   callDashScope();

   Response example

   Within a ¥3,000 budget, I recommend the **Bailian Zephyr Z9**, priced at ¥3,999–¥4,299. But with promotions or discounts, it may fall within your budget.
   
   ### Bailian Zephyr Z9 — Lightweight and portable
   - **Screen**: 6.4-inch, 1080 × 2340 pixels
   - **Storage & RAM**: 128 GB / 6 GB RAM
   - **Battery**: 4,000 mAh
   - **Camera**: 30× digital zoom lens
   
   This phone is lightweight and portable—ideal for everyday use—and offers solid battery life. If you value cost-effectiveness and daily usability, the Bailian Zephyr Z9 is a great pick.
   
   If your budget is strict, watch for e-commerce promotions—or consider similar phones from other brands. Hope this helps!

   C#

   Request example

   using System.Text;
   
   class Program
   {
       static async Task Main(string[] args)
       {
           // If you have not set an environment variable, replace the next line with: apiKey="sk-xxx". However, avoid hard-coding your API key in production code to reduce the risk of exposure.
           string apiKey = Environment.GetEnvironmentVariable("DASHSCOPE_API_KEY")?? throw new InvalidOperationException("DASHSCOPE_API_KEY environment variable is not set.");;
           string appId = "YOUR_APP_ID";// Replace with your actual application ID
           // Replace YOUR_PIPELINE_ID1 with your actual knowledge base ID
           if (string.IsNullOrEmpty(apiKey))
           {
               Console.WriteLine("Make sure DASHSCOPE_API_KEY is set.");
               return;
           }
   
           string url = $"https://dashscope.aliyuncs.com/api/v1/apps/{appId}/completion";
           
           using (HttpClient client = new HttpClient())
           {
               client.DefaultRequestHeaders.Add("Authorization", $"Bearer {apiKey}");
               string jsonContent = $@"{{
                   ""input"": {{
                       ""prompt"": ""Please recommend a smartphone under ¥3,000""
                   }},
                   ""parameters"": {{
                       ""rag_options"" : {{
                           ""pipeline_ids"":[""YOUR_PIPELINE_ID1""]
                       }}
                   }},
                   ""debug"": {{}}
               }}";
   
               HttpContent content = new StringContent(jsonContent, Encoding.UTF8, "application/json");
   
               try
               {
                   HttpResponseMessage response = await client.PostAsync(url, content);
   
                   if (response.IsSuccessStatusCode)
                   {
                       string responseBody = await response.Content.ReadAsStringAsync();
                       Console.WriteLine(responseBody);
                   }
                   else
                   {
                       Console.WriteLine($"Request failed with status code: {response.StatusCode}");
                       string responseBody = await response.Content.ReadAsStringAsync();
                       Console.WriteLine(responseBody);
                   }
               }
               catch (Exception ex)
               {
                   Console.WriteLine($"Error calling DashScope: {ex.Message}");
               }
           }
       }
   }

   Response example

   {
       "output": {
           "finish_reason": "stop",
           "session_id": "2344ddc540ec4c5fa110b92d813d3807",
           "text": "Based on your budget, I recommend the **Bailian Zephyr Z9**. Its reference price ranges from ¥2,499 to ¥2,799—within your budget. It features a 6.4-inch 1080 × 2340 pixel display, 128 GB storage, and 6 GB RAM—enough for everyday use. Plus, its 4,000 mAh battery lasts all day, and its 30× digital zoom lens captures distant scenes. This is a lightweight, versatile option."
       },
       "usage": {
           "models": [
               {
                   "output_tokens": 121,
                   "model_id": "qwen-max",
                   "input_tokens": 1841
               }
           ]
       },
       "request_id": "99fceedf-2034-9fb0-aaad-9c837136801f"
   }

   Go

   Request example

   package main
   
   import (
   	"bytes"
   	"encoding/json"
   	"fmt"
   	"io"
   	"net/http"
   	"os"
   )
   
   func main() {
   	// If you have not set an environment variable, replace the next line with: apiKey := "sk-xxx". However, avoid hard-coding your API key in production code to reduce the risk of exposure.
   	apiKey := os.Getenv("DASHSCOPE_API_KEY")
   	appId := "YOUR_APP_ID" // Replace with your actual application ID
   
   	if apiKey == "" {
   		fmt.Println("Make sure DASHSCOPE_API_KEY is set.")
   		return
   	}
   
   	url := fmt.Sprintf("https://dashscope.aliyuncs.com/api/v1/apps/%s/completion", appId)
   
   	// Build request body
   	requestBody := map[string]interface{}{
   		"input": map[string]string{
   			"prompt": "Please recommend a smartphone under ¥3,000",
   		},
   		"parameters": map[string]interface{}{
   			"rag_options": map[string]interface{}{
   				"pipeline_ids": []string{"YOUR_PIPELINE_ID1"}, // Replace with your actual knowledge base ID
   			},
   		},
   		"debug": map[string]interface{}{},
   	}
   
   	jsonData, err := json.Marshal(requestBody)
   	if err != nil {
   		fmt.Printf("Failed to marshal JSON: %v\n", err)
   		return
   	}
   
   	// Create HTTP POST request
   	req, err := http.NewRequest("POST", url, bytes.NewBuffer(jsonData))
   	if err != nil {
   		fmt.Printf("Failed to create request: %v\n", err)
   		return
   	}
   
   	// Set request headers
   	req.Header.Set("Authorization", "Bearer "+apiKey)
   	req.Header.Set("Content-Type", "application/json")
   
   	// Send request
   	client := &http.Client{}
   	resp, err := client.Do(req)
   	if err != nil {
   		fmt.Printf("Failed to send request: %v\n", err)
   		return
   	}
   	defer resp.Body.Close()
   
   	// Read response
   	body, err := io.ReadAll(resp.Body)
   	if err != nil {
   		fmt.Printf("Failed to read response: %v\n", err)
   		return
   	}
   
   	// Process response
   	if resp.StatusCode == http.StatusOK {
   		fmt.Println("Request successful:")
   		fmt.Println(string(body))
   	} else {
   		fmt.Printf("Request failed with status code: %d\n", resp.StatusCode)
   		fmt.Println(string(body))
   	}
   }
   

   Response example

   {
       "output": {
           "finish_reason": "stop",
           "session_id": "fadbb4d1fe094ade88985620363506e6",
           "text": "Based on your budget, I recommend the **Bailian Zephyr Z9**, priced between ¥2,499 and ¥2,799—ideal for a sub-¥3,000 budget. It features a lightweight 6.4-inch 1080 × 2340 pixel display, 128 GB storage, and 6 GB RAM—meeting everyday needs. Its 4,000 mAh battery ensures all-day use, and its 30× digital zoom lens captures distant details—a high-value choice."
       },
       "usage": {
           "models": [
               {
                   "output_tokens": 119,
                   "model_id": "qwen-max",
                   "input_tokens": 1055
               }
           ]
       },
       "request_id": "3a755dd7-58a0-9a5e-8a07-b85b1db838a6"
   }

2. Retrieve from a specific unstructured data document: Pass the knowledge base ID, document ID, document tags, or document metadata (key-value pairs) in the rag_options parameter.

   Document IDs, tags, and metadata apply only to unstructured data documents.

   • How to obtain them:

     • Document ID (file_ids): You can find the ID in the document list on the Application Data page. You can also obtain it from the ID returned by the AddFile API after you import a document.

     • Document tags: You can view the tags on the Application Data page for unstructured documents. You can also obtain them using the DescribeFile API.

     • Document metadata: On the Knowledge Base page, open a knowledge base and view the metadata (Meta info) for unstructured documents.

   • You can pass multiple document IDs. However, only documents with built indexes are supported.

   • To use a document ID, you must also pass the ID of the knowledge base to which it belongs. Otherwise, the retrieval fails.

   • Retrieval is performed only on the specified documents. For example, if your web-based agent application references Knowledge Base A, but your API call specifies a document ID and its knowledge base ID (Knowledge Base B), then only the documents from Knowledge Base B are retrieved, not the documents from Knowledge Base A.

     For example, you can use Bailian Series Mobile Product Introduction.docx as an unstructured data knowledge base file.

     Python

     Request example

     import os
     from http import HTTPStatus
     # We recommend DashScope SDK version >= 1.20.11
     from dashscope import Application
     response = Application.call(
         # If you have not set an environment variable, replace the next line with: api_key="sk-xxx". However, avoid hard-coding your API key in production code to reduce the risk of exposure.
         api_key=os.getenv("DASHSCOPE_API_KEY"),
         app_id='YOUR_APP_ID',  # Replace YOUR_APP_ID with your actual application ID
         prompt='Please recommend a smartphone under ¥3,000',
         rag_options={
             "pipeline_ids": ["YOUR_PIPELINE_ID1", "YOUR_PIPELINE_ID2"],  # Replace with actual knowledge base IDs, separated by commas
             "file_ids": ["YOUR_FILE_ID1", "YOUR_FILE_ID2"],  # Replace with actual unstructured document IDs, separated by commas
             "metadata_filter": {  # Document metadata key-value pairs, separated by commas
                 "key1": "value1",
                 "key2": "value2"
             },
             "tags": ["tag1", "tag2"]  # Document tags, separated by commas
         }
     )
     
     if response.status_code != HTTPStatus.OK:
         print(f'request_id={response.request_id}')
         print(f'code={response.status_code}')
         print(f'message={response.message}')
         print(f'For more information, see https://help.aliyun.com/en/model-studio/developer-reference/error-code')
     else:
         print('%s\n' % (response.output))

     Response example

     {
         "text": "Within a ¥3,000 budget, I recommend the **Bailian Zephyr Z9**. Key features include the following:\n\n- **Screen**: 6.4-inch, 1080 × 2340 pixels—ideal for daily use and entertainment.\n- **Memory & storage**: 6 GB RAM + 128 GB storage—enough for most users’ smoothness and storage needs.\n- **Battery**: 4,000 mAh—lasts all day.\n- **Camera**: 30× digital zoom lens—captures distant details.\n- **Other features**: Lightweight and portable—easy to carry.\n\nIts reference price is ¥2,499–¥2,799—perfect for your budget and great value. Hope this helps!",
         "finish_reason": "stop",
         "session_id": "10bdea3d1435406aad8750538b701bee",
         "thoughts": null,
         "doc_references": null
     }

     Java

     Request example

     // We recommend DashScope SDK version >= 2.16.8
     import com.alibaba.dashscope.app.*;
     import com.alibaba.dashscope.exception.ApiException;
     import com.alibaba.dashscope.exception.InputRequiredException;
     import com.alibaba.dashscope.exception.NoApiKeyException;
     import com.google.gson.JsonObject;
     import java.util.Arrays;
     
     public class Main {
         public static void streamCall() throws NoApiKeyException, InputRequiredException {
             JsonObject metadataFilter = new JsonObject();
             metadataFilter.addProperty("key1", "value1"); // Metadata key-value pair
             metadataFilter.addProperty("key2", "value2"); // Add more with repeated addProperty calls
             ApplicationParam param = ApplicationParam.builder()
                     // If you have not set an environment variable, replace the next line with: .apiKey("sk-xxx"). However, avoid hard-coding your API key in production code to reduce the risk of exposure.
                     .apiKey(System.getenv("DASHSCOPE_API_KEY"))
                     .appId("YOUR_APP_ID") // Replace with your actual application ID
                     .prompt("Please recommend a smartphone around ¥3,000")
                     .ragOptions(RagOptions.builder()
                             .pipelineIds(Arrays.asList("PIPELINES_ID1","PIPELINES_ID2"))  // Replace with actual knowledge base IDs, separated by commas
                             .fileIds(Arrays.asList("FILE_ID1", "FILE_ID2"))  // Replace with actual unstructured document IDs, separated by commas
                             .tags(Arrays.asList("tags1", "tags2")) // Replace with actual document tag IDs, separated by commas
                             .metadataFilter(metadataFilter)
                             .build())
                     .build();
     
             Application application = new Application();
             ApplicationResult result = application.call(param);
             System.out.printf("%s\n",
                     result.getOutput().getText());// Process text-only output
         }
     
         public static void main(String[] args) {
             try {
                 streamCall();
             } catch (ApiException | NoApiKeyException | InputRequiredException e) {
                 System.out.printf("Exception: %s", e.getMessage());
                 System.out.println("For more information, see https://help.aliyun.com/en/model-studio/developer-reference/error-code");
             }
             System.exit(0);
         }
     }

     Response example

     Based on your budget, I recommend the **Bailian Zephyr Z9**, priced between ¥2,499 and ¥2,799—ideal for a ¥3,000 budget.
     
     ### Bailian Zephyr Z9 highlights:
     - **Screen**: 6.4-inch, 1080 × 2340 pixels—crisp and clear visuals.
     - **Storage & RAM**: 128 GB storage and 6 GB RAM—enough for daily tasks.
     - **Battery**: 4,000 mAh—lasts all day.
     - **Camera**: 30× digital zoom lens—captures distant details.
     - **Design**: Lightweight and portable—ideal for fashion-conscious users.
     
     This phone offers great value and balanced specs—and looks stunning too. A top pick in this price range. Hope this helps! Let me know if you need more details or have other questions.

     HTTP

     curl

     Request example

     curl -X POST https://dashscope.aliyuncs.com/api/v1/apps/{YOUR_APP_ID}/completion \
     --header "Authorization: Bearer $DASHSCOPE_API_KEY" \
     --header 'Content-Type: application/json' \
     --data '{
         "input": {
             "prompt": "Please recommend a smartphone around ¥3,000"
         },
         "parameters":  {
                         "rag_options" : {
                         "pipeline_ids":["YOUR_PIPELINE_ID1"],
                         "file_ids":["YOUR_FILE_ID1"],
                         "metadata_filter":{
                         "name":"Alice"},
                         "tags":"smartphone"
                         }
         },
         "debug": {}
     }'

     Replace YOUR_APP_ID with your actual application ID. Replace YOUR_PIPELINE_ID1 with your actual knowledge base ID. Replace YOUR_FILE_ID1 with your actual unstructured document ID. Replace the metadata key-value pairs with your actual metadata.

     Response example

     {"output":{"finish_reason":"stop","session_id":"f2f114864dd24a458f923aab0ec99a1d",
     "text":"Based on your budget, I recommend the “Tongyi Vivid 7”. It features a 6.5-inch 1080 × 2400 pixel full-screen display and AI-powered smart photography—capturing professional-grade photos with rich color and detail.\n\nHardware includes 8 GB RAM and 128 GB storage—ensuring smooth operation. Its 4,500 mAh battery meets typical daily needs.\n\nSide-mounted fingerprint unlocking is both convenient and secure. Its reference price is ¥2,999–¥3,299—within your budget."},
     "usage":{"models":[{"output_tokens":141,"model_id":"qwen-plus","input_tokens":1610}]},
     "request_id":"d815d3d1-8cef-95e2-b895-89fc8d0e0f84"}%      

     PHP

     Request example

     <?php
     # If you have not set an environment variable, replace the next line with: $api_key="sk-xxx". However, avoid hard-coding your API key in production code to reduce the risk of exposure.
     $api_key = getenv("DASHSCOPE_API_KEY");
     $application_id = 'YOUR_APP_ID'; // Replace with your actual application ID
     
     $url = "https://dashscope.aliyuncs.com/api/v1/apps/$application_id/completion";
     
     // Build request data
     $data = [
         "input" => [
             'prompt' => 'Please recommend a smartphone under ¥3,000'
         ],
         "parameters" => [
             'rag_options' => [
                 'pipeline_ids' => ['YOUR_PIPELINE_ID1','YOUR_PIPELINE_ID2'],// Replace with your actual knowledge base IDs, separated by commas
                 'file_ids' => ['YOUR_FILE_ID1','YOUR_FILE_ID2'],// Replace with your actual document IDs, separated by commas
                 "metadata_filter" => [ // Metadata key-value pairs
                     "key1" => "value1",
                     "key2" => "value2"
                 ],
                 "tags" => ["tag1", "tag2"] // Document tags
             ]
         ]
     ];
     // Encode data as JSON
     $dataString = json_encode($data);
     
     // Check if json_encode succeeded
     if (json_last_error() !== JSON_ERROR_NONE) {
         die("JSON encoding failed with error: " . json_last_error_msg());
     }
     
     // Initialize cURL session
     $ch = curl_init($url);
     
     // Set cURL options
     curl_setopt($ch, CURLOPT_CUSTOMREQUEST, "POST");
     curl_setopt($ch, CURLOPT_POSTFIELDS, $dataString);
     curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
     curl_setopt($ch, CURLOPT_HTTPHEADER, [
         'Content-Type: application/json',
         'Authorization: Bearer ' . $api_key
     ]);
     
     // Execute request
     $response = curl_exec($ch);
     
     // Check if cURL execution succeeded
     if ($response === false) {
         die("cURL Error: " . curl_error($ch));
     }
     
     // Get HTTP status code
     $status_code = curl_getinfo($ch, CURLINFO_HTTP_CODE);
     // Close cURL session
     curl_close($ch);
     // Decode response data
     $response_data = json_decode($response, true);
     // Process response
     if ($status_code == 200) {
         if (isset($response_data['output']['text'])) {
             echo "{$response_data['output']['text']}\n";
         } else {
             echo "No text in response.\n";
         }
     }else {
         if (isset($response_data['request_id'])) {
             echo "request_id={$response_data['request_id']}\n";}
         echo "code={$status_code}\n";
         if (isset($response_data['message'])) {
             echo "message={$response_data['message']}\n";} 
         else {
             echo "message=Unknown error\n";}
     }
     ?>

     Response example

     Based on your budget, I recommend the **Bailian Zephyr Z9**, priced between ¥2,499 and ¥2,799—ideal for a sub-¥3,000 budget. It features a lightweight 6.4-inch 1080 × 2340 pixel design, 128 GB storage, and 6 GB RAM—meeting everyday needs. Its 4,000 mAh battery lasts all day, and its 30× digital zoom lens captures distant details—a lightweight, powerful choice.

     Node.js

     Install dependencies:

     npm install axios

     Request example

     const axios = require('axios');
     async function callDashScope() {
         // If you have not set an environment variable, replace the next line with: apiKey='sk-xxx'. However, avoid hard-coding your API key in production code to reduce the risk of exposure.
         const apiKey = process.env.DASHSCOPE_API_KEY;
         const appId = 'YOUR_APP_ID';//Replace with your actual application ID
     
         const url = `https://dashscope.aliyuncs.com/api/v1/apps/${appId}/completion`;
     
         const data = {
             input: {
                 prompt: "Please recommend a smartphone under ¥3,000"
             },
             parameters: {
                 rag_options:{
                     pipeline_ids:['YOUR_PIPELINE_ID1','YOUR_PIPELINE_ID2'], // Replace with your actual knowledge base IDs, separated by commas
                     file_ids:['YOUR_FILE_ID1','YOUR_FILE_ID2'], // Replace with your actual file IDs, separated by commas
                     metadata_filter:{ // Metadata key-value pairs, separated by commas
                         'key1':'value1',
                         'key2':'value2'
                     },
                     tags: ['tag1', 'tag2'] // Document tags, separated by commas
                 }
             },
             debug: {}
         };
     
         try {
             const response = await axios.post(url, data, {
                 headers: {
                     'Authorization': `Bearer ${apiKey}`,
                     'Content-Type': 'application/json'
                 }
             });
     
             if (response.status === 200) {
                 console.log(`${response.data.output.text}`);
             } else {
                 console.log(`request_id=${response.headers['request_id']}`);
                 console.log(`code=${response.status}`);
                 console.log(`message=${response.data.message}`);
             }
         } catch (error) {
             console.error(`Error calling DashScope: ${error.message}`);
             if (error.response) {
                 console.error(`Response status: ${error.response.status}`);
                 console.error(`Response data: ${JSON.stringify(error.response.data, null, 2)}`);
             }
         }
     }
     
     callDashScope();

     Response example

     Within a ¥3,000 budget, I recommend the **Bailian Zephyr Z9**, priced between ¥2,499 and ¥2,799. It features a lightweight, portable design, a 6.4-inch 1080 × 2340 pixel display, 128 GB storage, and 6 GB RAM—meeting everyday needs. Its 4,000 mAh battery lasts all day, and its 30× digital zoom lens captures distant details—a high-value choice.

     C#

     Request example

     using System.Text;
     
     class Program
     {
         static async Task Main(string[] args)
         {
             // If you have not set an environment variable, replace the next line with: apiKey="sk-xxx". However, avoid hard-coding your API key in production code to reduce the risk of exposure.
             string apiKey = Environment.GetEnvironmentVariable("DASHSCOPE_API_KEY")?? throw new InvalidOperationException("DASHSCOPE_API_KEY environment variable is not set.");;
             string appId = "YOUR_APP_ID";// Replace with your actual application ID
             // Replace YOUR_PIPELINE_ID1 with your actual knowledge base ID, YOUR_FILE_ID1 with your actual unstructured document ID
             if (string.IsNullOrEmpty(apiKey))
             {
                 Console.WriteLine("Make sure DASHSCOPE_API_KEY is set.");
                 return;
             }
     
             string url = $"https://dashscope.aliyuncs.com/api/v1/apps/{appId}/completion";
             
             using (HttpClient client = new HttpClient())
             {
                 client.DefaultRequestHeaders.Add("Authorization", $"Bearer {apiKey}");
                 string jsonContent = $@"{{
                     ""input"": {{
                         ""prompt"": ""Please recommend a smartphone under ¥3,000""
                     }},
                     ""parameters"": {{
                         ""rag_options"" : {{
                             ""pipeline_ids"":[""YOUR_PIPELINE_ID1""],
                             ""file_ids"":[""YOUR_FILE_ID1""],
                             ""metadata_filter"":{{
                                 ""name"":""Alice""
                             }},
                     ""tags"":""smartphone""
                         }}
                     }},
                     ""debug"": {{}}
                 }}";
     
                 HttpContent content = new StringContent(jsonContent, Encoding.UTF8, "application/json");
     
                 try
                 {
                     HttpResponseMessage response = await client.PostAsync(url, content);
     
                     if (response.IsSuccessStatusCode)
                     {
                         string responseBody = await response.Content.ReadAsStringAsync();
                         Console.WriteLine(responseBody);
                     }
                     else
                     {
                         Console.WriteLine($"Request failed with status code: {response.StatusCode}");
                         string responseBody = await response.Content.ReadAsStringAsync();
                         Console.WriteLine(responseBody);
                     }
                 }
                 catch (Exception ex)
                 {
                     Console.WriteLine($"Error calling DashScope: {ex.Message}");
                 }
             }
         }
     }

     Response example

     {
         "output": {
             "finish_reason": "stop",
             "session_id": "be9b5a1964fe41c9bbfd8674226bd238",
             "text": "Based on your budget, I recommend the **Bailian Zephyr Z9**, priced between ¥2,499 and ¥2,799—ideal for a sub-¥3,000 budget.\n\n### Highlights\n- **Lightweight design**: 6.4-inch screen, 1080 × 2340 pixel resolution—elegant and easy to carry.\n- **Balanced performance**: 6 GB RAM and 128 GB storage—meets everyday needs.\n- **Long-lasting battery**: 4,000 mAh—keeps you going all day.\n- **Outstanding photography**: 30× digital zoom—captures distant scenery and fine details.\n\nIf you want high value, basic features, and some flair, the Bailian Zephyr Z9 is a great pick."
         },
         "usage": {
             "models": [
                 {
                     "output_tokens": 180,
                     "model_id": "qwen-max",
                     "input_tokens": 1055
                 }
             ]
         },
         "request_id": "d0811195-0b3f-931e-90b8-323a65053d9c"
     }

     Go

     Request example

     package main
     
     import (
     	"bytes"
     	"encoding/json"
     	"fmt"
     	"io"
     	"net/http"
     	"os"
     )
     
     func main() {
     	// If you have not set an environment variable, replace the next line with: apiKey := "sk-xxx". However, avoid hard-coding your API key in production code to reduce the risk of exposure.
     	apiKey := os.Getenv("DASHSCOPE_API_KEY")
     	appId := "YOUR_APP_ID" // Replace with your actual application ID
     
     	if apiKey == "" {
     		fmt.Println("Make sure DASHSCOPE_API_KEY is set.")
     		return
     	}
     
     	url := fmt.Sprintf("https://dashscope.aliyuncs.com/api/v1/apps/%s/completion", appId)
     
     	// Build request body
     	requestBody := map[string]interface{}{
     		"input": map[string]string{
     			"prompt": "Please recommend a smartphone under ¥3,000",
     		},
     		"parameters": map[string]interface{}{
     			"rag_options": map[string]interface{}{
     				"pipeline_ids": []string{"YOUR_PIPELINE_ID1"}, // Replace with your actual unstructured knowledge base ID
     				"file_ids":     []string{"YOUR_FILE_ID1"},     // Replace with your actual unstructured document ID
     				"metadata_filter": map[string]string{
     					"name": "Alice", // Metadata key-value pair
     				},
     				"tags": "smartphone", // Unstructured document tag
     			},
     		},
     		"debug": map[string]interface{}{},
     	}
     
     	jsonData, err := json.Marshal(requestBody)
     	if err != nil {
     		fmt.Printf("Failed to marshal JSON: %v\n", err)
     		return
     	}
     
     	// Create HTTP POST request
     	req, err := http.NewRequest("POST", url, bytes.NewBuffer(jsonData))
     	if err != nil {
     		fmt.Printf("Failed to create request: %v\n", err)
     		return
     	}
     
     	// Set request headers
     	req.Header.Set("Authorization", "Bearer "+apiKey)
     	req.Header.Set("Content-Type", "application/json")
     
     	// Send request
     	client := &http.Client{}
     	resp, err := client.Do(req)
     	if err != nil {
     		fmt.Printf("Failed to send request: %v\n", err)
     		return
     	}
     	defer resp.Body.Close()
     
     	// Read response
     	body, err := io.ReadAll(resp.Body)
     	if err != nil {
     		fmt.Printf("Failed to read response: %v\n", err)
     		return
     	}
     
     	// Process response
     	if resp.StatusCode == http.StatusOK {
     		fmt.Println("Request successful:")
     		fmt.Println(string(body))
     	} else {
     		fmt.Printf("Request failed with status code: %d\n", resp.StatusCode)
     		fmt.Println(string(body))
     	}
     }
     

     Response example

     {
         "output": {
             "finish_reason": "stop",
             "session_id": "9de268b3d84748b5ac6321aba72b6ecd",
             "text": "Based on your budget, I recommend the **Bailian Zephyr Z9**, priced between ¥2,499 and ¥2,799—ideal for a sub-¥3,000 budget. Key features include the following:\n\n- Lightweight 6.4-inch 1080 × 2340 pixel screen design.\n- 128 GB storage and 6 GB RAM—meets everyday needs.\n- 4,000 mAh battery—lasts all day.\n- Rear camera with 30× digital zoom lens—captures distant details.\n\nIf you don’t need high-end photography or gaming, the Bailian Zephyr Z9 is a great choice."
         },
         "usage": {
             "models": [
                 {
                     "output_tokens": 156,
                     "model_id": "qwen-max",
                     "input_tokens": 1055
                 }
             ]
         },
         "request_id": "8940b597-92e1-9471-b4eb-896e563c479d"
     }

3. Retrieve specific data from a structured data document by passing the knowledge base ID and key-value pairs for structured data fields—such as table header and value—in the rag_options parameter.

   Retrieve structured data key-value pairs (structured_filter): On the Knowledge Base page, open a knowledge base and click View index to view index information for structured documents.

   Python

   Request example

   import os
   from http import HTTPStatus
   # We recommend DashScope SDK version >= 1.20.11
   from dashscope import Application
   
   response = Application.call(
       # If you have not set an environment variable, replace the next line with: api_key="sk-xxx". However, avoid hard-coding your API key in production code to reduce the risk of exposure.
       api_key=os.getenv("DASHSCOPE_API_KEY"),
       app_id='YOUR_APP_ID',  # Replace YOUR_APP_ID with your actual application ID
       prompt='Please recommend a smartphone under ¥3,000',
       rag_options={
           "pipeline_ids": ["YOUR_PIPELINE_ID1", "YOUR_PIPELINE_ID2"],  # Replace with actual knowledge base IDs, separated by commas
            "structured_filter": {  # Structured data key-value pairs, corresponding to structured data, separated by commas
               "key1": "value1",
               "key2": "value2"  
            }
       }
   )
   
   if response.status_code != HTTPStatus.OK:
       print(f'request_id={response.request_id}')
       print(f'code={response.status_code}')
       print(f'message={response.message}')
       print(f'For more information, see https://help.aliyun.com/en/model-studio/developer-reference/error-code')
   else:
       print('%s\n' % (response.output))

   Response example

   {
       "text": "I recommend the \"Bailian\" smartphone—it costs ¥2,999, fitting your budget. If you need more details—like performance or design—let me know.",
       "finish_reason": "stop",
       "session_id": "80a3b868b5ce42c8a12f01dccf8651e2",
       "thoughts": null,
       "doc_references": null
   }

   Java

   Request example

   // We recommend DashScope SDK version >= 2.16.8
   import com.alibaba.dashscope.app.*;
   import com.alibaba.dashscope.exception.ApiException;
   import com.alibaba.dashscope.exception.InputRequiredException;
   import com.alibaba.dashscope.exception.NoApiKeyException;
   import com.google.gson.JsonObject;
   import java.util.Arrays;
   
   public class Main {
       public static void streamCall() throws NoApiKeyException, InputRequiredException {
           JsonObject structureFilter = new JsonObject();
           structureFilter.addProperty("key1", "value1"); // Structured data key-value pair
           structureFilter.addProperty("key2", "value2"); // Add more with repeated addProperty calls
           ApplicationParam param = ApplicationParam.builder()
                   // If you have not set an environment variable, replace the next line with: .apiKey("sk-xxx"). However, avoid hard-coding your API key in production code to reduce the risk of exposure.
                   .apiKey(System.getenv("DASHSCOPE_API_KEY"))
                   .appId("YOUR_APP_ID") // Replace with your actual application ID
                   .prompt("Please recommend a smartphone around ¥3,000")
                   .ragOptions(RagOptions.builder()
                           .pipelineIds(Arrays.asList("PIPELINE_ID1","PIPELINE_ID2"))  // Replace with actual knowledge base IDs, separated by commas
                           .structuredFilter(structureFilter)
                           .build())
                   .build();
   
           Application application = new Application();
           ApplicationResult result = application.call(param);
           System.out.printf("%s\n",
                   result.getOutput().getText());// Process text-only output
       }
   
       public static void main(String[] args) {
           try {
               streamCall();
           } catch (ApiException | NoApiKeyException | InputRequiredException e) {
               System.out.printf("Exception: %s", e.getMessage());
               System.out.println("For more information, see https://help.aliyun.com/en/model-studio/developer-reference/error-code");
           }
           System.exit(0);
       }
   }

   Response example

   I recommend the "Bailian" smartphone—it costs ¥2,999.00, fitting your budget. If you need more details about this phone—like specs or performance—let me know, and I’ll provide more information.

   HTTP

   curl

   Request example

   curl -X POST https://dashscope.aliyuncs.com/api/v1/apps/YOUR_APP_ID/completion \
   --header "Authorization: Bearer $DASHSCOPE_API_KEY" \
   --header 'Content-Type: application/json' \
   --data '{
       "input": {
           "prompt": "Please recommend a smartphone around ¥3,000"
       },
       "parameters":  {
                       "rag_options" : {
                       "pipeline_ids":["YOUR_PIPELINE_ID1"],
                       "structured_filter":{
                       "price":"2999"}
                       }
       },
       "debug": {}
   }'

   Replace YOUR_APP_ID with your actual application ID. Replace YOUR_PIPELINE_ID1 with your actual knowledge base ID.

   Response example

   {"output":{"finish_reason":"stop","session_id":"d6bc4206f9cc4d368d534f8aa4e502bc",
   "text":"I recommend a smartphone close to ¥3,000:\n\n- **Bailian smartphone**, priced at ¥2,999.\n\nThis phone offers great value and fits your budget.\nIf you need more details—like camera performance or processor model—let me know, and I’ll provide more information."},
   "usage":{"models":[{"output_tokens":73,"model_id":"qwen-max","input_tokens":235}]},"request_id":"934e1258-219c-9ef1-8982-fc1bcefb8f11"}%  

   PHP

   Request example

   <?php
   # If you have not set an environment variable, replace the next line with: $api_key="sk-xxx". However, avoid hard-coding your API key in production code to reduce the risk of exposure.
   $api_key = getenv("DASHSCOPE_API_KEY");
   $application_id = 'YOUR_APP_ID'; // Replace with your actual application ID
   
   $url = "https://dashscope.aliyuncs.com/api/v1/apps/$application_id/completion";
   
   // Build request data
   $data = [
       "input" => [
           'prompt' => 'Please recommend a smartphone under ¥3,000'
       ],
       "parameters" => [
           'rag_options' => [
               'pipeline_ids' => ['YOUR_PIPELINE_ID1','YOUR_PIPELINE_ID2'],// Replace with your actual knowledge base IDs, separated by commas
               "structured_filter" => [ // Structured data key-value pairs, separated by commas
                   "key1" => "value1",
                   "key2" => "value2"
               ]
           ]
       ]
   ];
   // Encode data as JSON
   $dataString = json_encode($data);
   
   // Check if json_encode succeeded
   if (json_last_error() !== JSON_ERROR_NONE) {
       die("JSON encoding failed with error: " . json_last_error_msg());
   }
   
   // Initialize cURL session
   $ch = curl_init($url);
   
   // Set cURL options
   curl_setopt($ch, CURLOPT_CUSTOMREQUEST, "POST");
   curl_setopt($ch, CURLOPT_POSTFIELDS, $dataString);
   curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
   curl_setopt($ch, CURLOPT_HTTPHEADER, [
       'Content-Type: application/json',
       'Authorization: Bearer ' . $api_key
   ]);
   
   // Execute request
   $response = curl_exec($ch);
   
   // Check if cURL execution succeeded
   if ($response === false) {
       die("cURL Error: " . curl_error($ch));
   }
   
   // Get HTTP status code
   $status_code = curl_getinfo($ch, CURLINFO_HTTP_CODE);
   // Close cURL session
   curl_close($ch);
   // Decode response data
   $response_data = json_decode($response, true);
   // Process response
   if ($status_code == 200) {
       if (isset($response_data['output']['text'])) {
           echo "{$response_data['output']['text']}\n";
       } else {
           echo "No text in response.\n";
       }
   }else {
       if (isset($response_data['request_id'])) {
           echo "request_id={$response_data['request_id']}\n";}
       echo "code={$status_code}\n";
       if (isset($response_data['message'])) {
           echo "message={$response_data['message']}\n";} 
       else {
           echo "message=Unknown error\n";
       }
   }
   ?>

   Response example

   I recommend the "Bailian" smartphone—it costs ¥2,999, fitting your budget. If you need more details about this phone, let me know.

   Node.js

   Install dependencies:

   npm install axios

   Request example

   const axios = require('axios');
   async function callDashScope() {
       // If you have not set an environment variable, replace the next line with: apiKey='sk-xxx'. However, avoid hard-coding your API key in production code to reduce the risk of exposure.
       const apiKey = process.env.DASHSCOPE_API_KEY;
       const appId = 'YOUR_APP_ID';  // Replace with your actual application ID
       // Replace YOUR_PIPELINE_ID1 with your actual knowledge base ID, separate multiple IDs with commas
       const url = `https://dashscope.aliyuncs.com/api/v1/apps/${appId}/completion`;
   
       const data = {
           input: {
               prompt: "Please recommend a smartphone under ¥3,000"
           },
           parameters: {
               rag_options:{
                   pipeline_ids:['YOUR_PIPELINE_ID1','YOUR_PIPELINE_ID2'],
                   structured_filter:{
                       'key1':'value1',
                       'key2':'value2'
                   }
               }
           },
           debug: {}
       };
   
       try {
           const response = await axios.post(url, data, {
               headers: {
                   'Authorization': `Bearer ${apiKey}`,
                   'Content-Type': 'application/json'
               }
           });
   
           if (response.status === 200) {
               console.log(`${response.data.output.text}`);
           } else {
               console.log(`request_id=${response.headers['request_id']}`);
               console.log(`code=${response.status}`);
               console.log(`message=${response.data.message}`);
           }
       } catch (error) {
           console.error(`Error calling DashScope: ${error.message}`);
           if (error.response) {
               console.error(`Response status: ${error.response.status}`);
               console.error(`Response data: ${JSON.stringify(error.response.data, null, 2)}`);
           }
       }
   }
   
   callDashScope();

   Response example

   I recommend the "Bailian" smartphone—it costs ¥2,999, fitting your budget. If you need more details or have other specific needs, let me know!

   C#

   Request example

   using System.Text;
   
   class Program
   {
       static async Task Main(string[] args)
       {
           // If you have not set an environment variable, replace the next line with: apiKey="sk-xxx". However, avoid hard-coding your API key in production code to reduce the risk of exposure.
           string apiKey = Environment.GetEnvironmentVariable("DASHSCOPE_API_KEY")?? throw new InvalidOperationException("DASHSCOPE_API_KEY environment variable is not set.");;
           string appId = "YOUR_APP_ID";// Replace with your actual application ID
           // Replace YOUR_PIPELINE_ID1 with your actual knowledge base ID
           if (string.IsNullOrEmpty(apiKey))
           {
               Console.WriteLine("Make sure DASHSCOPE_API_KEY is set.");
               return;
           }
   
           string url = $"https://dashscope.aliyuncs.com/api/v1/apps/{appId}/completion";
           
           using (HttpClient client = new HttpClient())
           {
               client.DefaultRequestHeaders.Add("Authorization", $"Bearer {apiKey}");
               string jsonContent = $@"{{
                   ""input"": {{
                       ""prompt"": ""Please recommend a smartphone under ¥3,000""
                   }},
                   ""parameters"": {{
                       ""rag_options"" : {{
                           ""pipeline_ids"":[""YOUR_PIPELINE_ID1""],
                           ""structured_filter"":{{
                               ""price"":""2999""
                           }}
                       }}
                   }},
                   ""debug"": {{}}
               }}";
   
               HttpContent content = new StringContent(jsonContent, Encoding.UTF8, "application/json");
   
               try
               {
                   HttpResponseMessage response = await client.PostAsync(url, content);
   
                   if (response.IsSuccessStatusCode)
                   {
                       string responseBody = await response.Content.ReadAsStringAsync();
                       Console.WriteLine(responseBody);
                   }
                   else
                   {
                       Console.WriteLine($"Request failed with status code: {response.StatusCode}");
                       string responseBody = await response.Content.ReadAsStringAsync();
                       Console.WriteLine(responseBody);
                   }
               }
               catch (Exception ex)
               {
                   Console.WriteLine($"Error calling DashScope: {ex.Message}");
               }
           }
       }
   }

   Response example

   {
       "output": {
           "finish_reason": "stop",
           "session_id": "108e9104568e44f1915fb3d3d44fdc92",
           "text": "I recommend the \"Bailian\" smartphone—it costs ¥2,999.00, fitting your budget. If you need more details about this phone or other suggestions, let me know."
       },
       "usage": {
           "models": [
               {
                   "output_tokens": 38,
                   "model_id": "qwen-max",
                   "input_tokens": 104
               }
           ]
       },
       "request_id": "d6d103f4-5c22-9782-9682-45d51a5607f9"
   }

   Go

   Request example

   package main
   
   import (
   	"bytes"
   	"encoding/json"
   	"fmt"
   	"io"
   	"net/http"
   	"os"
   )
   
   func main() {
   	// If you have not set an environment variable, replace the next line with: apiKey := "sk-xxx". However, avoid hard-coding your API key in production code to reduce the risk of exposure.
   	apiKey := os.Getenv("DASHSCOPE_API_KEY")
   	appId := "YOUR_APP_ID" // Replace with your actual application ID
   
   	if apiKey == "" {
   		fmt.Println("Make sure DASHSCOPE_API_KEY is set.")
   		return
   	}
   
   	url := fmt.Sprintf("https://dashscope.aliyuncs.com/api/v1/apps/%s/completion", appId)
   
   	// Build request body
   	requestBody := map[string]interface{}{
   		"input": map[string]string{
   			"prompt": "Please recommend a smartphone under ¥3,000",
   		},
   		"parameters": map[string]interface{}{
   			"rag_options": map[string]interface{}{
   				"pipeline_ids": []string{"YOUR_PIPELINE_ID1"}, // Replace with your actual structured knowledge base ID
   				"structured_filter": map[string]string{
   					"price": "2999", // Structured data key-value pair
   				},
   			},
   		},
   		"debug": map[string]interface{}{},
   	}
   
   	jsonData, err := json.Marshal(requestBody)
   	if err != nil {
   		fmt.Printf("Failed to marshal JSON: %v\n", err)
   		return
   	}
   
   	// Create HTTP POST request
   	req, err := http.NewRequest("POST", url, bytes.NewBuffer(jsonData))
   	if err != nil {
   		fmt.Printf("Failed to create request: %v\n", err)
   		return
   	}
   
   	// Set request headers
   	req.Header.Set("Authorization", "Bearer "+apiKey)
   	req.Header.Set("Content-Type", "application/json")
   
   	// Send request
   	client := &http.Client{}
   	resp, err := client.Do(req)
   	if err != nil {
   		fmt.Printf("Failed to send request: %v\n", err)
   		return
   	}
   	defer resp.Body.Close()
   
   	// Read response
   	body, err := io.ReadAll(resp.Body)
   	if err != nil {
   		fmt.Printf("Failed to read response: %v\n", err)
   		return
   	}
   
   	// Process response
   	if resp.StatusCode == http.StatusOK {
   		fmt.Println("Request successful:")
   		fmt.Println(string(body))
   	} else {
   		fmt.Printf("Request failed with status code: %d\n", resp.StatusCode)
   		fmt.Println(string(body))
   	}
   }
   

   Response example

   {
       "output": {
           "finish_reason": "stop",
           "session_id": "9e0a031b51d1492e8b613ca391b445b0",
           "text": "I recommend the \"Bailian\" smartphone—it costs ¥2,999.00, fitting your budget. If you need more details about this phone or other recommendations, let me know."
       },
       "usage": {
           "models": [
               {
                   "output_tokens": 39,
                   "model_id": "qwen-max",
                   "input_tokens": 104
               }
           ]
       },
       "request_id": "036abd4f-10c8-9709-881d-8cc9f8095d54"
   }

Steps

Step 1: Enable the long-term memory featurelong-term memory

Go to the Application Management page. Find your agent application, turn on the long-term memory switch, and then publish the application.

Step 2: Create a memory

Call the CreateMemory API to create a memory. From the response, retrieve a unique memoryId.

Step 3: Save conversation information

Pass the memoryId you retrieved earlier. The system automatically analyzes your conversation and saves key information as memory linked to that memoryId.

Step 4: Use long-term memory in conversations

Each time you interact with the agent, provide the same memoryId. The system retrieves the corresponding memory content based on the provided memoryId and passes it along with the current question to the model to generate a response.

Example

# DashScope SDK version ≥ 1.22.1
from http import HTTPStatus
import os
from dashscope import Application
response = Application.call(
           # If you have not set an environment variable, replace the next line with: api_key="sk-xxx". However, avoid hard-coding your API key in production code to reduce the risk of exposure.
            api_key=os.getenv("DASHSCOPE_API_KEY"),
            app_id='YOUR_APP_ID',  # Enter your actual application ID
            prompt='User food preference: noodles',
            memory_id='YOUR_MEMORY_ID')  # Enter your actual memory ID

if response.status_code != HTTPStatus.OK:
    print(f'request_id={response.request_id}')
    print(f'code={response.status_code}')
    print(f'message={response.message}')
    print(f'For more information, see https://help.aliyun.com/en/model-studio/error-code')
else:
    print('%s\n' % (response.output.text))  # Process text-only output
    # print('%s\n' % (response.usage))

Got it—you love noodles! If you’d like recommendations or info about noodle recipes or restaurants, tell me more. For example: What kind of noodles do you prefer—ramen, spaghetti, or something regional? Or do you have special taste preferences? That way, I can help better.

# DashScope SDK version ≥ 1.22.1
from http import HTTPStatus
import os
from dashscope import Application
response = Application.call(
           # If you have not set an environment variable, replace the next line with: api_key="sk-xxx". However, avoid hard-coding your API key in production code to reduce the risk of exposure.
            api_key=os.getenv("DASHSCOPE_API_KEY"),
            app_id='YOUR_APP_ID',  # Enter your actual application ID
            prompt='Food recommendation',
            memory_id='YOUR_MEMORY_ID')  # Enter your actual memory ID

if response.status_code != HTTPStatus.OK:
    print(f'request_id={response.request_id}')
    print(f'code={response.status_code}')
    print(f'message={response.message}')
    print(f'For more information, see https://help.aliyun.com/en/model-studio/error-code')
else:
    print('%s\n' % (response.output.text))  # Process text-only output
    # print('%s\n' % (response.usage))

Since you love noodles, here are some dishes to try:

1. **Zhajiangmian**: A classic Beijing dish—noodles topped with savory yellow bean sauce and minced pork. Rich and flavorful.
2. **Dandan noodles**: A Sichuan favorite—spicy, numbing, and refreshing. Perfect if you enjoy bold flavors.
3. **Daoxiao noodles**: A Shanxi specialty—hand-cut noodles cooked right into boiling water. Chewy and satisfying.
4. **Spaghetti**: For variety, try Western-style pasta—like tomato meat sauce or creamy mushroom pasta.

Hope this helps! Let me know if you have specific tastes or other needs.

// DashScope SDK version ≥ 2.17.0
import com.alibaba.dashscope.app.*;
import com.alibaba.dashscope.exception.ApiException;
import com.alibaba.dashscope.exception.InputRequiredException;
import com.alibaba.dashscope.exception.NoApiKeyException;

public class Main {
    public static void callWithMemory() throws NoApiKeyException, InputRequiredException {
        ApplicationParam param = ApplicationParam.builder()
                // If you have not set an environment variable, replace the next line with: .apiKey("sk-xxx"). However, avoid hard-coding your API key in production code to reduce the risk of exposure.
                .apiKey(System.getenv("DASHSCOPE_API_KEY"))
                .appId("YOUR_APP_ID") // Replace with your actual application ID
                .prompt("User food preference: noodles")
                .memoryId("YOUR_MEMORY_ID") // Replace with your actual memory ID
                .build();

        Application application = new Application();
        ApplicationResult result = application.call(param);

        System.out.printf("%s\n",
                result.getOutput().getText()); // Process text-only output
    }
    public static void main(String[] args) {
        try {
            callWithMemory();
        } catch (ApiException | NoApiKeyException | InputRequiredException e) {
            System.out.printf("Exception: %s", e.getMessage());
            System.out.println("For more information, see https://help.aliyun.com/en/model-studio/error-code");
        }
        System.exit(0);
    }
}

Got it—you love noodles! If you need noodle recommendations, recipes, or places to eat, just ask—I’m happy to help!

// DashScope SDK version ≥ 2.17.0
import com.alibaba.dashscope.app.*;
import com.alibaba.dashscope.exception.ApiException;
import com.alibaba.dashscope.exception.InputRequiredException;
import com.alibaba.dashscope.exception.NoApiKeyException;

public class Main {
    public static void callWithMemory() throws NoApiKeyException, InputRequiredException {
        ApplicationParam param = ApplicationParam.builder()
                // If you have not set an environment variable, replace the next line with: .apiKey("sk-xxx"). However, avoid hard-coding your API key in production code to reduce the risk of exposure.
                .apiKey(System.getenv("DASHSCOPE_API_KEY"))
                .appId("YOUR_APP_ID") // Replace with your actual application ID
                .prompt("Food recommendation")
                .memoryId("YOUR_MEMORY_ID") // Replace with your actual memory ID
                .build();

        Application application = new Application();
        ApplicationResult result = application.call(param);

        System.out.printf("text: %s\n",
                result.getOutput().getText()); // Process text-only output
    }
    public static void main(String[] args) {
        try {
            callWithMemory();
        } catch (ApiException | NoApiKeyException | InputRequiredException e) {
            System.out.printf("Exception: %s", e.getMessage());
            System.out.println("For more information, see https://help.aliyun.com/en/model-studio/error-code");
        }
        System.exit(0);
    }
}

Since you love noodles, here are some tasty options:

1. **Zhajiangmian**: A Beijing classic—noodles with savory yellow bean sauce and minced pork. Fresh veggies like cucumber and bean sprouts add crunch.
2. **Dandan noodles**: A spicy Sichuan snack—thin noodles in rich broth, topped with chili oil, peanuts, and scallions. Refreshing and bold.
3. **Daoxiao noodles**: A Shanxi staple—thick, chewy noodles served with hearty meat-and-vegetable stews.
4. **Youpo noodles**: A Shaanxi favorite—hand-pulled noodles tossed in hot oil, chili flakes, soy sauce, and vinegar. Aroma first!
5. **Spaghetti**: For global flair, try Italian pasta—like classic tomato meat sauce or creamy mushroom pasta.

Hope these ideas delight you! Tell me if you have special requests or want to try something specific.

curl -X POST https://dashscope.aliyuncs.com/api/v1/apps/YOUR_APP_ID/completion \
--header "Authorization: Bearer $DASHSCOPE_API_KEY" \
--header 'Content-Type: application/json' \
--data '{
    "input": {
        "prompt": "User food preference: noodles",
        "memory_id": "YOUR_MEMORY_ID"
    },
    "parameters":  {},
    "debug": {}
}'  

{
    "output": {
        "finish_reason": "stop",
        "session_id": "36ca92e5689f4dfbab889525da8a784b",
        "text": "Got it—you prefer noodles. So when recommending food or giving advice, I’ll focus more on noodle options. Do you have a favorite type—like ramen, spaghetti, or a regional specialty? Or would you like suggestions for new noodle dishes to try? I’m happy to help!"
    },
    "usage": {
        "models": [
            {
                "output_tokens": 70,
                "model_id": "qwen-max",
                "input_tokens": 119
            }
        ]
    },
    "request_id": "050acdc4-d427-969e-8ba8-aa95075c2d9a"
}

curl -X POST https://dashscope.aliyuncs.com/api/v1/apps/YOUR_APP_ID/completion \
--header "Authorization: Bearer $DASHSCOPE_API_KEY" \
--header 'Content-Type: application/json' \
--data '{
    "input": {
        "prompt": "Food recommendation",
        "memory_id": "YOUR_MEMORY_ID"
    },
    "parameters":  {},
    "debug": {}
}'  

{"output":{"finish_reason":"stop",
"session_id":"12677d7f5e5d423ca30db6ff77a4710d",
"text":"Considering your love of noodles, here are some delicious options:\n\n
1. **Beijing Zhajiangmian**: A classic northern dish—noodles with savory yellow bean sauce and minced pork, topped with cucumber ribbons and tofu skin for texture.\n\n
2. **Sichuan Dandan noodles**: A fiery favorite—thin noodles in rich broth, topped with chili oil, peanuts, and preserved vegetables. Bold and addictive.\n\n
3. **Shanxi Daoxiao noodles**: Known for their unique preparation—noodles shaved directly into boiling water. Served with hearty tomato-egg or beef stews.\n\n
4. **Shaanxi Liangpi**: Technically a cold noodle dish—chewy wheat noodles with tangy vinegar, spicy chili oil, and crisp cucumber. Perfect for summer.\n\n
5. **Jiangnan Yangchun noodles**: Simple yet elegant—clear broth with fine noodles, sprinkled with scallions and a touch of lard. Light but deeply flavorful.\n\n
6. **Italian pasta**: For global variety, try classic tomato meat sauce or creamy mushroom pasta—delicious and easy to make.\n\n
Hope these satisfy your cravings—feel free to pick one to try!"}, 
"usage":{"models":[{"output_tokens":269,"model_id":"qwen-max","input_tokens":139}]},
"request_id":"f7792da2-02f6-999c-85f1-a76de85fb99f"}%

{"code":"InvalidApiKey","message":"Invalid API-key provided.","request_id":"2637fcf9-32b1-9f4e-b0e9-1724d4aea00e"}

<?php
# If you have not set an environment variable, replace the next line with: $api_key="sk-xxx". However, avoid hard-coding your API key in production code to reduce the risk of exposure.
$api_key = getenv("DASHSCOPE_API_KEY");
$application_id = 'YOUR_APP_ID'; // Replace with your actual application ID
$memory_id = 'YOUR_MEMORY_ID'; // Replace with your actual memory ID
$url = "https://dashscope.aliyuncs.com/api/v1/apps/{$application_id}/completion";

// Build request data
$data = [
    "input" => [
        'prompt' => 'User food preference: noodles',
        'memory_id' => $memory_id
    ]
];
// Encode data as JSON
$dataString = json_encode($data);

// Check if json_encode succeeded
if (json_last_error() !== JSON_ERROR_NONE) {
    die("JSON encoding failed with error: " . json_last_error_msg());
}

// Initialize cURL session
$ch = curl_init($url);

// Set cURL options
curl_setopt($ch, CURLOPT_CUSTOMREQUEST, "POST");
curl_setopt($ch, CURLOPT_POSTFIELDS, $dataString);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_HTTPHEADER, [
    'Content-Type: application/json',
    'Authorization: Bearer ' . $api_key
]);

// Execute request
$response = curl_exec($ch);

// Check if cURL execution succeeded
if ($response === false) {
    die("cURL Error: " . curl_error($ch));
}

// Get HTTP status code
$status_code = curl_getinfo($ch, CURLINFO_HTTP_CODE);
// Close cURL session
curl_close($ch);
// Decode response data
$response_data = json_decode($response, true);
// Process response
if ($status_code == 200) {
    if (isset($response_data['output']['text'])) {
        echo "{$response_data['output']['text']}\n";
    } else {
        echo "No text in response.\n";
    }
}else {
    if (isset($response_data['request_id'])) {
        echo "request_id={$response_data['request_id']}\n";}
    echo "code={$status_code}\n";
    if (isset($response_data['message'])) {
        echo "message={$response_data['message']}\n";} 
    else {
        echo "message=Unknown error\n";
    }
}
?>

Got it—you love noodles! If you’re looking for new noodle recipes or great places to eat, let me know more details—I’ll do my best to help. For example: Are you cooking at home or dining out?

<?php
# If you have not set an environment variable, replace the next line with: $api_key="sk-xxx". However, avoid hard-coding your API key in production code to reduce the risk of exposure.
$api_key = getenv("DASHSCOPE_API_KEY");
$application_id = 'YOUR_APP_ID'; // Replace with your actual application ID
$memory_id = 'YOUR_MEMORY_ID'; // Replace with your actual memory ID
$url = "https://dashscope.aliyuncs.com/api/v1/apps/{$application_id}/completion";

// Build request data
$data = [
    "input" => [
        'prompt' => 'Food recommendation',
        'memory_id' => $memory_id
    ]
];
// Encode data as JSON
$dataString = json_encode($data);

// Check if json_encode succeeded
if (json_last_error() !== JSON_ERROR_NONE) {
    die("JSON encoding failed with error: " . json_last_error_msg());
}

// Initialize cURL session
$ch = curl_init($url);

// Set cURL options
curl_setopt($ch, CURLOPT_CUSTOMREQUEST, "POST");
curl_setopt($ch, CURLOPT_POSTFIELDS, $dataString);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_HTTPHEADER, [
    'Content-Type: application/json',
    'Authorization: Bearer ' . $api_key
]);

// Execute request
$response = curl_exec($ch);

// Check if cURL execution succeeded
if ($response === false) {
    die("cURL Error: " . curl_error($ch));
}

// Get HTTP status code
$status_code = curl_getinfo($ch, CURLINFO_HTTP_CODE);
// Close cURL session
curl_close($ch);
// Decode response data
$response_data = json_decode($response, true);
// Process response
if ($status_code == 200) {
    if (isset($response_data['output']['text'])) {
        echo "{$response_data['output']['text']}\n";
    } else {
        echo "No text in response.\n";
    }
}else {
    if (isset($response_data['request_id'])) {
        echo "request_id={$response_data['request_id']}\n";}
    echo "code={$status_code}\n";
    if (isset($response_data['message'])) {
        echo "message={$response_data['message']}\n";} 
    else {
        echo "message=Unknown error\n";
    }
}
?>

Since you love noodles, here are some tasty options:

1. **Zhajiangmian** – A classic Beijing dish—noodles with savory yellow bean sauce and minced pork. Rich and delicious.
2. **Daoxiao noodles** – A Shanxi specialty—hand-cut noodles boiled right in the pot. Great with various broths or sauces.
3. **Dandan noodles** – A Sichuan street food favorite—spicy, fragrant, and packed with flavor. Topped with chili oil, peanuts, and preserved veggies.
4. **Lanzhou hand-pulled noodles** – Originating from Gansu Province, famous for its springy, handmade noodles served in rich beef broth with thin beef slices and scallions.

Hope these inspire you! Let me know if you want more details—or have other requests.

npm install axios

const axios = require('axios');

async function callDashScope() {
    // If you have not set an environment variable, replace the next line with: apiKey='sk-xxx'. However, avoid hard-coding your API key in production code to reduce the risk of exposure.
    const apiKey = process.env.DASHSCOPE_API_KEY;
    const appId = 'YOUR_APP_ID';// Replace with your actual application ID
    const memoryId = 'YOUR_MEMORY_ID';// Replace with your actual memory ID

    const url = `https://dashscope.aliyuncs.com/api/v1/apps/${appId}/completion`;

    const data = {
        input: {
            prompt: "User food preference: noodles",
            memory_id: memoryId
        },
        parameters: {},
        debug: {}
    };

    try {
        console.log("Sending request to DashScope API...");

        const response = await axios.post(url, data, {
            headers: {
                'Authorization': `Bearer ${apiKey}`,
                'Content-Type': 'application/json'
            }
        });

        if (response.status === 200) {
            if (response.data.output && response.data.output.text) {
                console.log(`${response.data.output.text}`);
            }
        } else {
            console.log("Request failed:");
            if (response.data.request_id) {
                console.log(`request_id=${response.data.request_id}`);
            }
            console.log(`code=${response.status}`);
            if (response.data.message) {
                console.log(`message=${response.data.message}`);
            } else {
                console.log('message=Unknown error');
            }
        }
    } catch (error) {
        console.error(`Error calling DashScope: ${error.message}`);
        if (error.response) {
            console.error(`Response status: ${error.response.status}`);
            console.error(`Response data: ${JSON.stringify(error.response.data, null, 2)}`);
        }
    }
}

callDashScope();

Got it—you love noodles! If you want to try new noodle dishes or find local specialties, let me know—I’ll give you some suggestions!

const axios = require('axios');

async function callDashScope() {
    // If you have not set an environment variable, replace the next line with: apiKey='sk-xxx'. However, avoid hard-coding your API key in production code to reduce the risk of exposure.
    const apiKey = process.env.DASHSCOPE_API_KEY;
    const appId = 'YOUR_APP_ID';// Replace with your actual application ID
    const memoryId = 'YOUR_MEMORY_ID';// Replace with your actual memory ID

    const url = `https://dashscope.aliyuncs.com/api/v1/apps/${appId}/completion`;

    const data = {
        input: {
            prompt: "Food recommendation",
            memory_id: memoryId
        },
        parameters: {},
        debug: {}
    };

    try {
        console.log("Sending request to DashScope API...");

        const response = await axios.post(url, data, {
            headers: {
                'Authorization': `Bearer ${apiKey}`,
                'Content-Type': 'application/json'
            }
        });

        if (response.status === 200) {
            if (response.data.output && response.data.output.text) {
                console.log(`${response.data.output.text}`);
            }
        } else {
            console.log("Request failed:");
            if (response.data.request_id) {
                console.log(`request_id=${response.data.request_id}`);
            }
            console.log(`code=${response.status}`);
            if (response.data.message) {
                console.log(`message=${response.data.message}`);
            } else {
                console.log('message=Unknown error');
            }
        }
    } catch (error) {
        console.error(`Error calling DashScope: ${error.message}`);
        if (error.response) {
            console.error(`Response status: ${error.response.status}`);
            console.error(`Response data: ${JSON.stringify(error.response.data, null, 2)}`);
        }
    }
}

callDashScope();

Since you love noodles, here are some suggestions:

1. **Daoxiao noodles**: Famous for their chewy texture and shape—great with rich broths or savory sauces.
2. **Dandan noodles**: A Sichuan spicy dish—peanut sauce, chili oil, and minced pork make it flavorful and layered.
3. **Zhajiangmian**: A Beijing classic—yellow bean sauce and minced pork over noodles. Delicious and hearty.
4. **Spaghetti**: For international variety, try tomato meat sauce or creamy mushroom pasta.

Hope this helps! Let me know if you need more details or specific recommendations.

using System.Text;

class Program
{
    static async Task Main(string[] args)
    {
        // If you have not set an environment variable, replace the next line with: apiKey="sk-xxx". However, avoid hard-coding your API key in production code to reduce the risk of exposure.
        string apiKey = Environment.GetEnvironmentVariable("DASHSCOPE_API_KEY")?? throw new InvalidOperationException("DASHSCOPE_API_KEY environment variable is not set.");;
        string appId = "YOUR_APP_ID";// Replace with your actual application ID
        string memoryId = "YOUR_MEMORY_ID";//Replace with your actual memory ID
        if (string.IsNullOrEmpty(apiKey))
        {
            Console.WriteLine("Make sure DASHSCOPE_API_KEY is set.");
            return;
        }

        string url = $"https://dashscope.aliyuncs.com/api/v1/apps/{appId}/completion";

        using (HttpClient client = new HttpClient())
        {
            client.DefaultRequestHeaders.Add("Authorization", $"Bearer {apiKey}");
            string jsonContent = $@"{{
                ""input"": {{
                    ""prompt"": ""User food preference: noodles"",
                    ""memory_id"":""{memoryId}""
                }},
                ""parameters"": {{}},
                ""debug"": {{}}
            }}";

            HttpContent content = new StringContent(jsonContent, Encoding.UTF8, "application/json");

            try
            {
                HttpResponseMessage response = await client.PostAsync(url, content);

                if (response.IsSuccessStatusCode)
                {
                    string responseBody = await response.Content.ReadAsStringAsync();
                    Console.WriteLine(responseBody);
                }
                else
                {
                    Console.WriteLine($"Request failed with status code: {response.StatusCode}");
                    string responseBody = await response.Content.ReadAsStringAsync();
                    Console.WriteLine(responseBody);
                }
            }
            catch (Exception ex)
            {
                Console.WriteLine($"Error calling DashScope: {ex.Message}");
            }
        }
    }
}

{
    "output": {
        "finish_reason": "stop",
        "session_id": "c24255e945b94f22bc3fe5fb515177c3",
        "text": "Got it—you prefer noodles. If you want recommendations or info about tasty noodle dishes or restaurants, tell me more. For example: Where are you now? What cuisine do you like—Sichuan, northern Chinese, etc.? Or do you have special needs—like vegetarian options? That way, I can help better."
    },
    "usage": {
        "models": [
            {
                "output_tokens": 59,
                "model_id": "qwen-max",
                "input_tokens": 146
            }
        ]
    },
    "request_id": "f732635f-3082-9dfe-9c09-df679d6d5b2e"
}

using System.Text;

class Program
{
    static async Task Main(string[] args)
    {
        // If you have not set an environment variable, replace the next line with: apiKey="sk-xxx". However, avoid hard-coding your API key in production code to reduce the risk of exposure.
        string apiKey = Environment.GetEnvironmentVariable("DASHSCOPE_API_KEY")?? throw new InvalidOperationException("DASHSCOPE_API_KEY environment variable is not set.");;
        string appId = "YOUR_APP_ID";// Replace with your actual application ID
        string memoryId = "YOUR_MEMORY_ID";//Replace with your actual memory ID
        if (string.IsNullOrEmpty(apiKey))
        {
            Console.WriteLine("Make sure DASHSCOPE_API_KEY is set.");
            return;
        }

        string url = $"https://dashscope.aliyuncs.com/api/v1/apps/{appId}/completion";

        using (HttpClient client = new HttpClient())
        {
            client.DefaultRequestHeaders.Add("Authorization", $"Bearer {apiKey}");
            string jsonContent = $@"{{
                ""input"": {{
                    ""prompt"": ""Food recommendation"",
                    ""memory_id"":""{memoryId}""
                }},
                ""parameters"": {{}},
                ""debug"": {{}}
            }}";

            HttpContent content = new StringContent(jsonContent, Encoding.UTF8, "application/json");

            try
            {
                HttpResponseMessage response = await client.PostAsync(url, content);

                if (response.IsSuccessStatusCode)
                {
                    string responseBody = await response.Content.ReadAsStringAsync();
                    Console.WriteLine(responseBody);
                }
                else
                {
                    Console.WriteLine($"Request failed with status code: {response.StatusCode}");
                    string responseBody = await response.Content.ReadAsStringAsync();
                    Console.WriteLine(responseBody);
                }
            }
            catch (Exception ex)
            {
                Console.WriteLine($"Error calling DashScope: {ex.Message}");
            }
        }
    }
}

{
    "output": {
        "finish_reason": "stop",
        "session_id": "665c16a3d10b48a0bb0ba92d42b6707b",
        "text": "Since you love noodles, here are some suggestions:\n\n1. **Dandan noodles** – A Sichuan classic—spicy, numbing, and aromatic.\n2. **Zhajiangmian** – A Beijing favorite—savory yellow bean sauce and minced pork over noodles.\n3. **Daoxiao noodles** – A Shanxi signature—wide, chewy noodles served with hearty stews.\n4. **Hot dry noodles** – A Wuhan breakfast staple—sesame paste-based, topped with scallions and bean sprouts.\n5. **Beef ramen** – A famous Lanzhou dish—clear broth, tender beef, and springy noodles.\n\nIf you want global options, try Italian pasta or Japanese udon. Hope this helps! Let me know your taste preferences—I’ll tailor more suggestions."
    },
    "usage": {
        "models": [
            {
                "output_tokens": 196,
                "model_id": "qwen-max",
                "input_tokens": 142
            }
        ]
    },
    "request_id": "305c5058-708e-94ce-b8ee-3bf539e5f35c"
}

package main

import (
	"bytes"
	"encoding/json"
	"fmt"
	"io"
	"net/http"
	"os"
)

func main() {
	// If you have not set an environment variable, replace the next line with: apiKey := "sk-xxx". However, avoid hard-coding your API key in production code to reduce the risk of exposure.
	apiKey := os.Getenv("DASHSCOPE_API_KEY")
	appId := "YOUR_APP_ID" // Replace with your actual application ID

	if apiKey == "" {
		fmt.Println("Make sure DASHSCOPE_API_KEY is set.")
		return
	}

	url := fmt.Sprintf("https://dashscope.aliyuncs.com/api/v1/apps/%s/completion", appId)

	// Build request body
	requestBody := map[string]interface{}{
		"input": map[string]string{
			"prompt":    "User food preference: noodles",
			"memory_id": "YOUR_MEMORY_ID", // Replace with your actual memory ID
		},
		"parameters": map[string]interface{}{},
		"debug":      map[string]interface{}{},
	}

	jsonData, err := json.Marshal(requestBody)
	if err != nil {
		fmt.Printf("Failed to marshal JSON: %v\n", err)
		return
	}

	// Create HTTP POST request
	req, err := http.NewRequest("POST", url, bytes.NewBuffer(jsonData))
	if err != nil {
		fmt.Printf("Failed to create request: %v\n", err)
		return
	}

	// Set request headers
	req.Header.Set("Authorization", "Bearer "+apiKey)
	req.Header.Set("Content-Type", "application/json")

	// Send request
	client := &http.Client{}
	resp, err := client.Do(req)
	if err != nil {
		fmt.Printf("Failed to send request: %v\n", err)
		return
	}
	defer resp.Body.Close()

	// Read response
	body, err := io.ReadAll(resp.Body)
	if err != nil {
		fmt.Printf("Failed to read response: %v\n", err)
		return
	}

	// Process response
	if resp.StatusCode == http.StatusOK {
		fmt.Println("Request successful:")
		fmt.Println(string(body))
	} else {
		fmt.Printf("Request failed with status code: %d\n", resp.StatusCode)
		fmt.Println(string(body))
	}
}

{
    "output": {
        "finish_reason": "stop",
        "session_id": "2e2ac5be49d2469794f310a92f34c9c7",
        "text": "Got it—you love noodles! If you want noodle recommendations or recipes, just ask—I’m happy to help! For example: Do you prefer Chinese noodles, Italian pasta, or something else?"
    },
    "usage": {
        "models": [
            {
                "output_tokens": 53,
                "model_id": "qwen-max",
                "input_tokens": 119
            }
        ]
    },
    "request_id": "3f1c66ba-1d19-98f2-89a5-4c3b53c80258"
}

package main

import (
	"bytes"
	"encoding/json"
	"fmt"
	"io"
	"net/http"
	"os"
)

func main() {
	// If you have not set an environment variable, replace the next line with: apiKey := "sk-xxx". However, avoid hard-coding your API key in production code to reduce the risk of exposure.
	apiKey := os.Getenv("DASHSCOPE_API_KEY")
	appId := "YOUR_APP_ID" // Replace with your actual application ID

	if apiKey == "" {
		fmt.Println("Make sure DASHSCOPE_API_KEY is set.")
		return
	}

	url := fmt.Sprintf("https://dashscope.aliyuncs.com/api/v1/apps/%s/completion", appId)

	// Build request body
	requestBody := map[string]interface{}{
		"input": map[string]string{
			"prompt":    "Food recommendation",
			"memory_id": "YOUR_MEMORY_ID", // Replace with your actual memory ID
		},
		"parameters": map[string]interface{}{},
		"debug":      map[string]interface{}{},
	}

	jsonData, err := json.Marshal(requestBody)
	if err != nil {
		fmt.Printf("Failed to marshal JSON: %v\n", err)
		return
	}

	// Create HTTP POST request
	req, err := http.NewRequest("POST", url, bytes.NewBuffer(jsonData))
	if err != nil {
		fmt.Printf("Failed to create request: %v\n", err)
		return
	}

	// Set request headers
	req.Header.Set("Authorization", "Bearer "+apiKey)
	req.Header.Set("Content-Type", "application/json")

	// Send request
	client := &http.Client{}
	resp, err := client.Do(req)
	if err != nil {
		fmt.Printf("Failed to send request: %v\n", err)
		return
	}
	defer resp.Body.Close()

	// Read response
	body, err := io.ReadAll(resp.Body)
	if err != nil {
		fmt.Printf("Failed to read response: %v\n", err)
		return
	}

	// Process response
	if resp.StatusCode == http.StatusOK {
		fmt.Println("Request successful:")
		fmt.Println(string(body))
	} else {
		fmt.Printf("Request failed with status code: %d\n", resp.StatusCode)
		fmt.Println(string(body))
	}
}

{
    "output": {
        "finish_reason": "stop",
        "session_id": "dcb3e991be904cfcb11b9b06109d4c73",
        "text": "Since you love noodles, here are some styles to try:\n\n1. **Zhajiangmian**: A Beijing classic—noodles with savory yellow bean sauce and minced pork. Chewy and delicious.\n2. **Dandan noodles**: A Sichuan favorite—spicy, numbing, and refreshing. Topped with peanut crumbles and chili oil.\n3. **Daoxiao noodles**: A Shanxi specialty—wide, chewy noodles served with hearty meat-and-vegetable stews.\n4. **Spaghetti**: For global variety, try classic tomato meat sauce or creamy mushroom chicken pasta.\n\nHope this helps! Let me know if you prefer a certain flavor—or want more details.</text>
    },
    "usage": {
        "models": [
            {
                "output_tokens": 167,
                "model_id": "qwen-max",
                "input_tokens": 142
            }
        ]
    },
    "request_id": "08b629ce-b3dd-96b6-8177-6443893e0b66"
}