Cherry Studio

Cherry Studio 是主流的大模型桌面客户端。它支持大模型 API 与 MCP 服务器集成,也可连接 Embedding API 实现本地知识库问答。

效果展示

以导入限流文档,集成网页抓取 MCP 工具,探索限流报错的解决方案为例:

cherry-studio-mcp (online-video-cutter

原始动图较长,此处进行加速处理。

如何使用

前提条件

  1. 安装 Cherry Studio

    前往下载界面,根据系统类型下载安装包;

  2. 获取 API 密钥

    您需要获取API Key,并开通阿里云百炼的模型服务;

  3. 配置模型

    单击左下角的设置按钮,在模型服务栏中找到阿里云百炼,在API 密钥输入您的 API Key;API 地址输入https://dashscope.aliyuncs.com/compatible-mode/v1/;单击添加

    image.png模型 ID填入您需要使用的模型,此处以 qwen-plus-latest为例。

    如需选择其它模型,请参见模型列表与价格,模型的支持情况以实际效果为准。
    如果您是 RAM 用户,请参见业务空间管理,确保拥有模型的调用权限。

应用场景

本文通过简单对话、MCP与本地知识库问答三个场景,介绍如何将阿里云百炼的模型与 MCP 服务集成到 Cherry Studio。

简单对话

单击左上角的对话按钮,在输入框中输入“你是谁”,qwen-plus-latest 模型会在思考后进行回答。

image.png

qwen-plus-latest 为混合思考模型,可通过输入框的image.png按钮控制是否开启思考模式。

调用 MCP 工具

Cherry Studio 是先进的 MCP 客户端。

1. 获取 MCP 工具

以接入 ModelScope 提供的Fetch 网页抓取MCP 服务器为例。通过右侧的通过SSE URL连接服务,获取专属URL。

image.png

2. 添加 MCP 服务器

单击 Cherry Studio 左下角的设置按钮,单击 MCP 服务器,在新页面中单击添加服务器-从 JSON 导入,粘贴上图红框中的 JSON。

image.png

上图为添加 MCP 服务器成功状态。

3. 提问

回到对话框,单击 MCP 服务器的图标image.png,并选中添加的Fetch网页内容抓取,此时 MCP 服务器的图标变绿image.png

向输入框输入问题“https://help.aliyun.com/zh/model-studio/rate-limit 请问我遇到限流报错应该怎么办?”Cherry Studio 通过Fetch网页内容抓取工具获取指定网页的内容,并准确回答问题:

image

查询本地知识库

阿里云百炼提供 Embedding 模型与 Rerank 模型 API,可无缝集成至 Cherry Studio 的本地知识库功能。

Cherry Studio 官方文档介绍,在 Cherry Studio 知识库中添加的数据全部存储在本地。

1. 添加 Embedding 与 Rerank 模型(可选) API

单击左下角的设置按钮,在模型服务栏中找到阿里云百炼,添加text-embedding-v4(嵌入模型)与gte-rerank-v2(重排模型),Cherry Studio 会自动识别模型功能并标记在模型名称后。

Rerank 模型可增加召回文本与提问的相关性,属于可选功能。

image.png

2. 创建知识库

单击左侧知识库按钮后单击添加以创建知识库。

image.png

2.1. 配置嵌入模型与重排模型

名称输入“百炼错误信息文档”,嵌入模型下拉框选择text-embedding-v4,重排模型下拉框选择gte-rerank-v2,其它选项保持默认,单击确定

暂无法配置多模态向量模型multimodal-embedding-v1

image.png

2.2. 添加知识

Cherry Studio 提供了文件、目录、网址等多种添加知识的途径,此处以网址信息为例。选中网址后单击添加网址,输入https://help.aliyun.com/zh/model-studio/error-code。等待界面显示嵌入完成image.png,即可返回对话界面进行提问。

2.3. 提问

返回对话界面,单击知识库按钮,选中百炼错误信息文档

image.png

以用户在使用阿里云百炼时可能遇到的常见问题为例,输入:“Input data may contain inappropriate content.这种报错该咋解决”,可得到以下回答:

image.png

常见问题

Q:Qwen3 模型为何报错 The value of the enable_thinking parameter is restricted to True?

A:原因:可能使用了 Qwen3 开源版的 Thinking 模型,但关闭了输入框的思考按钮。

解决方案:更新 Cherry Studio 客户端,或在使用 Qwen3 Thinking 模型时打开思考按钮。