For the complete documentation index, see llms.txt. This page is also available as Markdown.

Model Task Division and Agent Drawing

An Agent can use three text-model roles and call the [Generate Image] tool through the global image-generation model. First, get the task working with a simple setup, then split the model roles as needed.

Three model roles

Role
Main responsibility
Suggested starting point

Main model

Understand the goal, call tools, and generate the main result

Choose a model that has been verified to use tools reliably

Plan model

Break down complex tasks and make plans

Start with the same as the main model; split only if it is truly needed

Small model

Simple judgments, classification, and formatting

Start with the same as the main model to avoid introducing variables too early

Configuration path: left navigation [Work] → open the Agent menu → [Edit] → [Basics].

Let the Agent generate images directly

Agent drawing uses Cherry Studio's global image-generation model, not the Agent's main model.

1

1. Configure the drawing model

Open [Settings] → [Default Model] → [Drawing Model], and select an image-generation model that is already available in the model service.

2

2. Check the Agent's image tool

Open the Agent edit window → [Built-in Tools], and confirm that [Generate Image] is enabled.

3

3. Describe the image in [Work]

Tell the Agent the image's purpose, subject, style, composition, aspect ratio, and what you do not want to appear. For example:

Generate a 16:9 hero image for this product launch copy. The scene is an AI desktop workspace at night, in blue-purple tones, leaving space on the right for the title, with no text or brand logos.
4

4. Check tool calls and results

Image generation may require tool approval and may also incur provider usage charges. Confirm the model and parameters being called before allowing execution; the result will be shown directly in the Agent task.

默认模型设置中的绘画模型选择
After selecting the drawing model in the default model, the Agent can use [Generate Image].

Common phrasing

Goal
Prompts should include
Example

Illustration for an article

Topic, whitespace, color tone, aspect ratio

"Landscape 16:9, main subject on the left, title area on the right"

Product sketch

Perspective, material, background, constraints

"Isometric view, white background, no text"

Social media image

Platform ratio, focal point, text requirements

"Square, centered subject, no text generated"

Modify based on a reference image

Attachment, parts to keep, and parts to change

"Keep the person and composition, only replace the background and color tone"

Agent 对话中启用生成图片工具并选择绘画模型
After the drawing model is configured, the Agent can generate images directly in tasks; enter [Drawing] only when you need templated batch creation.
Need
Recommended approach
Applicable scenario
Notes

Occasionally add an image to a document

Enable [Generate Image] in the Agent

Illustrations for reports, proposals, and notes

First confirm the size, style, and purpose

Repeatedly use the same set of image parameters

Use the [Drawing] template

Brand images, series covers

Verify the result once before saving the template

Edit an existing image

Provide a reference image and change requests in [Drawing]

Change colors, expand the image, local adjustments

Keep the original image to avoid irreversible overwriting

User case: one release note with three images

The content operations team put the release note into the work directory and had the Agent first extract three visual themes, then generate a hero image, a feature diagram, and a square social media image separately. Only one image was generated each time and the direction was confirmed, avoiding multiple calls in one go and having to redo everything.

Why is [Generate Image] unavailable?

First check whether a drawing model has been selected under [Settings] → [Default Model], then confirm that the corresponding provider is enabled and connected properly. Finally, check whether the Agent's [Generate Image] tool is turned off.

The main model itself can draw images—do I still need a drawing model?

The Agent's [Generate Image] tool uses the global drawing model. Even if the main model supports multimodal understanding, it cannot replace the drawing model configuration here.

Last updated

Was this helpful?