コミュニティプラグイン
コミュニティプラグインは、コミュニティの作者が提供する拡張機能です。Nekro Agent がより多くのプラットフォーム、ツール、遊び方、自動化シナリオをサポートできるようになります。
組み込みプラグインと比較して、コミュニティプラグインは機能がより豊富ですが、提供元、メンテナンス状態、権限範囲により注意を払う必要があります。
できること
コミュニティプラグインの一般的な用途には以下が含まれます:
- サードパーティサービスの接続
- グループチャットの娯楽機能の追加
- データ検索機能の拡張
- 外部 API との連携
- 特定プラットフォーム機能の追加
- ビジネスプロセスのカスタマイズ
- ロールプレイやインタラクティブな遊びの拡張
セキュリティに関する注意
コミュニティプラグインは外部リポジトリから提供される場合があります。インストールや更新の前に、プラグインの提供元、作者の説明、権限範囲、メンテナンス状態を確認してください。
管理する場所
WebUI の「プラグイン管理」ページで、インストール済みのプラグインを確認し、有効化、無効化、設定、更新が行えます。
システムにプラグインマーケットやプラグインリポジトリのエントリが用意されている場合は、公式推奨のエントリからインストールすることをお勧めします。
プラグインを選ぶ前に確認すべきこと
コミュニティプラグインをインストールする前に、以下を確認することをお勧めします:
| 確認項目 | 推奨事項 |
|---|---|
| プラグインの提供元 | 提供元が明確で、作者が信頼できるプラグインを優先する |
| プラグインの用途 | 自分のニーズを確かに解決するものか確認する。試しにインストールするのは避ける |
| ドキュメントの説明 | 設定説明が明確なプラグインを優先する |
| メンテナンス状態 | 最近もメンテナンスされているプラグインを優先する |
| 権限範囲 | 外部サービスへのアクセス、メッセージ送信、グループチャット管理、機密情報の処理を行うかどうかを確認する |
インストールの推奨手順
コミュニティプラグインは以下の方法でインストールすることをお勧めします:
- まずプラグインの説明を読む
- 現在の Nekro Agent バージョンに対応していることを確認する
- インストール後、まずテストチャンネルで有効化する
- 必要なパラメータを設定する
- シンプルなタスクを送信して動作を確認する
- 安定したら本番チャンネルで使用する
推奨
本番環境では一度に多くのコミュニティプラグインをインストールしないでください。一度に1つのプラグインだけを追加し、安定を確認してから次の追加を行うことをお勧めします。
コミュニティプラグインの設定
コミュニティプラグインによって設定項目は異なります。通常、プラグイン管理ページで以下を入力する必要があります:
- API Key
- サービスアドレス
- アカウントまたは認証情報
- デフォルトのオン/オフ
- チャンネル制限
- 権限または管理者設定
そのプラグイン固有の認証情報のみの場合は、プラグイン設定に直接入力すれば問題ありません。同じアカウント、トークン、サーバー、データベース情報を複数のワークスペースやタスクで再利用する必要がある場合は、リソースセンター で一元管理することを検討してください。
プラグインの更新
コミュニティプラグインを更新する前に、以下を確認することをお勧めします:
- 更新内容が現在の使用シナリオに関係するか
- 設定項目が変更されているか
- 既存の機能に影響する可能性があるか
- まず設定をバックアップする必要があるか
- まずテストチャンネルで検証すべきか
現在のプラグインが安定して動作しており、新しいバージョンがまだ使用しない機能のみを追加する場合は、急いで更新する必要はありません。
無効化またはアンインストールすべき時期
以下の状況が発生した場合、プラグインの無効化またはアンインストールをお勧めします:
- 長期間使用していない
- 他のプラグインと機能が重複している
- 頻繁にエラーが発生し、正常な会話に影響している
- 提供元が不明確
- メンテナンスが停止しており、互換性の問題がある
- 高すぎる権限を必要とするが、メリットが明確でない
よくある質問
プラグインは多ければ多いほどいいですか?
いいえ。プラグインが多いほど、AI が選択できる機能が増え、ツールを間違って選ぶ可能性も高くなります。本当に必要なプラグインだけを残すことをお勧めします。
コミュニティプラグインをそのまま本番環境で使えますか?
お勧めしません。まずテストチャンネルで有効化し、設定が正しいこと、動作が期待通りであることを確認してから、本番チャンネルで使用してください。
プラグインにキーが必要な場合はどうすればいいですか?
そのプラグイン固有の設定のみの場合は、プラグイン設定に直接入力できます。同じ認証情報を複数のワークスペースやタスクで再利用する場合は、リソースセンターで一元管理することをお勧めします。
次のステップ
- プラグイン使用原則 — プラグインの選択と管理の推奨事項について学ぶ
- 組み込みプラグイン — まずシステム標準機能について学ぶ
- プラグインジェネレーター — 独自のプラグインを作成する
- プラグイン開発入門 — プラグイン開発を学ぶ
