Ragflow API Client

封装自托管 Ragflow RAG 平台的 REST API，通过 Node CLI 创建/列出/删除知识库、上传文档并触发解析、管理分块，以及针对数据集运行 RAG 问答检索；也可用 lib/api.js 程序化调用。需配置 RAGFLOW_URL 与 RAGFLOW_API_KEY，含删除数据集等破坏性操作。

angusthefuzz

热度 90.01

最近更新 2026-05-17 12:02:48

分类：知识依赖：代码执行 / 第三方 API / 读写文件应用场景：研究 / 数据处理 / 工作流

安装技能

复制下面的话术发给你的 Agent，它会通过 secure-skills 检索并安装该技能。

执行命令安装此 skill： npx secure-skills-cli add ragflow

Metadata

name: ragflow
description: Universal Ragflow API client for RAG operations. Create datasets, upload documents, run chat queries against knowledge bases. Self-hosted RAG platform integration.
version: 1.0.2
author: Ania
env: {"RAGFLOW_URL":{"description":"Ragflow instance URL (e.g., https://rag.example.com)","required":true},"RAGFLOW_API_KEY":{"description":"Ragflow API key (use least-privilege key, can manage datasets/upload files)","required":true}}
metadata: {"clawdbot":{"emoji":"📚","requires":{"bins":["node"]}}}

Ragflow API Client

Universal client for Ragflow — self-hosted RAG (Retrieval-Augmented Generation) platform.

Features

Dataset management — Create, list, delete knowledge bases
Document upload — Upload files or text content
Chat queries — Run RAG queries against datasets
Chunk management — Trigger parsing, list chunks

Usage

# List datasets
node {baseDir}/scripts/ragflow.js datasets

# Create dataset
node {baseDir}/scripts/ragflow.js create-dataset --name "My Knowledge Base"

# Upload document
node {baseDir}/scripts/ragflow.js upload --dataset DATASET_ID --file article.md

# Chat query
node {baseDir}/scripts/ragflow.js chat --dataset DATASET_ID --query "What is stroke?"

# List documents in dataset
node {baseDir}/scripts/ragflow.js documents --dataset DATASET_ID

Configuration

Set environment variables in your .env:

RAGFLOW_URL=https://your-ragflow-instance.com
RAGFLOW_API_KEY=your-api-key

API

This skill wraps Ragflow's REST API:

GET /api/v1/datasets — List datasets
POST /api/v1/datasets — Create dataset
DELETE /api/v1/datasets/{id} — Delete dataset
POST /api/v1/datasets/{id}/documents — Upload document
POST /api/v1/datasets/{id}/chunks — Trigger parsing
POST /api/v1/datasets/{id}/retrieval — RAG query

Full API docs: https://ragflow.io/docs

Examples

// Programmatic usage
const ragflow = require('{baseDir}/lib/api.js');

// Upload and parse
await ragflow.uploadDocument(datasetId, './article.md', { filename: 'article.md' });
await ragflow.triggerParsing(datasetId, [documentId]);

// Query
const answer = await ragflow.chat(datasetId, 'What are the stroke guidelines?');