プラグイン
プラグインは RAG Pipeline における拡張メカニズムであり、ユーザーは カスタム Python コード と プラグインパッケージのアップロード によって、個別化されたデータ処理ロジックを実現できます。プラグインは前処理または検索の工程に柔軟に適用でき、エンタープライズプロジェクトにおけるプライベートアルゴリズムの統合、サードパーティサービスの呼び出し、および API 方式による拡張などの高度なカスタマイズ要件を満たします。
プラグインの作成
- Knowledge → RAG Pipeline → プラグイン ページに移動します。
- プラグインページの右上にある 「作成」 をクリックします。
- 作成方法で 「手動作成・編集」 または 「ローカルプラグインパッケージをアップロード」 を選択します。
手動作成・編集
オンラインエディタで Python コードとプラグイン設定を直接記述し、カスタム Pipeline プラグインをすばやく作成します。
基本情報の入力
- 名称：プラグイン名を入力します。50 文字以内です。
- 有効化：チェックを入れるとプラグインが有効になります。
- タイプ：プラグインの適用シナリオとして 前処理 または 検索 を選択します。
- 説明：プラグイン機能の補足説明を入力します。100 文字以内です。
「次へ」 をクリックして、プラグイン情報の設定に進みます。
プラグイン情報
プラグインのマニフェストファイル manifest.yaml を設定し、プラグインの依存環境および入出力データ仕様を宣言します。
設定完了後、「次へ」 をクリックしてコード作成ステップに進みます。
Python コード
プラグインの中核となる処理ロジックをオンラインで記述します。エディタには基本的なコードフレームワークが用意されており、ユーザーはこれを基に具体的な業務処理関数を実装し、入力データを加工して結果を返します。コード保存後はプラグインの実行本体として扱われ、プラグイン Pipeline の実行時に呼び出されます。
ローカルプラグインパッケージのアップロード
オフラインですでに開発が完了しているプラグインプロジェクトに適しており、圧縮パッケージをアップロードすることでプラットフォームへ迅速に統合できます。
以下の基本情報を入力してください：
- 名称：プラグイン名。
- 有効化：このプラグインをすぐに有効化するかどうかを設定します。
- タイプ：前処理 または 検索 を選択します。
- 説明：プラグインの機能説明を補足します。
- コードパッケージ：アップロード領域をクリックして、ローカルの圧縮パッケージファイルを選択します。
「確認」 をクリックしてアップロードを完了すると、システムが自動的にプラグインパッケージを解析して登録を完了します。
プラグインカード
プラグインカードにマウスを重ねると、編集 と 実行 の操作ボタンが表示されます。
プラグイン詳細ページに入ると、基本情報、プラグイン情報、コードパッケージ の 3 つの設定項目を確認または変更できます。 手動作成したプラグインではコードのオンライン編集が可能です。アップロードしたプラグインパッケージについては、元のパッケージファイルを再アップロードして置き換えることができます。変更後は保存しないと有効になりません。
実行テスト
実行機能は、プラグインに独立したデバッグ環境を提供します。
- 入力エリア：プラグインの
io_schemaで定義された構造に準拠したテストデータを JSON 形式で入力します。 - 出力エリア：実行ボタンをクリックすると、システムがプラグインコードを実行し、ここに返却結果を表示します。実行エラーが発生した場合、または返却データがない場合は、画面に対応するメッセージが表示されます。
