Dashscope

Learn how to use Dashscope Qwen models in Agno.

Dashscope provides access to Alibaba Cloud’s Qwen family of large language models. Qwen models are multilingual, efficient, and offer strong performance across various tasks including reasoning, coding, and creative writing.

We recommend experimenting to find the best-suited model for your use-case. Here are some general recommendations:

• qwen-plus is good for most general use-cases with balanced performance and cost.
• qwen-max offers the highest quality for complex reasoning tasks.
• qwen-turbo provides faster inference for simpler tasks.

Dashscope also supports advanced features like structured outputs and thinking processes for enhanced reasoning capabilities.

Authentication

Set your DASHSCOPE_API_KEY environment variable. You can get one from Alibaba Cloud here.

Mac

export DASHSCOPE_API_KEY=sk-***

Base URL

Dashscope provides different base URLs depending on your region:

• International users:
  https://dashscope-intl.aliyuncs.com/compatible-mode/v1
• China mainland users:
  https://dashscope.aliyuncs.com/compatible-mode/v1

By default, Agno uses the international endpoint.
If you are located in mainland China, you may need to override base_url

Example

Use DashScope with your Agent:

agent.py

from agno.agent import Agent, RunResponse
from agno.models.dashscope import DashScope

agent = Agent(
    model=DashScope(id="qwen-plus"),
    markdown=True
)

# Print the response in the terminal
agent.print_response("Share a 2 sentence horror story.")

Thinking Process

DashScope models support enabling thinking processes for enhanced reasoning:

from agno.agent import Agent
from agno.models.dashscope import DashScope

agent = Agent(
    model=DashScope(
        id="qwen-plus",
        enable_thinking=True,
        include_thoughts=True,
    ),
)

View more examples here.

Params

Parameter	Type	Default	Description
id	str	"qwen-plus"	The id of the Dashscope Qwen model to use
name	str	"Qwen"	The name of the model
provider	str	"Dashscope"	The provider of the model
api_key	Optional[str]	None	The Dashscope API key for authentication
base_url	str	"https://dashscope-intl.aliyuncs.com/compatible-mode/v1"	The base URL for the Dashscope API
enable_thinking	Optional[bool]	None	Enable thinking process for enhanced reasoning
include_thoughts	Optional[bool]	None	Include thinking process in the response

DashScope also supports the params of OpenAI.