組み込みプラグイン
組み込みプラグインは、Nekro Agent にシステム標準で提供される基本機能です。メッセージのやり取り、画像閲覧、定期タスク、検索、音声、ダイス、グループ管理など一般的なシナリオをカバーしています。
ほとんどのユーザーは、最初は組み込みプラグインから始めれば十分です。最初から多くのコミュニティプラグインをインストールする必要はありません。
有効化する場所
WebUI の「プラグイン管理」ページで、プラグインの確認、有効化、無効化、設定が行えます。
以下の順序で使用することをお勧めします：
- まず基本プラグインが有効になっていることを確認する
- 必要に応じて検索、音声、タイマーなどの拡張プラグインを有効化する
- プラグインに必要なキーやパラメータを設定する
- チャンネルでプラグインが正常に動作するかテストする
推奨
使い始めの段階では、本当に必要なプラグインだけを有効化することをお勧めします。プラグインが少ないほど、AI が選択できる機能が明確になり、問題の切り分けも簡単になります。
よく使う組み込みプラグイン
| プラグイン | できること | 適している場面 |
|---|---|---|
| 基本インタラクションプラグイン | テキスト、画像、ファイルの送信、一部データ内容の閲覧 | 日常チャット、ファイル送信、基本的なやり取り |
| 画像閲覧 | AI が画像の内容を確認・理解するのを支援 | 画像認識、スクリーンショット分析、スタンプの理解 |
| タイマーツールセット | リマインダー、単発タスク、定期タスクの作成 | 定時リマインダー、毎日のレポート、定期巡視 |
| Google 検索ツール | リアルタイムの検索結果を取得 | ニュース、資料、ウェブ情報の検索 |
| AI 音声プラグイン | テキストを AI 音声に変換 | 音声応答、キャラクター音声出力 |
| ダイス姫 | ダイス判定やランダム選択 | TRPG、ランダムイベント、グループチャットの娯楽 |
| 風紀委員 | グループ管理とミュートの補助 | グループチャット管理、違反対応 |
| ノートプラグイン | シンプルなメモの記録と読み取り | 一時的な記録、軽量な情報保存 |
| ホワイトボードプラグイン | 繰り返し編集可能な共有コンテンツの管理 | グループ内のお知らせ下書き、共同作業記録 |
| 歴史穿越 | 過去のメッセージの閲覧や整理 | コンテキストの遡及、議論のまとめ |
| ステータスプラグイン | システムやセッションの状態を確認 | 問題の切り分け、稼働状態の確認 |
| 動的インポートツール | 必要に応じて AI が Python 機能を補完 | データ処理、ウェブ解析、スクリプトタスク |
プラットフォーム別プラグイン
一部の組み込みプラグインは、特定のプラットフォームやアダプターのシナリオでのみ有効です。
| プラグイン | 適している場面 |
|---|---|
| Bilibili ライブツールプラグイン | Bilibili ライブアダプターのメッセージ送信、Live2D 表情、効果音・アニメーション制御 |
| Minecraft ツールプラグイン | Minecraft 関連のサーバーやプレイヤーとのやり取り |
| メールツールプラグイン | メール送信、メール関連の自動化タスク |
| グループ栄誉プラグイン | グループ栄誉などグループチャット情報に関連する機能 |
対応するプラットフォームを使用していない場合は、これらのプラグインを無効のままにしておくことができます。
追加設定が必要なプラグイン
一部のプラグインは有効化後、正しく動作するために設定の入力が必要です。
よくある例：
| プラグイン | 準備が必要なもの |
|---|---|
| Google 検索ツール | Google 検索 API Key と CX |
| AI 音声プラグイン | 音声サービスアドレス、ボイスまたは関連サービスの設定 |
| メールツールプラグイン | メールアカウント、認証コード、SMTP/IMAP などの情報 |
| 風紀委員 | 管理権限、管理チャンネル、ミュート上限などの設定 |
| Bilibili ライブツールプラグイン | ライブアダプター関連の設定 |
具体的な設定項目は、プラグイン管理ページの表示に従ってください。
使用上の推奨事項
基本機能を安定させる
基本インタラクション、画像閲覧、ステータスなどのプラグインは、通常の使用において基本的な機能です。影響を明確に理解していない限り、安易に無効化しないことをお勧めします。
同じ機能を重複して有効化しない
複数のプラグインが同様のタスクを実行できる場合、AI が選択に迷う可能性があります。安定したよく使うプラグインを1つだけ残すことをお勧めします。
本番環境では高権限機能の有効化に注意する
グループ管理、サーバー、外部サービス呼び出しに関わるプラグインについては、まず権限範囲と使用シナリオを確認してから、本番チャンネルで有効化することをお勧めします。
次のステップ
- プラグイン使用原則 — プラグインの選択と管理方法について学ぶ
- コミュニティプラグイン — サードパーティプラグインの選択方法について学ぶ
- プラグインジェネレーター — ビジュアル方式でプラグインを作成する