Mbbrowser ヘルプ

日本語

简体中文
English
한국어
Русский
Português
Tiếng Việt
繁體中文
Français

日本語

简体中文
English
한국어
Русский
Português
Tiếng Việt
繁體中文
Français

Appearance

MBAgent よくある質問 FAQ ​

NOTE

本記事の翻訳作業はまだ完了していません。 中国語版原文は 中文版 を参照してください。

本編では MBAgent 使用中のよくある質問と解決策をまとめています。ここに記載のない問題については、候鳥カスタマーサポートまでご連絡ください。

一、インストールと起動 ​

Q1.1：MBAgent アイコンをダブルクリックしても反応しない ​

可能性のある原因：

  • 候鳥ブラウザが起動していない
  • 候鳥アカウントにログインしていない
  • 作業ディレクトリの権限不足

解決：

  1. 候鳥ブラウザを起動しログイン
  2. MBAgent 作業ディレクトリが存在するか確認
  3. 管理者権限で MBAgent を起動

Q1.2：起動後ずっと「作業ディレクトリを選択」が表示される ​

原因：候鳥ブラウザメインプログラムが起動していない。MBAgent が候鳥アカウント情報を読み取れない。

解決：

  1. MBAgent を閉じる
  2. 候鳥ブラウザを起動しログイン
  3. MBAgent を再起動

Q1.3：起動後中文が表示されない ​

解決：

  1. Windows 設定 → 時刻と言語 → 言語 → Windows 表示言語 → 简体中文（中国）
  2. PC を再起動

Q1.4：インストール時に「新版が既にインストールされています」が表示される ​

解決：

  1. コントロールパネル → プログラムと機能 → 旧版候鳥をアンインストール
  2. C:\Program Files\Mbbrowser を削除
  3. 新版を再インストール

二、候鳥ブラウザへの接続 ​

Q2.1：MBAgent に「候鳥 CDP を待機中」が表示される ​

可能性のある原因：

  • 候鳥ブラウザが起動していない
  • ControlV2 ポートが占有されている
  • ファイアウォールにブロックされている

解決：

  1. 候鳥ブラウザを起動
  2. 候鳥 → 設定 → ControlV2 が有効か確認
  3. ファイアウォール / アンチウイルスソフトを閉じる

Q2.2：AI が候鳥ブラウザを操作できない ​

切り分け手順：

  1. 「設定 → 公式サービス検出」 に入る
  2. 「候鳥クライアント ControlV2」 の 「検出開始」 をクリック
  3. 具体的な失敗ステップを確認

Q2.3：AI の候鳥操作が常に失敗する ​

可能性のある原因：

  • 候鳥アカウント枠を使い切った
  • 候鳥環境が破損
  • ネットワーク問題

解決：

  1. 候鳥アカウント AI 枠を確認
  2. 候鳥ブラウザ内で該当環境を手動テスト
  3. 候鳥カスタマーサポートへ連絡

Q2.4：リモートの候鳥ブラウザを制御できる？ ​

✅ 可能ですが、以下が必要：

  1. リモートマシンで候鳥ブラウザを起動
  2. ControlV2 ポートを公開
  3. MBAgent 内でリモート IP + ポートを設定

⚠️ 信頼できるネットワーク（VPN / イントラネット）でのみ使用。

三、モデルと Provider ​

Q3.1：モデル一覧が空 ​

原因：候鳥アカウントが AI モデル枠を開通していない。

解決：

  1. 候鳥コンソールにアクセス
  2. 「AI モデル」 → 枠を開通
  3. MBAgent に戻り、モデル一覧を更新

Q3.2：Provider 切替後一覧が変わらない ​

切り分け：

  1. 当該 Provider が API Key を設定しているか確認
  2. 接続テストに成功するか確認
  3. MBAgent を再起動

Q3.3：自前 Provider に接続できない ​

切り分け：

  1. API Key と Base URL が正しいか確認
  2. ネットワーク接続性をテスト（ping / curl）
  3. MBAgent ログを確認（%LOCALAPPDATA%\mbagent\logs\）

Q3.4：モデルの応答が非常に遅い ​

可能性のある原因：

  • ネットワーク問題
  • モデル過負荷
  • コンテキストが長すぎる

解決：

  1. より高速なモデルに切替
  2. 対話履歴を圧縮（/compact）
  3. ネットワークを確認

四、タスクと定时 ​

Q4.1：定时任務が予期通りトリガされない ​

切り分け：

  1. cron 式を確認
  2. MBAgent が起動しているか確認（Daemon 未インストール）
  3. タスク履歴を確認
  4. システム時刻を確認

Q4.2：PC スリープ時にタスクが実行されない ​

解決：

  1. MBAgent Daemon をインストール
  2. PC をスリープしないよう設定
  3. ウェイクアップタイマーを設定

Q4.3：タスクが常に失敗する ​

切り分け：

  1. 単独実行してエラーを確認
  2. 候鳥ブラウザのオンライン状態を確認
  3. タスク説明を簡略化し、段階的に切り分け
  4. 候鳥カスタマーサポートに連絡

Q4.4：定时任務の Token 消費が多すぎる ​

解決：

  1. 安価なモデルを使用
  2. 「思考過程表示」を閉じる
  3. 実行頻度を減らす
  4. プロンプトを最適化

五、ファイルと添付ファイル ​

Q5.1：大ファイルのアップロードが失敗する ​

制限：

  • 単一ファイルは < 50 MB を推奨
  • 超大ファイル（> 100 MB）は AI ツールにパスを読ませる

解決：

  1. ファイルを圧縮（zip）
  2. Read ツールに AI に自読させる
  3. 分割アップロード

Q5.2：AI が画像を見られない ​

可能性のある原因：

  • 現在のモデルがマルチモーダル非対応
  • 画像が大きすぎる
  • 画像フォーマット非対応

解決：

  1. マルチモーダル対応モデルに切替（gpt-5、claude-sonnet-4）
  2. 画像を圧縮
  3. JPG / PNG に変換

Q5.3：AI が修正したファイルが保存されていない ​

切り分け：

  1. 「拒否」をクリックし間違えていないか
  2. 作業ディレクトリに書込権限があるか
  3. AI メモリバンクに誤ったパスが記録されていないか確認

六、権限とセキュリティ ​

Q6.1：AI の誤った操作を取り消すには？ ​

手順：

  1. 即座に Esc で AI を停止
  2. 操作ログを確認
  3. AI の誤った操作を手動取り消し

Q6.2：AI がファイルを削除した、復元方法は？ ​

状況 1：ファイルがサンドボックス内（作業ディレクトリ）

  • 「バックアップ」を有効化していた場合、バックアップから復元
  • そうでなければ専門復元ツールが必要

状況 2：ファイルがサンドボックス外（システムディレクトリ）

  • ⚠️ この種の操作はデフォルトでブロックされるはず
  • 発生した場合は即座に候鳥カスタマーサポートへ

予防：

  • AI に重要ファイルを操作させる前にバックアップ
  • Ask モードを使用（ポップアップ確認）

Q6.3：API Key は安全？ ​

✅ 安全：

  • MBAgent は API Key をアップロードしない
  • Key は Windows 資格情報マネージャーにのみ保存
  • MBAgent アンインストール時に資格情報もクリア

⚠️ 推奨：

  • API Key を定期ローテーション
  • メモリバンクやセッションに平文 Key を貼らない

七、AI メモリバンク ​

Q7.1：AI が前の発言を「覚えていない」ように見える ​

切り分け：

  1. AI メモリバンクに当該記憶が存在するか確認
  2. AI に再度記憶させ確認
  3. 作業ディレクトリが変更されていないか確認

Q7.2：AI が誤った記憶を使った ​

解決：

  1. 当該記憶を編集
  2. 修正または削除

Q7.3：メモリバンクをバックアップするには？ ​

  1. ディレクトリ %LOCALAPPDATA%\mbagent\memory\ を見つける
  2. フォルダ全体をコピー
  3. 安全な場所に保存

八、インターフェースと表示 ​

Q8.1：インターフェースのカクつき ​

可能性のある原因：

  • システムリソース不足
  • セッション / KMS / MCP ロード過多
  • テーマレンダリング問題

解決：

  1. 不要なタブを閉じる
  2. セッション数を削減
  3. テーマ切替（ダーク < ライト）
  4. MBAgent を再起動

Q8.2：フォント表示異常 ​

解決：

  1. システムフォントが完全か確認
  2. MBAgent 設定でフォント切替

Q8.3：タブバーが見えない ​

解決：

  1. 設定 → インターフェースとナビゲーション → 表示タブ → 全部チェック
  2. MBAgent を再起動

九、性能最適化 ​

Q9.1：MBAgent のメモリ占用が高い ​

正常範囲：

  • アイドル時: 200-500 MB
  • 複雑タスク: 1-2 GB
  • 高並列: 2-4 GB

最適化：

  1. 不要なセッションを閉じる
  2. 並列タスク数を減らす
  3. 不要な MCP サービスをアンインストール

Q9.2：AI 返信が遅い ​

可能性のある原因：

  • モデルサーバ遅延
  • ネットワーク問題
  • コンテキストが長すぎる

最適化：

  1. より高速なモデルに切替
  2. 履歴を圧縮
  3. ネットワークを確認

十、更新とアップグレード ​

Q10.1：MBAgent を更新するには？ ​

MBAgent は候鳥ブラウザと一緒に更新されます：

  1. 候鳥ブラウザ起動時に新バージョンを自動検出
  2. 更新プロンプトがポップアップ
  3. 「即座に更新」 をクリック
  4. 更新後に再起動

Q10.2：更新後にデータが失われた？ ​

発生しません：

  • AI メモリバンク、セッション、KMS はすべて保持
  • 設定ファイルのみリセットされる可能性

データが失われた場合：

  1. バックアップディレクトリを確認
  2. バックアップから復元
  3. 候鳥カスタマーサポートへ連絡

Q10.3：旧バージョンにロールバックできる？ ​

可能ですが、以下が必要：

  1. 現在データをバックアップ
  2. 現バージョンをアンインストール
  3. 旧バージョンをインストール
  4. データを復元

⚠️ 注意：旧バージョンは新機能に対応していない可能性。

十一、エラーコード ​

BROWSER_AUTO_UNAVAILABLE ​

意味：ブラウザ自動化能力が使用不可。 原因：Playwright MCP browser が起動していない。 解決：

  1. Node.js と npx をインストール
  2. MBAgent に Playwright を自動インストールさせる
  3. MBAgent を再起動

CONTROL_V2_DISCOVERING ​

意味：候鳥クライアントインスタンスを発見中。 原因：起動したばかり、またはスキャン中。 解決：数秒待ってから再試行。

CONTROL_V2_HANDSHAKE_SPEC_MISMATCH ​

意味：MBAgent と候鳥クライアントが使用する ControlV2 規范バージョンが異なる。 解決：

  1. 候鳥ブラウザを最新版に更新
  2. MBAgent を最新版に更新

TOOL_ENABLE_PREREQUISITE_MISSING ​

意味：ツールの前提条件が満たされていない。 解決：

  1. 対応する Skill が有効か確認
  2. 候鳥アカウント認可レベルを確認

Houniao RAG 知識ベース現在使用不可 ​

意味：候鳥公式 RAG 知識ベースサービス異常。 解決：

  1. 候鳥アカウントが有効か確認
  2. ネットワークを確認
  3. 候鳥カスタマーサポートへ連絡

候鳥クライアント ControlV2 現在使用不可 ​

意味：候鳥ブラウザ ControlV2 プロトコル異常。 解決：

  1. 候鳥ブラウザを再起動
  2. MBAgent を再起動
  3. 候鳥ブラウザ → 設定 → ControlV2 を確認

十二、ヘルプ取得 ​

公式チャネル ​

セルフ切り分け ​

  1. MBAgent ログを確認：%LOCALAPPDATA%\mbagent\logs\
  2. 候鳥ブラウザログを確認
  3. 「設定 → 公式サービス検出」 でサービス状態を確認

問題フィードバック ​

カスタマーサポートに連絡する際は、以下を提供してください：

  • MBAgent バージョン番号
  • 候鳥ブラウザバージョン番号
  • Windows バージョン
  • 完全なエラーメッセージ
  • 操作手順
  • 必要に応じてログファイルを提供

下一步：中文版原文