Difyチュートリアル: Tencent MetaWareを使ったコストゼロのプライベートネットワーク検索ツールの構築

高度なAIアプリケーションを構築する場合、リアルタイムのネットワーク検索は情報を同期させるための重要な機能である。しかし、プラットフォームの公式検索プラグインを直接使用すると、ネットワークの制限や高額なAPI料金に遭遇する可能性がある。

本稿では、費用対効果の高い代替案を提案する。 Dify のHTTPリクエスト機能とTencent MetaWareプラットフォームを組み合わせることで、プライベートで無料のネットワーク検索ツールを構築することができる。このアプローチでは、依存関係の制約を回避できるだけでなく、以下のことが可能になる。 Agent リアルタイム情報への強いアクセス。Dify は、開発者が大規模な言語モデルに基づくAIアプリケーションを迅速に構築・運用できるように設計されたオープンソースのLLMOpsプラットフォームです。

建築分析

このスキームの原理は、「サービス・ブローカー」として理解できる。

外部検索サービスのプロバイダーとしてTencent MetaWareを利用しています。Tencent MetaWareはAIアプリケーション開発プラットフォームで、ワークフロー機能によって複雑な検索ロジックを標準的なAPIインターフェースにカプセル化することができます。

その後 Dify で、HTTPリクエスト・ノードをクライアントとしてインターフェイスが呼び出される。最終的には、HTTPコールフロー全体を Dify ツールは、どのような人でも使用できる。 Agent またはワークフローをモジュール式に呼び出す。

この建築の利点は明らかだ：

1. デカップリング検索サービスの実装 Dify アプリケーション・ロジックは、独立したメンテナンスとアップグレードを容易にするために分離されている。
2. コスト管理無料プラットフォームのリソースを活用し、APIコストゼロを実現。
3. 民営化ツールは、明確なデータリンクと高度なセキュリティによって、自分自身で構築し、コントロールすることができる。

何を準備すればいいですか？

作業を始める前に、以下の環境と認証情報を準備してください：

1. Tencent MetaWareプラットフォームへのアクセス登録とログイン https://yuanqi.tencent.com/.
2. ダイファイ動作環境コミュニティ・エディションとクラウドサービス・エディションのいずれかをご利用いただけます。
3. ラージモデルAPIキー（オプション）Tencent MetaWareのワークフローはデフォルトでビルトインモデルを使用しますが、高度な機能やカスタム設定によっては、ユーザーが独自のモデルAPIキー（たとえば DeepSeek など）。これらはこの基本的な検索のチュートリアルではカバーされていないので、今は準備しないでおいてよい。

運用ステップ：サービス構築からツール統合まで

以下のステップに従って、段階的にすべてのビルドプロセスを完了させてください。

第1段階：Tencent MetaWareで検索サービスを構築し、公開する。

1. ワークフローの作成
   Tencent MetaWareにログインし、新規インテリジェンスを作成し、作成モードとして「ワークフロー」を選択する。
   
2. 検索プラグインの追加
   ワークフローキャンバスで、左側のプラグインライブラリーから公式の「Search」プラグインを見つけて追加する。
   
   
3. 設定パラメータ
   プラグインの入力パラメーターを設定して、外部クエリー変数（Query）を受け取るようにします。
   
4. テストとリリース
   ワークフローインターフェイスで試運転を行い、検索機能が正しく動作していることを確認する。エラーがないことを確認したら、ワークフローをパブリッシュしてスマートボディに関連付け、最後にスマートボディをパブリッシュする。
   
5. API認証情報の取得
   Intelligent Bodyの管理ページにアクセスし、「Publishing Information」の「Interface Call」セクションを見つけ、APIのURLを取得する、Authorization と署名に必要なヘッダー情報である。これらは Dify メタ成果物への鍵とともに。
   

ステージ2: DifyでのHTTPツールの作成とラッピング

1. ワークフローの初期化
   ある Dify を含むファイルを作成する。 開始→HTTPリクエスト→終了 ノードのワークフロー。
   
2. HTTPリクエストノードの設定
   これが統合の核心である。
   • 方法: POST
   • リクエストURLTencent MetaToolから取得したAPI URLを記入してください。
   • ヘッダーメタバースから取得したすべての認証ヘッダーを正確に埋める。 Authorization, X-TC-Timestamp その他
   • ボディセレクト raw-textフォーマットは以下の通り。 application/jsonとしてリクエストボディを作成する。 {"query": "{{query}}"}.ここだ。 {{query}} であります Dify 変数プレースホルダ
     
3. 単体テスト
   HTTPノード内で、"Run this step "機能を使用してテストクエリを入力し、インターフェイスが以下を返すことを確認する。 status 200 の成功ステータスコード。
4. ツールとしての出版
   検証後、ワークフローを保存し、公開する。最も重要なステップは、右上の "Publish as Tool "をクリックし、分かりやすい名前を付けることである。 Internal_Search_Engine.
   
   

ステージ 3: エージェントでのツールの検証

1. テストエージェントの作成
   新しい Agent このアプリケーションはテストに使用される。
2. ローディングツール
   ある Agent を "Tools "設定項目に追加する。 Internal_Search_Engine 道具だ。
3. エンド・ツー・エンド・テスト
   デバッグとプレビュー画面で Agent リアルタイムの情報を必要とする質問をする。ツールを正しく呼び出し、返された検索結果を使って答えを生成できるかどうかを観察する。
   

トラブルシューティングと最適化

• よく見られる 400 Bad Request 不正確
  この問題は通常、HTTPリクエストの構築エラーです。このチェックに集中してください：
  1. Headers 認証情報が完全でエラーがないか。 Authorization およびタイムスタンプに関連するフィールドを含む。シグネチャ・クレデンシャルの中には時間依存のものがあるので、呼び出しに失敗した場合は再生を試みることができることに注意。
  2. Body のJSONフォーマットは
  3. Content-Type ヘッダーは application/json.
• パフォーマンス最適化
  テンセント・メタウェアの検索プラグイン対応 limit パラメータで、返される結果の数を制御することができる（デフォルトは10）。このパラメータは、メタウェアワークフローの変数として設定することもできます。 Dify 様々なシナリオに応じて情報密度を調整し、処理効率を最適化するために、情報は動的にHTTPリクエストボディに渡される。