# RAG Ready Converter の Dify プラグイン

> Dify のワークフローにノードを1つ置くだけで、Excel・PowerPoint・PDF・画像を RAG Ready なテキストに変換できるツールプラグインです。変換したテキストは、そのままナレッジ登録や LLM ノードへ渡せます。ご利用には RAG Ready Converter のアカウントと API キーが必要です。提供：株式会社スニフアウト。

- ページ: https://sniffout.net/services/rag-ready-converter/dify-plugin
- Dify Marketplace: https://marketplace.dify.ai/plugin/sniffout/rag-ready-converter
- サービス（アカウント登録・API キー発行）: https://rag-ready-converter.com/
- サービス紹介: https://sniffout.net/services/rag-ready-converter （Markdown 版: https://sniffout.net/services/rag-ready-converter/index.md ）

## できること

- **多様なファイル形式に対応**: PDF・Excel・PowerPoint・画像など（.xlsx / .pptx / .docx / .pdf / .png / .jpg）をそのまま渡せます。
- **出力形式を選べる**: Markdown（.md）またはプレーンテキスト（.txt）。ナレッジ登録には構造の残る Markdown が扱いやすくなっています。
- **後続ノードへそのまま接続**: 変換結果はテキスト・ファイル・メタデータに分かれて返ります。
- **長い変換にも耐える**: 変換完了を待つポーリングのタイムアウトと間隔を設定できます。

## ノードの入力と出力

入力

| 名前 | 型 | 必須 | 内容 |
|---|---|---|---|
| Upload File | file | 必須 | 変換したいファイル。ファイルアップロードや直前のノードから受け取ります。 |
| Result format | string | 任意 | 出力形式。Markdown（md）またはプレーンテキスト（txt）。 |

出力

| 名前 | 型 | 内容 |
|---|---|---|
| text | string | 変換後のテキスト。そのまま LLM ノードの入力に使えます。 |
| files | file[] | 変換済みのファイル。ナレッジのドキュメントとして登録できます。 |
| json | object | 変換に関するメタデータ。 |
| conversion_id | string | 変換ジョブの ID。問い合わせや追跡に使います。 |

## 使い始めるまでの手順

1. RAG Ready Converter（https://rag-ready-converter.com/）でアカウントを作成する。
2. 管理画面から RRC API Key を発行する。登録に使ったメールアドレスも控えておく。
3. Dify のプラグイン画面から Marketplace を開き、RAG Ready Converter を追加する。
4. プラグインの設定画面で、RRC API Key と登録メールアドレスを入力して認証する。
5. ワークフローにツールノードとして追加し、ファイルを渡す。配布している DSL を読み込めば、この構成が組まれた状態で始められる。

## 配布しているワークフロー（DSL）

### 変換ループ（最小構成）

ファイルを1つ渡すと、変換が終わるのを待ってから RAG Ready なテキストを返すワークフローです。RAG Ready Converter は変換 ID をすぐ返して裏で処理を進めるため、完了までポーリングする仕掛けを組んであります。

- 出力形式: Markdown（.md）／待機間隔: 30秒／ループ上限: 100回（完了した時点で抜ける）
- 必要なプラグイン: RAG Ready Converter, JustWait
- 読み込み先: スタジオ → アプリを作成 →「DSL ファイルをインポート」
- ダウンロード: https://sniffout.net/services/rag-ready-converter/dify/convert-loop.yml

### ナレッジパイプライン

Dify のナレッジのパイプラインとして登録して使います。Excel・Word・PowerPoint・PDF・画像をアップロードすると、RAG Ready なテキストへの変換から、親子チャンクへの分割、ベクトル索引の作成までを通しで行います。

- チャンク: 親＝段落単位・最大 4000 字 / 子＝最大 1008 字
- 埋め込みモデル: text-embedding-3-small（OpenAI）
- 検索方式: ハイブリッド検索（ベクトル 0.7 : キーワード 0.3）
- 必要なプラグイン: RAG Ready Converter, JustWait, OpenAI, Parent-child Chunker
- 読み込み先: ナレッジ → ナレッジパイプラインの作成画面から DSL をインポート
- ダウンロード: https://sniffout.net/services/rag-ready-converter/dify/knowledge-pipeline.yaml

読み込んだあとは、RAG Ready Converter のノードに API キーと登録メールアドレスを設定してください。

## 仕様と制限

| 項目 | 内容 |
|---|---|
| 提供元 | 株式会社スニフアウト |
| 種別 | ツール（Tool）プラグイン |
| 最大ファイルサイズ | 5 GB |
| プラグイン最大メモリ | 256 MB |
| 対応フォーマット | PDF / Excel / PowerPoint / Word / 画像 |
| 出力形式 | Markdown（.md）/ プレーンテキスト（.txt） |
| 認証に必要なもの | RAG Ready Converter の API キー（RRC API Key）と登録メールアドレス |

変換にかかる時間はファイルのサイズと複雑さに、出力の品質は元ファイルの品質に依存します。記載内容は 2026年8月時点のものです。最新の情報は Dify Marketplace のページをご確認ください。

## Dify での開発支援

株式会社スニフアウトでは、Dify を使った開発と AI エージェント構築の伴走支援を行っています（ワークフロー設計、AI エージェント構築、ナレッジ設計と精度評価、プラグイン開発と内製化）。

- AI エージェント開発: https://sniffout.net/solutions/agent
- RAG 開発支援: https://sniffout.net/solutions/rag