[Question]: agent with web-crawler

用户在使用 RAGFlow 的 Agent(智能体)功能,并配置了 Web Crawler(网络爬虫)节点。当 Agent 执行爬取任务时,Playwright 尝试启动 Chromium 浏览器但失败,触发报错。

[Question]: agent with web-crawler

[Question]: agent with web-crawler

快速结论:该报错发生在 RAGFlow 中使用 Agent 的 Web Crawler 节点时,原因是容器内未安装 Playwright 所需的 Chromium 浏览器。优先尝试在 RAGFlow 容器内执行 playwright install chromium

问题场景

用户在使用 RAGFlow 的 Agent(智能体)功能,并配置了 Web Crawler(网络爬虫)节点。当 Agent 执行爬取任务时,Playwright 尝试启动 Chromium 浏览器但失败,触发报错。

报错原文

BrowserType.launch: Executable doesn't exist at /root/.cache/ms-playwright/chromium-1134/chrome-linux/chrome
╔════════════════════════════════════════════════════════════╗
║ Looks like Playwright was just installed or updated.       ║
║ Please run the following command to download new browsers: ║
║                                                            ║
║     playwright install                                     ║
║                                                            ║
║ <3 Playwright Team                                         ║
╚════════════════════════════════════════════════════════════╝

原因分析

RAGFlow 依赖于 Playwright 库来驱动 Web Crawler,但默认的 Docker 镜像中只安装了 Playwright Python 包,并未下载配套的 Chromium 浏览器二进制文件。Playwright 在首次启动时需要在 ~/.cache/ms-playwright/ 目录下找到特定版本的 Chromium,缺失该文件导致启动失败。

环境排查

  • 确认 RAGFlow 是否运行在 Docker 容器中。
  • 检查容器内是否有 /root/.cache/ms-playwright/ 目录及其下的 chromium-1134 子目录。

解决步骤

  1. 进入 RAGFlow 容器终端(如果使用 docker-compose,容器名称通常为 ragflow_server):
    docker exec -it ragflow_server bash
  2. 在容器内执行 Playwright 的浏览器安装命令(可优先尝试):
    playwright install chromium
  3. 如果上一步报错或下载失败,可尝试强制安装所有浏览器:
    playwright install
  4. 安装完成后,重新启动 RAGFlow 服务或重启容器以使环境生效。

验证方法

在 RAGFlow 中重新执行包含 Web Crawler 节点的 Agent 流程,观察是否能正常抓取网页内容,且不再出现 Executable doesn't exist 错误。

参考来源

infiniflow/ragflow #5840

GamsGo AI

AI 工具推荐

想把多个 AI 模型放在一个入口?

GamsGo AI 集成 ChatGPT、DeepSeek、Gemini、Claude、Midjourney、Veo 等常用模型,适合写作、绘图、视频和日常 AI 工作流。

了解 GamsGo AI

推广链接:通过此链接购买,我可能获得佣金,不影响你的价格。

celebrityanime
celebrityanime
文章: 9852

发表回复

您的邮箱地址不会被公开。 必填项已用 * 标注