<p data-line="0" class="code-line">こんにちは。スターフェスティバルの<a href="https://x.com/koonagi3" target="_blank" rel="nofollow noopener noreferrer">山﨑(@koonagi)</a>です。</p>
<p data-line="2" class="code-line">皆さんは業務でDifyを活用していますか？</p>
<p data-line="4" class="code-line"><a href="https://dify.ai/jp" target="_blank" rel="nofollow noopener noreferrer">Dify</a>は、ローコードでLLMアプリケーションを手軽に構築できるオープンソースのツールです。弊社では生成AIの業務活用の一貫として、今月から営業・オペレーションチームを中心にDifyの導入と効果検証をを始めています。</p>
<p data-line="6" class="code-line">弊社では業務データの多くを AWS 上で管理しているため、「AWS Bedrock Knowledge Base」と Dify を連携させることで、効率的に RAGを構築・活用できると考え、検証を進めています。<br>
Dify のプラグインを活用することで、この連携をスムーズに実現できたため、本ブログではその方法についてご紹介します。</p>
<h1 id="dify%E3%81%AE%E3%83%97%E3%83%A9%E3%82%B0%E3%82%A4%E3%83%B3%E3%81%A8%E3%81%AF" data-line="9" class="code-line">
<a class="header-anchor-link" href="#dify%E3%81%AE%E3%83%97%E3%83%A9%E3%82%B0%E3%82%A4%E3%83%B3%E3%81%A8%E3%81%AF" aria-hidden="true"></a> Difyのプラグインとは</h1>
<p data-line="10" class="code-line">プラグインは、Difyの機能を拡張するサードパーティ製のモジュールです。標準では提供されていない機能も、プラグインを活用することでノーコードで利用できます。例えば、本記事で紹介するAWS Bedrockのほか、SlackのWebHookなど、よく使われる機能を簡単に導入できるプラグインも提供されています。</p>
<p data-line="12" class="code-line"><span class="embed-block zenn-embedded zenn-embedded-card"><iframe id="zenn-embedded__4ef7cea16354b" src="https://embed.zenn.studio/card#zenn-embedded__4ef7cea16354b" data-content="https%3A%2F%2Fdocs.dify.ai%2Fja-jp%2Fplugins%2Fintroduction" frameborder="0" scrolling="no" loading="lazy"></iframe></span><a href="https://docs.dify.ai/ja-jp/plugins/introduction" style="display:none" target="_blank" rel="nofollow noopener noreferrer">https://docs.dify.ai/ja-jp/plugins/introduction</a></p>
<h1 id="dify-%C3%97-bedrock-knowledge-base-%E3%81%AE%E9%80%A3%E6%90%BA%E6%96%B9%E6%B3%95" data-line="14" class="code-line">
<a class="header-anchor-link" href="#dify-%C3%97-bedrock-knowledge-base-%E3%81%AE%E9%80%A3%E6%90%BA%E6%96%B9%E6%B3%95" aria-hidden="true"></a> Dify × Bedrock Knowledge Base の連携方法</h1>
<h2 id="1.-%E3%83%90%E3%83%83%E3%82%AF%E3%82%A8%E3%83%B3%E3%83%89-api-%E3%82%B5%E3%83%BC%E3%83%93%E3%82%B9%E3%82%92%E6%A7%8B%E7%AF%89%E3%81%99%E3%82%8B" data-line="16" class="code-line">
<a class="header-anchor-link" href="#1.-%E3%83%90%E3%83%83%E3%82%AF%E3%82%A8%E3%83%B3%E3%83%89-api-%E3%82%B5%E3%83%BC%E3%83%93%E3%82%B9%E3%82%92%E6%A7%8B%E7%AF%89%E3%81%99%E3%82%8B" aria-hidden="true"></a> 1. バックエンド API サービスを構築する</h2>
<p data-line="17" class="code-line">公式ドキュメントのリファレンスでは、Flask を使用して API サービスを作成し、その API 経由で Bedrock Knowledge Base からデータを取得（Retrieve）する方法が紹介されています。<br>
Lambda などでも代替可能ですが、リソースを追加する手間を考えると、メンテナンス面で少し煩雑になるかもしれません。</p>
<p data-line="20" class="code-line"><img src="https://storage.googleapis.com/zenn-user-upload/cd28ad0c85e2-20250312.png" loading="lazy" class="md-img"></p>
<p data-line="22" class="code-line"><a href="https://docs.dify.ai/ja-jp/learn-more/use-cases/how-to-connect-aws-bedrock" target="_blank" rel="nofollow noopener noreferrer">公式ドキュメント</a></p>
<h2 id="2.-%E3%80%90%E6%9C%AC%E8%A8%98%E4%BA%8B%E3%81%AE%E5%86%85%E5%AE%B9%E3%80%91-dify-%E3%83%97%E3%83%A9%E3%82%B0%E3%82%A4%E3%83%B3%E3%82%92%E4%BD%BF%E3%81%86" data-line="24" class="code-line">
<a class="header-anchor-link" href="#2.-%E3%80%90%E6%9C%AC%E8%A8%98%E4%BA%8B%E3%81%AE%E5%86%85%E5%AE%B9%E3%80%91-dify-%E3%83%97%E3%83%A9%E3%82%B0%E3%82%A4%E3%83%B3%E3%82%92%E4%BD%BF%E3%81%86" aria-hidden="true"></a> 2. 【本記事の内容】 Dify プラグインを使う</h2>
<p data-line="26" class="code-line">Dify には <strong>Bedrock Retrieve</strong> というプラグインが用意されており、Dify 内から AWS SDK を使用して Bedrock Knowledge Base にアクセスし、Retrieve 結果を取得できます。<br>
追加のリソースを作成する必要がないため、DifyのGUI上で簡単に実装可能です。</p>
<p data-line="29" class="code-line"><img src="https://storage.googleapis.com/zenn-user-upload/c4d6ec65cc84-20250312.png" loading="lazy" class="md-img"></p>
<h1 id="bedrock-retrieve-%E3%83%97%E3%83%A9%E3%82%B0%E3%82%A4%E3%83%B3-%E8%A8%AD%E5%AE%9A%E6%96%B9%E6%B3%95" data-line="31" class="code-line">
<a class="header-anchor-link" href="#bedrock-retrieve-%E3%83%97%E3%83%A9%E3%82%B0%E3%82%A4%E3%83%B3-%E8%A8%AD%E5%AE%9A%E6%96%B9%E6%B3%95" aria-hidden="true"></a> Bedrock Retrieve プラグイン 設定方法</h1>
<p data-line="32" class="code-line">※ Bedrock Knowledge Base はすでに作成済みであることを前提とします。</p>
<h2 id="1.-aws-%E3%83%97%E3%83%A9%E3%82%B0%E3%82%A4%E3%83%B3%E3%82%92%E3%82%A4%E3%83%B3%E3%82%B9%E3%83%88%E3%83%BC%E3%83%AB%E3%81%99%E3%82%8B" data-line="34" class="code-line">
<a class="header-anchor-link" href="#1.-aws-%E3%83%97%E3%83%A9%E3%82%B0%E3%82%A4%E3%83%B3%E3%82%92%E3%82%A4%E3%83%B3%E3%82%B9%E3%83%88%E3%83%BC%E3%83%AB%E3%81%99%E3%82%8B" aria-hidden="true"></a> 1. AWS プラグインをインストールする</h2>
<p data-line="35" class="code-line">スクリーンショットではすでに AWS がインストールされていますが、画面上部のツール検索で「AWS」を探し、インストールすると AWS 関連のプラグインが追加されます。</p>
<p data-line="37" class="code-line"><img src="https://storage.googleapis.com/zenn-user-upload/aa729539646c-20250309.png" loading="lazy" class="md-img"></p>
<h2 id="2.-%E3%80%8Cbedrock-retrieve%E3%80%8D%E3%82%92%E9%81%B8%E6%8A%9E%E3%81%99%E3%82%8B" data-line="39" class="code-line">
<a class="header-anchor-link" href="#2.-%E3%80%8Cbedrock-retrieve%E3%80%8D%E3%82%92%E9%81%B8%E6%8A%9E%E3%81%99%E3%82%8B" aria-hidden="true"></a> 2. 「Bedrock Retrieve」を選択する</h2>
<p data-line="40" class="code-line">AWS プラグインをインストールすると、ワークフローのツールに AWS の項目が追加され、その中に <strong>「Bedrock Retrieve」</strong> があります。これを選択します。</p>
<p data-line="42" class="code-line"><img src="https://storage.googleapis.com/zenn-user-upload/276695364343-20250309.png" loading="lazy" class="md-img"></p>
<h2 id="3.-%E5%BF%85%E8%A6%81%E3%81%AA%E3%83%91%E3%83%A9%E3%83%A1%E3%83%BC%E3%82%BF%E3%82%92%E5%85%A5%E5%8A%9B%E3%81%99%E3%82%8B" data-line="44" class="code-line">
<a class="header-anchor-link" href="#3.-%E5%BF%85%E8%A6%81%E3%81%AA%E3%83%91%E3%83%A9%E3%83%A1%E3%83%BC%E3%82%BF%E3%82%92%E5%85%A5%E5%8A%9B%E3%81%99%E3%82%8B" aria-hidden="true"></a> 3. 必要なパラメータを入力する</h2>
<p data-line="45" class="code-line">v0.02 での必須項目は以下のとおりです。</p>
<ul data-line="47" class="code-line">
<li data-line="47" class="code-line">
<strong>Query string:</strong> 検索クエリ（Knowledge Base に問い合わせる内容）</li>
<li data-line="48" class="code-line">
<strong>Result type:</strong> 出力形式（CSV / JSON）</li>
<li data-line="49" class="code-line">
<strong>Bedrock Knowledge Base ID:</strong> ナレッジベースの ID</li>
</ul>
<p data-line="51" class="code-line"><img src="https://storage.googleapis.com/zenn-user-upload/25f3da6056c8-20250309.png" loading="lazy" class="md-img"></p>
<p data-line="53" class="code-line">その他の入力パラメータについては、ツールチップだけではわからない部分も結構あるので、<a href="https://github.com/aws-samples/dify-aws-tool/blob/55540a9710c3d711e2b25004e5e1ffe886f5faab/builtin_tools/aws/tools/bedrock_retrieve.yaml#L17-L24" target="_blank" rel="nofollow noopener noreferrer">ソースコード</a>を直接確認するのが早いかもしれません。</p>
<h2 id="4.-llm%E3%81%ABretrieve%E7%B5%90%E6%9E%9C%E3%82%92%E9%80%A3%E6%90%BA%E3%81%99%E3%82%8B" data-line="55" class="code-line">
<a class="header-anchor-link" href="#4.-llm%E3%81%ABretrieve%E7%B5%90%E6%9E%9C%E3%82%92%E9%80%A3%E6%90%BA%E3%81%99%E3%82%8B" aria-hidden="true"></a> 4. LLMにRetrieve結果を連携する</h2>
<p data-line="56" class="code-line">Retrieve結果を LLM のインプットとして使用する場合は、コンテキストに <strong>「Bedrock Retrieve」</strong> の出力を指定すればOKです！<br>
Bedrock Knowledge Baseの内容をコンテキストとして理解して上で回答してくれるようになります。</p>
<p data-line="59" class="code-line"><img src="https://storage.googleapis.com/zenn-user-upload/f13ad3b77455-20250309.png" loading="lazy" class="md-img"></p>
<p data-line="61" class="code-line">出力結果は非表示にしていますが、<a href="https://www.houjin-bangou.nta.go.jp/download/zenken/index.html" target="_blank" rel="nofollow noopener noreferrer">国税庁のサイト</a> から法人情報を Knowledge Base にインプットした際の出力例です。</p>
<p data-line="63" class="code-line"><img src="https://storage.googleapis.com/zenn-user-upload/e8fc587ab83b-20250311.png" loading="lazy" class="md-img"></p>
<p data-line="66" class="code-line">設定は以上です！<br>
Lambda を使わず、プラグインだけで連携できるのでとても楽ですね〜〜〜！ 🎉</p>
<h1 id="%E6%B3%A8%E6%84%8F%E7%82%B9%E3%81%AA%E3%81%A9" data-line="69" class="code-line">
<a class="header-anchor-link" href="#%E6%B3%A8%E6%84%8F%E7%82%B9%E3%81%AA%E3%81%A9" aria-hidden="true"></a> 注意点など</h1>
<p data-line="71" class="code-line">プラグイン機能はまだ始まったばかりのため、不具合や脆弱性が含まれている可能性があります。<br>
利用するプラグインのコードは公開されているので、事前に確認しておくと安心です。</p>
<p data-line="74" class="code-line">🔗 <a href="https://github.com/aws-samples/dify-aws-tool/blob/55540a9710c3d711e2b25004e5e1ffe886f5faab/builtin_tools/aws/tools/bedrock_retrieve.py" target="_blank" rel="nofollow noopener noreferrer">Bedrock Retrieve のコードはこちら</a></p>
<p data-line="76" class="code-line"><strong>Bedrock Retrieve</strong> は、ほぼ <strong>First Commit</strong> レベルの状態なので、OSS へのコントリビュートのチャンスです！<br>
私自身も、どんどん改善提案をしていこうと思っています！</p>
<h1 id="%E6%9C%80%E5%BE%8C%E3%81%AB" data-line="79" class="code-line">
<a class="header-anchor-link" href="#%E6%9C%80%E5%BE%8C%E3%81%AB" aria-hidden="true"></a> 最後に</h1>
<p data-line="80" class="code-line">生成 AI によって、事業や開発のあり方が大きく変わっていることを実感する今日このごろです。<br>
Dify を活用すれば、エンジニアのリソースが限られている状況でも、生成 AI のアプリを素早く開発でき、事業に貢献できると考えています。</p>
<p data-line="83" class="code-line">もちろん、ローコードツールならではの管理の難しさもありますが、バランスを取りながら活用を進めていきたいです。<br>
例えば、まず Dify で仮説を立て、効果検証を行い、十分な成果が確認できたら長期運用を見据えて本格的な開発を進めるというアプローチも有効だと考えています。</p>
<p data-line="86" class="code-line">ちなみに、エンジニアチームでは <strong>Devin や Cline</strong> を活用した開発の検証も始めています。<br>
その内容については、別途アウトプットしていく予定なので、お楽しみに！！</p>


[Dify × Bedrock Knowledge Base] プラグインを使ってシンプルに連携

1. バックエンド API サービスを構築する

2. 【本記事の内容】 Dify プラグインを使う

Dify × Bedrock Knowledge Base の連携方法

1. AWS プラグインをインストールする

3. 必要なパラメータを入力する

Bedrock Retrieve プラグイン 設定方法

Discussion