aliyun-qwen-deep-research

name	aliyun-qwen-deep-research
description	Use when a task needs Alibaba Cloud Model Studio Qwen Deep Research models to plan multi-step investigation, run iterative web research, and produce structured reports with citations or evidence summaries.
version	1.0.0

Category: provider

Model Studio Qwen Deep Research

Validation

mkdir -p output/aliyun-qwen-deep-research
python -m py_compile skills/ai/research/aliyun-qwen-deep-research/scripts/prepare_deep_research_request.py && echo "py_compile_ok" > output/aliyun-qwen-deep-research/validate.txt

Pass criteria: command exits 0 and output/aliyun-qwen-deep-research/validate.txt is generated.

Output And Evidence

• Save research goals, confirmation answers, normalized request payloads, and final report snapshots under output/aliyun-qwen-deep-research/.
• Keep the exact model, region, and enable_feedback setting with each saved run.

Use this skill when the user wants a deep, multi-stage research workflow rather than a single chat completion.

Critical model names

Use one of these exact model strings:

• qwen-deep-research
• qwen-deep-research-2025-12-15

Selection guidance:

• Use qwen-deep-research for the current mainline model.
• Use qwen-deep-research-2025-12-15 when you need the snapshot with MCP tool-calling support and stronger reproducibility.

Prerequisites

• Install SDK in a virtual environment:

python3 -m venv .venv
. .venv/bin/activate
python -m pip install dashscope

• Set DASHSCOPE_API_KEY in your environment, or add dashscope_api_key to ~/.alibabacloud/credentials.
• This model currently applies to the China mainland (Beijing) region and uses its own API shape rather than OpenAI-compatible mode.

Normalized interface (research.run)

Request

• topic (string, required)
• model (string, optional): default qwen-deep-research
• messages (array, optional)
• enable_feedback (bool, optional): default true
• stream (bool, optional): must be true
• attachments (array, optional): image URLs and related context

  Response

  • status (string): stage status such as thinking, researching, or finished
  • text (string, optional): streamed content chunk
  • report (string, optional): final structured research report
  • raw (object, optional)

  Quick start

  python skills/ai/research/aliyun-qwen-deep-research/scripts/prepare_deep_research_request.py \
    --topic "Compare cloud video generation model trade-offs for marketing automation." \
    --disable-feedback
  

  Operational guidance

  • Expect streaming output only.
  • Keep the initial topic concrete and bounded; broad topics can trigger long iterative search plans.
  • If the model asks follow-up questions and you already know the constraints, answer them explicitly to avoid wasted rounds.
  • Use the snapshot model when you need stable evaluation runs or MCP tool-calling support.

  Output location

  • Default output: output/aliyun-qwen-deep-research/requests/
  • Override base dir with OUTPUT_DIR.

  References

  • references/sources.md