実行タスク

エージェントが作業を始めるたびに、Melso は実行タスク（task）を 1 件作成します。実行タスクには、この実行が何によってトリガーされ、どのエージェントに渡され、いまどこまで進んでいて、最終的に成功したかどうかが記録されます。

イシューと実行タスク

イシューは 1 つの作業の目標、議論、担当者、最終ステータスを保持します。実行タスクは、その作業に対するエージェントの 1 回の実行を記録します。

そのため、同じイシューを順番に別のエージェントへ渡すことも、失敗のあとにもう一度実行することもできます。実行のたびに新しいタスクが作成され、以前の記録が上書きされることはありません。

トリガー元

次の操作はいずれも実行をトリガーできます。

• イシューをエージェントまたはスクワッドに割り当てる。
• コメントでエージェントをメンションする。
• チャットでエージェントにメッセージを送る。
• オートパイロットがスケジュールまたは外部イベントで発火する。

入口によって渡されるコンテキストは異なりますが、実行の仕組みは同じです。Melso がタスクを作成し、ランタイムがそれを取得して、エージェントに設定された AI コーディングツールを呼び出します。

実行の流れ

タスクは通常、次の状態を経ます。

ランタイムがオンラインなら、新しいタスクは通常すぐに始まります。キューに入ったあとでランタイムがオフラインになった場合、タスクは復帰までキューで待機します。2 時間を超えて取得されないタスクは失敗として終了します。

ハートビートが正常なランタイムは長時間のタスクを実行できます。実行時間が長いという理由だけで、サーバーが実行を強制終了することはありません。プロセスが停滞しているかどうかは、ランタイムが実際のアクティビティに基づいて判断します。関連する設定は環境変数を参照してください。

実行履歴の確認

イシューを開くと、実行ログでそのイシューが生んだすべてのタスクを確認できます。各行にはトリガー元、実行したエージェント、状態、時間が表示されます。

ここでは次の操作ができます。

• 実行記録を開き、エージェントのメッセージ、ツール呼び出し、エラー出力を確認する。
• 後で発火する予定・キュー待ち・起動中・ローカルディレクトリ待ち・実行中のタスクを停止する。
• 失敗またはキャンセルされたタスクをリトライする。

失敗と自動リトライ

ランタイムの一時的なオフライン、デーモンの再起動、実行タイムアウト、AI コーディングツールのネットワーク中断といった一時的な障害は、自動リトライをトリガーできます。通常のタスクはデフォルトで最大 2 回まで、ツールのネットワーク中断は最大 3 回まで実行されます。

エージェント自身が返したエラーは、通常は自動リトライされません。認証の失効、クォータ不足、設定ミス、モデルがリクエストを完了できない場合などは、まず原因を解消してから手動でリトライしてください。

オートパイロットの実行のみモードは、次のスケジュール実行と重ならないよう自動リトライしません。イシューを作成モードが生成するのは通常のイシュータスクなので、インフラ障害は上記のルールどおりリトライされます。どちらのモードも、最終結果はオートパイロットの実行履歴で確認できます。

イシュー上に他のアクティブなタスクがなく、実行を待つ新しいリトライもない場合、失敗によって in_progress のイシューは todo に戻ります。

失敗理由リファレンス

実行ログと使用量統計に表示される失敗理由は 2 つに分かれます。接頭辞のない理由コードはプラットフォームが記録するもの、agent_error.* は AI コーディングツール自身のエラーから分類されたものです。

プラットフォーム側

ツール側（agent_error.*、接頭辞は省略）

手動リトライ

実行ログで行の再試行ボタンをクリックすると、当時そのタスクを実行したエージェントが再び呼び出されます。その後イシューの担当者が変わっていても、新しい担当者には切り替わりません。

リトライは、前回の実行がローカルディレクトリに書き込んだファイルをできる限り保持します。元のセッションがまだ安全で、同じランタイムが取得した場合は、前回のセッションも引き継ぎます。コンテキスト超過や不正なリクエストなど、セッションを汚染するエラーの場合は、元の作業ディレクトリの上で新しいセッションを開始します。元のディレクトリがすでに存在しない場合は、新しい作業ディレクトリを使います。

CLI から現在のイシューを再実行することもできます。

melso issue rerun <issue-id>

この方法は過去の特定のタスクを指さないため、イシューの現在のエージェント担当者を使い、新しいセッションと作業ディレクトリから開始します。

実行の完了とイシューの完了

completed は、この 1 回の実行が正常に終了したことだけを表し、イシューの目標が達成されたことを保証するものではありません。結果を確認し、議論を続け、要件を追加し、もう一度エージェントをトリガーできます。

イシューが完了したかどうかは、実際の作業の進み具合とイシューのステータスで判断してください。

状態とタイムアウトの早見表

以下の数値はサーバーのデフォルト設定に対応しており、トラブルシューティング時の照合に使えます。

自動リトライは以下の一時的な障害のみを対象とし、イシューまたはチャットに紐づくタスクにのみ適用されます（オートパイロットの実行のみモードを除く）:

その他の失敗原因（認証、クォータ、設定、モデルなど）は自動リトライされません。先に原因を解消してから手動でリトライしてください。

次のステップ

• デーモンとランタイム — タスクがどのコンピュータで実行されるかを知る。
• イシューをエージェントに割り当てる — イシューから実行をトリガーする。
• エージェントのメンション — コメントで要件を補足し、他のエージェントを参加させる。