高度な設定
高度な設定は、初回デプロイ時に必ず変更する必要があるものではありません。通常のチャットが利用できるようになってから、実際のニーズに応じて調整してください。
設定する場所
WebUI の「システム設定」→「基本設定」で、ページ内検索を使って設定項目名を素早く検索できます。
いつ高度な設定を変更すべきか
| シナリオ | 確認を推奨する項目 |
|---|---|
| Bot の応答が頻繁すぎる。コストを制御したい、またはスパムを防止したい | 応答割り当て |
| どのメッセージが Bot をトリガーするかを制御したい | トリガーと無視ルール |
| 通常のコマンドをもっと入力しやすくしたい | コマンドエクスペリエンス |
| AI がなぜそのように応答するかを切り分けたい | デバッグとログ |
| アップロードファイルが大きすぎてシステムに拒否される | ファイルアップロード |
| 画像認識の効果が良くない、またはコストが高すぎる | 視覚機能 |
| モデルサービスへのリクエストにプロキシが必要 | ネットワークとプロキシ |
| サンドボックスタスクが頻繁にタイムアウトする、または同時実行数が不足 | サンドボックス設定 |
| 危険な管理コマンドを使用する必要がある | 高度な管理コマンド |
応答割り当て
応答割り当ては、Bot のチャンネルでの応答数を制限するために使用します。呼び出しコストの制御、スパムの削減、公開チャンネルの保護に適しています。
| 設定項目 | デフォルト値 | 説明 |
|---|---|---|
AI_CHAT_ENABLE_HOURLY_LIMIT | false | 時間あたりの制限を有効化し、1日の割り当てを各時間に均等に分配 |
AI_CHAT_QUOTA_SUPER_USERS_EXEMPT | true | 管理者は応答割り当ての制限を受けない |
AI_CHAT_QUOTA_WHITELIST_USERS | [] | ホワイトリストユーザーリスト。リスト内のユーザーは応答割り当ての制限を受けない |
割り当てが尽きた時
割り当てが尽きると、Bot は通常「残高不足」とグループ内に通知するのではなく、直接応答しなくなります。Bot が突然静かになった場合は、まず割り当て設定を確認してください。
トリガーと無視ルール
トリガールールは、Bot がいつメッセージに応答するかを決定します。公開グループチャットやメッセージ量の多いチャンネルでは、実際のニーズに応じてトリガー範囲を制御することをお勧めします。
よくある設定には以下が含まれます：
| タイプ | 説明 |
|---|---|
| トリガー正規表現 | 指定されたルールに一致するメッセージのみが Bot をトリガーしやすくなる |
| 無視正規表現 | 指定されたルールに一致するメッセージは Bot に無視される |
| ランダム応答 | 明確に呼び出されていない場合でも、確率に基づいてチャットに参加することを許可 |
| 監視モード | メッセージを記録・監視するだけで、積極的には応答しない |
正規表現を設定する際は、まず小範囲のチャンネルでテストすることをお勧めします。ルールが広すぎると Bot が頻繁に応答し、狭すぎると通常のメッセージがトリガーできなくなります。
チャンネルレベルの設定が優先
特定のグループやチャンネルのみを調整したい場合は、チャンネル管理 のオーバーライド設定を優先的に使用し、グローバルルールを直接変更しないでください。
コマンドエクスペリエンス
| 設定項目 | デフォルト値 | 説明 |
|---|---|---|
COMMAND_MATCH_ALLOW_HYPHEN_FOR_UNDERSCORE | true | ハイフンをアンダースコアの代わりに入力してコマンドをマッチさせることを許可。例えば /na-info が /na_info にマッチする |
デフォルトのオンを維持することをお勧めします。これにより、モバイル端末でのコマンド入力がより便利になります。
デバッグとログ
これらの設定は主に問題の切り分けに使用されます。通常はオフのままにしておき、切り分けが必要な時に一時的にオンにすることをお勧めします。
| 設定項目 | デフォルト値 | 説明 |
|---|---|---|
SAVE_PROMPTS_LOG | false | チャットプロンプト生成ログを保存し、AI が受け取ったコンテキストの切り分けを容易にする |
DEBUG_IN_CHAT | false | チャットにデバッグ情報を出力。問題の一時的な特定に適している |
APP_LOG_LEVEL | INFO | アプリケーションのログレベル。より詳細なログが必要な場合は DEBUG に変更 |
デバッグ完了後はオフに戻してください
デバッグログには多くのコンテキスト情報が含まれる可能性があります。問題の切り分けが完了したら、デバッグ関連の設定をオフに戻してください。
ファイルアップロード
| 設定項目 | デフォルト値 | 説明 |
|---|---|---|
MAX_UPLOAD_SIZE_MB | 10 | アップロードファイルのサイズ上限。単位は MB |
AI に大きな画像、ドキュメント、スプレッドシートを頻繁に分析させる場合は、この値を適切に大きくしてください。
むやみに大きくしないこと
アップロード上限が大きいほど、処理時間とリソース使用量も高くなる可能性があります。実際のニーズに応じてのみ調整してください。
視覚機能
視覚機能は、Bot が画像の内容を理解するために使用します。通常、画像入力に対応したモデルグループに依存します。
注意すべきよくあるシナリオ：
| シナリオ | 推奨事項 |
|---|---|
| 画像認識が失敗する | 現在のモデルが視覚入力に対応しているかを確認 |
| 画像が大きすぎるか多すぎる | アップロード制限を調整するか、ユーザーに圧縮してから送信してもらう |
| コストが高すぎる | 画像トリガーシナリオを制限し、すべての画像がモデルに入力されないようにする |
| グループチャットで画像が集中する | トリガールールやチャンネルオーバーライド設定と連携して応答を制限 |
通常のテキストチャットのみの場合は、視覚関連の設定をオンにしたり調整したりする必要はありません。
ネットワークとプロキシ
モデルサービス、プラグインインターフェース、または一部の外部リソースへのアクセスにプロキシが必要な場合は、システム設定でプロキシ関連のオプションを設定できます。
プロキシを使用する際は、以下を確認することをお勧めします：
- プロキシアドレスが Nekro Agent コンテナまたは実行環境からアクセス可能であること
- プロキシ認証情報が正しく入力されていること
- 異なるサービスが同じプロキシを経由する必要があるかどうか
- 内部ネットワークアドレスがプロキシを経由すべきでないかどうか
プロキシ設定が間違っている場合、よくある症状はモデルリクエストのタイムアウト、プラグインからの外部サービスへのアクセス失敗、更新チェックの失敗などです。ログセンター と連携して具体的なエラーを確認できます。
サンドボックス設定
サンドボックスは AI が生成したタスクの実行に使用されます。ほとんどの場合はデフォルトのままで問題ありません。
| 設定項目 | デフォルト値 | いつ変更すべきか |
|---|---|---|
SANDBOX_RUNNING_TIMEOUT | 120 | 通常のサンドボックスタスクが頻繁にタイムアウトする場合に増やす |
SANDBOX_MAX_CONCURRENT | 4 | 同時タスクが多く、マシンリソースが十分な場合に増やす |
SANDBOX_IMAGE_NAME | kromiose/nekro-agent-sandbox | カスタムの汎用サンドボックスイメージを使用する場合に変更 |
SANDBOX_CHAT_API_URL | 自動生成 | サンドボックスから Nekro Agent API にアクセスできない場合に確認 |
SANDBOX_ONEBOT_SERVER_MOUNT_DIR | /app/nekro_agent_data | OneBot プロトコルエンドから NA リソースファイルにアクセスできない場合に確認 |
Claude Code サンドボックス
ワークスペースと Claude Code を使用している場合は、以下の設定にも注意を払う必要がある場合があります：
| 設定項目 | デフォルト値 | いつ変更すべきか |
|---|---|---|
CC_SANDBOX_IMAGE | kromiose/nekro-cc-sandbox | カスタムの Claude Code サンドボックスイメージを使用する場合に変更 |
CC_SANDBOX_IMAGE_TAG | latest | CC サンドボックスイメージのバージョンを固定または切り替える場合に変更 |
CC_SANDBOX_PORT_RANGE_START | 40000 | ホストマシンのポート範囲が使用されている場合に調整 |
CC_SANDBOX_PORT_RANGE_END | 49999 | ホストマシンのポート範囲が使用されている場合に調整 |
CC_SANDBOX_STARTUP_TIMEOUT | 120 | CC サンドボックスの起動が遅く、頻繁にタイムアウトする場合に増やす |
まずワークスペースページの表示を確認
Claude Code サンドボックスの起動に失敗した場合は、まずワークスペースページとサンドボックスのログを確認してから、これらの設定を調整するかどうかを判断してください。
高度な管理コマンド
| 設定項目 | デフォルト値 | 説明 |
|---|---|---|
ENABLE_ADVANCED_COMMAND | false | 高度な管理コマンドを有効化 |
高度な管理コマンドには、データのクリーンアップ、ワークスペースの削除などの高リスク操作が含まれる場合があります。明確に必要である場合のみ有効化することをお勧めします。
慎重に有効化してください
有効化後は、信頼できる管理者のみが関連コマンドを使用できるようにしてください。操作完了後、継続的な必要がない場合はオフに戻してください。
推奨される調整順序
どのように調整すべきかわからない場合は、以下の順序をお勧めします：
- まずデフォルト設定のままデプロイを完了する
- Bot が正常にチャットできることを確認する
- チャンネルの規模に応じて応答割り当てを設定する
- ファイル処理のニーズに応じてアップロード上限を調整する
- チャンネルの規模に応じてトリガーと無視ルールを設定する
- 問題が発生した時に一時的にデバッグとログを有効化する
- ワークスペースを使用した後、必要に応じて Claude Code サンドボックス設定を調整する
関連ドキュメント
- システム設定 — 必須設定とモデルグループ設定
- モデル管理 — モデルグループと呼び出しパラメータの管理
- ワークスペース概要 — ワークスペースと Claude Code サンドボックスについて学ぶ
- アプリケーション更新