トラブルシューティング

当てはまる症状を探し、原因と対処を確認してください。コマンドは、task_is_draftのような短いコードでエラーを示します。すべてのコードの意味は開発者ガイドにあります。

ボードの表示が想定と違う

症状	原因	対処
タスクがボードにない	ファイルが壊れている、またはサポートされないformatVersionを持つ。	agboard --project "My project" snapshot --jsonを開き、problemsを読みます。ファイル・項目・理由が書かれています。ファイルを手で直してください。Agent Boardは書き換えません。ファイルに不備があるときを参照。
タスクに警告が出て、条件がない	TASK.mdのfrontmatterが正しいYAMLでない。	frontmatterを直します。その間も本文は表示されます。
エージェントが変更してもボードが更新されない	サーバーが動いていない、またはファイルがネットワークドライブにある。	ページを再読み込みします。agboard serveを動かしたままにします。ネットワークドライブは、ファイルの変更を知らせないことがあります。
「切断」と表示される	ローカルのサーバーとの接続が切れた。	しばらく待ちます。ページは自動で再接続し、ボードを読み直します。サーバーが止まっていたら、起動し直します。
エージェントが止まったあともタスクが稼働中のまま	稼働中はエージェントが最後に報告した状態で、リアルタイムの確認ではない。	タスクを移すか、エージェントに新しい状態を報告させます。
質問が消えた	タスクを別の列に移すと未回答の質問が取り下げられる、またはエージェントが新しい質問をした。	タスクの履歴タブを開き、現在の質問があれば回答します。

エージェントができないことがある

エラー	原因	対処
task_is_draft	タスクが下書きで、エージェントは変更できない。	ブラウザで下書きを確定します。その間、エージェントはほかのタスクを進められます。
task_is_done	タスクが完了で、エージェントは変更できない。	作業が必要なら、ブラウザでタスクを再開します。
acceptance_unmet	未達成の条件があるタスクを、エージェントが完了へ移そうとした。	エージェントに条件を検証させて達成にします。そうすればタスクは自動で完了します。
request_changed	質問がすでに回答された、取り下げられた、または置き換えられた。	タスクを読み直し、現在の質問に回答します。
folder_unbound・bound_project_missing	エージェントのフォルダがプロジェクトに登録されていない、またはプロジェクトが削除された。	フォルダを登録します: agboard project bind "My project"。データとバックアップを参照。
confirmation_required	削除には、端末での人の確認が必要。	自分でコマンドを実行します。
HookがAGBOARD_ERRORを示す	進行表を作れない（プロジェクトがない、表が256 KiBを超える、サーバーに届かない）。	メッセージが示す原因を直します。有効な進行表を取得できるまで、エージェントはボードを変更してはいけません。

サーバーが起動しない

エラー	原因	対処
already_serving	このデータフォルダで、すでに別のサーバーが動いている。	そちらを使うか、そのターミナルでCtrl+Cを押して先に止めます。
port_in_use	別のプログラムがそのポートを使っている。	別のポートを選びます: agboard serve --port 7421。
database_busy	ほかのコマンドがプロジェクトの書き込みロックを5秒以上保持している。	コマンドをもう一度実行します。

スマホからボードに接続できない

症状	原因	対処
ページが開かない	サーバーかngrokの接続が動いていない、またはコンピューターがスリープしている。	サーバーと接続を起動し直し、コンピューターをスリープさせずに稼働させます。
スマホに合言葉を入力がもう一度表示される、または接続が停止中と表示される	sessionが終わった（接続は最長12時間）、または接続を止めて開始し直したため合言葉が新しくなった。	PCに表示されている新しい合言葉を入力します（設定 → モバイル接続か、serveの起動行）。接続が停止している場合は、同じ場所でもう一度開始します。
スマホに「間違いが続いたため受け付けを止めました」と表示される	続けて5回間違えたため、モニターは正しい合言葉も含めて受け付けなくなった。	PCで停止を選んでからもう一度接続します（またはserveを再起動します）。新しい合言葉になり、回数も数え直されます。
スマホに「合言葉を受け付けられませんでした」と表示される	入力した数字が、現在の接続の合言葉と一致していない。合言葉は接続を開始するたびに変わる。	PCの合言葉をもう一度確認します。以前の起動の合言葉は使えません。
設定は保存されたがngrokに接続できなかったと表示される	ngrokのauthtokenが誤っている、またはインターネットに接続できない。	トークンと接続を確認して、保存して再試行を選びます。
ページは開くが、回答が拒否される	開いたアドレスが、現在の接続の公開アドレスではない。	接続が示すアドレスを開きます。接続を再起動すると、新しいセッションになります。
モニターが、データが古いと表示する	自動更新が止まった、または一部のプロジェクトを読めなかった。	ページを再読み込みするか、開き直します。モニターは、再び表示されると取得し直します。

それでも解決しないとき

• snapshot --jsonのproblemsを読みます。ファイルや形式のエラーを説明しています。
• どのデータフォルダを使っているか確かめます。CLI・サーバー・Hookは、同じAGBOARD_HOMEを共有していなければなりません。データとバックアップを参照してください。
• Agent Board自体を開発しているなら、開発者向けのトラブルシューティングが、ビルド・テスト・内部の失敗を扱います。