MCP

nac:野心的な長期タスクを AI エージェントに委譲してもフォーカスを失わない方法

AI エージェントに長期的に任せつつ暴走を防ぎたいなら、nac のオーケストレーター+episode アーキテクチャが最適。ただし開始前に必ずモデル認証を完了する必要があり(Arcee のデバイスコードログインを推奨)、オーケストレーター自体はコマンドの実行やファイルの編集ができません。

公式ソース · GitHub - arcee-ai/nac

インストール

nac-web upgrade

こんな人に向いている

  • 大きな長期タスクを AI エージェントに任せたいが、暴走するのが不安なユーザーに向いています:nac は Arcee がオープンソースで公開しているエージェント実行フレームワークで、スレッド&エピソード(thread-and-episode)アーキテクチャを採用しています。中央のオーケストレーターが計画と作業の分解を担当しますが、コマンドの実行もファイルの編集もできず、スレッドを起動できるだけです。各スレッドが終了すると「episode」、つまり構造化された作業サマリーが返され、何をしたのかを正確に把握できます。
  • すでに他のエージェントツール(harness)を使っていて、nac を組み込みたいユーザーに向いています:公式の説明によると、nac はポータブルな onboarding skill と MCP 統合を提供しており、公式が示す接続スニペットを任意のエージェントツールに貼り付けるだけで、nac のインストール、設定完了、MCP 接続まで行えます。
  • コマンドライン実行ツールとして直接使うことには向いていません:オーケストレーターはコマンドの実行やファイルの編集を代行できず、実行はすべて起動されたスレッド内で行われます。
  • 対応する具体的なエージェントクライアントの一覧、プラットフォーム互換性、リソース要件については、エビデンスには記載がなく、不明点です。

3 分で最初の試行を完了する

推奨されるメインの経路:公式インストーラー → デバイスコードログイン → ローカルダッシュボード。

  1. 前提条件:依存関係やインストーラーのコピー可能なコマンドについてはエビデンスに記載がないため、公式 README のインストール手順に従ってください。インストールが完了すると、nac-web がインストーラーによって $HOME/.local/bin に配置されるので、必要に応じてこのディレクトリを PATH に追加してください。
  2. モデル認証を選択します。これはセッション開始前に必ず完了しておく必要があるステップです(ダッシュボード上で後から行うこともできます)。公式の推奨経路は Arcee のデバイスコードログインで、これにより Latest Open と Arcee Trinity モデルを利用できます。
nac-web arcee-auth login
  1. プロジェクトのディレクトリからダッシュボードを起動します。成功のサイン:ダッシュボードにアクセスでき、認証が完了してモデルを選択できる状態になっていること。

その後のアップデート:nac にはネイティブのアップグレード機能が組み込まれており、最新の安定版をインストールできます。

nac-web upgrade

代替の認証方法(あくまで補足):nac-web codex-auth login では ChatGPT アカウントで OAuth 経由により OpenAI モデルを利用できます。または、ディレクトリプロバイダーの API キー(例:OPENAI_API_KEY)をエクスポートします。注意:ログインにはあなたのアカウント認証情報が関わります。セッション開始前に必ずモデル認証方式を選択しておく必要があります。最初の試行では、低リスクで結果が観察しやすいタスクを 1 つだけ発行し、読み取り専用の操作を優先することを推奨します。episode 内の作業はスレッドによって実行され、実際のタスクには書き込み操作が含まれる可能性があるため、重要な副作用が発生する前に確認ステップを設けるべきです。

使用例

  1. 長期タスクを委譲し、構造化された結果を受け取る:ローカルダッシュボードで、認証済みのモデル(Arcee のデバイスコードログイン後の Latest Open または Arcee Trinity モデルを推奨)を使ってセッションを開始し、タスクを発行します。オーケストレーターは作業を分解してスレッドを起動し、スレッドの終了時に episode——何を完了したのかを説明する構造化サマリー——を返します。期待できる結果:プロセス全体を見張っていなくても、episode を通じて各作業の成果を把握できます。

  2. 既存のエージェントツールに nac を組み込む:公式はポータブルな onboarding skill と MCP 統合を提供しており、公式が示す接続スニペットを任意のエージェントツールに貼り付けるだけで、nac のインストール、設定完了、MCP 接続まで行えます。具体的なエージェントクライアント向けのステップバイステップの詳細はエビデンスに示されておらず、使用しているエージェントでの実際の挙動は実際の接続結果に依存します。確認できるのは、この公式提供の接続機能が存在するという点です。

利用上の境界

  • 読み書きの性質:オーケストレーター自体は計画とスレッドの起動のみを行い、コマンドを実行せずファイルも編集しません。実際の実行はスレッド内で行われるため、実際のタスクには書き込み操作やコマンド実行が含まれる可能性があります。最初の試行は結果が観察しやすいタスクから始め、重要な副作用が発生する前に確認ステップを設けることを推奨します。
  • 認証要件:セッション開始前にモデル認証を完了しておく必要があります(推奨は nac-web arcee-auth login のデバイスコードログイン。または nac-web codex-auth login、あるいは OPENAI_API_KEY などのディレクトリプロバイダーの API キーのエクスポート)。無料枠や課金の有無についてはエビデンスに記載がなく、不明点です。
  • ローカルコンポーネント:nac-web はインストーラーによって $HOME/.local/bin に配置され、ダッシュボードはローカルで動作するため、ローカルへの状態書き込みが発生します。アンインストール手順についてはエビデンスに記載がありません。
  • 公式による明示的な制限:オーケストレーターはコマンドの実行やファイルの編集ができず、スレッドを通じて episode 形式の構造化された結果を取得できるだけです。
  • 未確認の重要情報:対応する具体的なエージェントクライアント、モデル呼び出しの費用とクォータ、スレッド実行の環境分離と権限の境界、ポータブル onboarding skill の具体的なインストールコマンドと名称は、いずれも公式のエビデンスには記載されていません。高リスクのタスクを引き受ける前に、これらの点を公式ドキュメントやリポジトリで確認することを推奨します。「説明が見つからない」ことを「リスクがない」と解釈しないでください。