困ったときは

よくある状況とその対処をまとめます。解決しない場合は、ヘルプ画面の 「AI に聞く」 から help アシスタントに症状を伝えるか、管理者に問い合わせてください。

タスクが「回答待ち（waiting_human）」で止まっている

エージェントが依頼の曖昧な点を確認したい、または作業を進めるために情報が必要なときに、この状態になります。

対処: タスク詳細のチャットパネルに「エージェントからの確認」が表示されているので、質問に回答を送る とタスクが再開します。回答すべき内容が分からない場合は、不足している情報（対象ファイル・期待する出力形式など）を補足してください。

なお、確認の回数には上限があり、上限に達すると回答待ちのままにはならず終了することがあります。その場合は、依頼文を具体化して新しいタスクを作り直すのが確実です。

そのタスクが生成した子タスク（サブタスク）の完了を待っている状態です。

対処: タスク詳細の サブタスクタブ で子タスクの一覧と状態を確認します。子タスクが失敗していれば、その失敗理由を確認して解消します。子タスクが進行中なら、完了すれば親タスクは自動で再開します。サブタスクの仕組みはサブタスクを参照。

タスクは失敗しても、設定された最大試行回数まで自動で再キューされて再実行されます。再実行時には前回の失敗内容が引き継ぎコンテキストとして渡され、同じ作業の重複を避けようとします。

対処:

タスク中のブラウザ操作（BrowseWeb）で、保存済みのログイン情報が期限切れになっているとこのメッセージが返ります。

対処: ワークスペース → 設定 → ブラウザで対象セッションを開き、「再ログイン」して保存し直します。詳しくは個人の資産（ワークスペース設定）を参照。ログイン情報（cookie）は時間が経つと失効するため、定期的なメンテナンスが必要です。

対処:

成果物の見方は成果物を見るを参照。

.pptx / .ppt のプレビューは、サーバー側で LibreOffice を使ってスライドを画像化します。これが未導入のサーバーでは、プレビューの代わりにダウンロード案内が表示されます。

対処:

Docker で動かしている場合は最新イメージで再ビルドしてください（イメージに LibreOffice を同梱済み）
直接（非 Docker）で動かしている場合は、サーバーに LibreOffice を入れます: sudo apt install --no-install-recommends libreoffice-impress。起動時の依存チェック（scripts/prepare.sh）でも未導入なら警告が出ます
Excel（.xlsx / .xlsm）のプレビューは LibreOffice 不要です（未導入でも表示できます）

調査の手がかりはログにあります。

タスクごとのアクティビティ・ダウンロード履歴などは、タスク詳細の Files タブ → logs/ にあります（成果物を見る参照）
サーバー全体のログは管理者が scripts/server.sh logs で確認できます。詳しく見たいときは LOG_LEVEL=debug で再起動します

ヘルプ画面の「AI に聞く」ボタンを押すと、help アシスタント（help piece）への質問タスクが作られます。MAESTRO の使い方・設定・エラーの意味など、画面の操作で迷ったときや原因の当たりを付けたいときに使ってください。

具体的な操作手順の確認にはタスクを実行するも合わせて参照してください。それでも解決しない場合は管理者に問い合わせてください。