Dashscope Image Agent Bytes

Analyze image bytes with a tool-capable Qwen3-VL model and search the web for context.

image_agent_bytes.py
"""
Dashscope Image Agent Bytes
===========================

Cookbook example for `dashscope/image_agent_bytes.py`.
"""

from pathlib import Path

from agno.agent import Agent
from agno.media import Image
from agno.models.dashscope import DashScope
from agno.tools.websearch import WebSearchTools
from agno.utils.media import download_image

# ---------------------------------------------------------------------------
# Create Agent
# ---------------------------------------------------------------------------

agent = Agent(
    model=DashScope(id="qwen-vl-plus"),
    tools=[WebSearchTools()],
    markdown=True,
)

image_path = Path(__file__).parent.joinpath("sample.jpg")

download_image(
    url="https://upload.wikimedia.org/wikipedia/commons/a/a7/Camponotus_flavomarginatus_ant.jpg",
    output_path=str(image_path),
)

# Read the image file content as bytes
image_bytes = image_path.read_bytes()

agent.print_response(
    "Analyze this image of an ant. Describe its features, species characteristics, and search for more information about this type of ant.",
    images=[
        Image(content=image_bytes),
    ],
    stream=True,
)

# ---------------------------------------------------------------------------
# Run Agent
# ---------------------------------------------------------------------------

if __name__ == "__main__":
    pass

The source pairs qwen-vl-plus with web-search tools. Use the Qwen3-VL substitution below for the documented vision function-calling capability.

Run the Example

Set up your virtual environment

uv venv --python 3.12
source .venv/bin/activate

Install dependencies

uv pip install -U agno ddgs openai

Configure regional DashScope access

Activate Alibaba Cloud Model Studio and create an API key for your region and workspace. Agno's default endpoint is Singapore: https://dashscope-intl.aliyuncs.com/compatible-mode/v1.

export DASHSCOPE_API_KEY="your_singapore_api_key"

For another region or a workspace-specific domain, pass the matching base_url to DashScope. Use the OpenAI-compatible endpoint guide to match the URL, key and available model. The documented Singapore default remains functional.

Use a tool-capable vision model

Save the source as image_agent_bytes.py and replace DashScope(id="qwen-vl-plus") with DashScope(id="qwen3-vl-plus").

Run the example

Save the code above as image_agent_bytes.py, then run:

python image_agent_bytes.py

Full source: cookbook/90_models/dashscope/image_agent_bytes.py