DeepTutor 配置出现的问题

今天想写一篇博客来记录一下我在配置deeptutor时遇到的问题，我发现这个agent在网上的教程极少，所以便想写一篇博客记录一下。

我遇到了以下两个主要问题：

  1. 在使用书籍功能时，出现依赖报错:
AnimationGenerator requires the optional math-animator extras.
Install with `pip install -e '.[math-animator]'`
or `pip install -r requirements/math-animator.txt`.
  1. 在配置伙伴功能时，绑定qq机器人出现报错：
backend ERROR deeptutor.partners.channels.qq - QQ SDK not installed.
Run: pip install qq-botpy

我将按照配置Deeptutor到依次解决这两个问题的顺序来记录。如果是想跟着本博客配置的朋友可以先看完问题解决部分再配置。

配置流程

这里可以查看Deeptutor的详细文档 文档主页 | DeepTutor ，我选择的是pypl安装。

安装部署

安装方式极其简单，只需要依次在终端输入指令即可，官方文档给出的指令是powershell的。

mkdir -p my-deeptutor && cd my-deeptutor
pip install -U deeptutor
deeptutor init     # 提示输入端口 + LLM 提供商 + 可选 embedding
deeptutor start    # 同时启动后端 + 前端；保持终端开着

如果运行报错，有可能是你的powershell版本过低，有两个解决方法：

  1. 安装powershell的新版本（推荐）
  2. 将 mkdir -p my-deeptutor && cd my-deeptutor 这行命令拆开，改为
mkdir -p my-deeptutor 
cd my-deeptutor

版本升级

只需运行以下命令：

pip install --upgrade deeptutor
deeptutor start

设置配置

模型

我配置了LLM、嵌入模型、搜索、还有文生图模型，配置流程非常简单，只需按照流程来即可。我在这里提一下嵌入模型：

我用的是阿里云的，大家可以访问大模型服务平台百炼控制台还有如何使用Multimodal-Embedding API-大模型服务平台百炼(Model Studio)-阿里云帮助中心相关文档

这里我一上来就填入多模态embedding模型的模型id，运行测试会报错，但是你先填入文本embedding模型比如说text-embedding-v4这个模型，运行测试就不会报错，在此基础上在添加模型2，模型2使用多模态embedding模型就不会报错了。

知识库

我这里使用的是mineru，mineru的api不仅免费，功能还十分强大，强力推荐。当然其他的也挺好的，大家按需使用。

问题解决

问题一：依赖错误

AI书籍功能使用时生成动画内容块时报依赖错误：

在我使用AI书籍功能时，其他功能均无问题，但是在生成动画内容块时报以下错误：

AnimationGenerator requires the optional math-animator extras.
Install with `pip install -e '.[math-animator]'`
or `pip install -r requirements/math-animator.txt`.

我一开始以为我直接在终端pip一下就行了，但是我发现我是用的是pypl方式安装，这个方法无法解决，后来我发现可以用以下命令解决：

python -m pip install -U "deeptutor[math-animator]"

问题二：QQ机器人

小坑：

这里其实遇到了一个坑，就是在配置伙伴时，我将配置好的伙伴连接在qq机器人上，在配置qq机器人时，我在Allow From栏未填写内容就保存了（如果你填了内容但是将内容删了再保存也会出错），然后后端就报错且退出了，再次进入也无效，原因就是Allow From这里为空，导致Deeptutor的配置文件中，有一个叫 "qq" 的渠道（channel），它的 allowFrom 字段是空的，导致它拒绝所有连接，所以启动失败。

解决方法：

在项目根目录data文件夹下，找到 G:\my-deeptutor\data\partners\<你的伙伴目录>

在这个目录下找到config.yaml文件，找到以下内容

channels:
  qq:
    allow_from: []
    app_id: '你的id'
    enabled: true
    msg_format: plain
    secret: 你的秘钥
    send_progress: true
    send_tool_hints: true

将 allow_from 的内容改为["*"],然后保存，重新启动Deeptutor，即可修复。

问题：在配置好后依然连接不上qq机器人，你会发现在powershell中在报错：

backend  ERROR   deeptutor.partners.channels.qq - QQ SDK not installed. Run: pip install qq-botpy

解决方法：

这个解决非常容易，只需要切换到base环境，然后pip就行

conda activate base
pip install qq-botpy

结束

我也是最近才刚接触到这个agent，目前遇到了这两个问题，如果有错欢迎指正，谢谢阅读

这个工具确实非常好用，继续探索中。