Raft
Nowledge Mem Cloud Raft Appをインストールするか、Mem VaultでワーカーごとのローカルIDを維持します。
Raftは2つの異なる方法でNowledge Memに接続します。 ナレッジがNowledge Cloudワークスペースにある場合はCloudパスを使用します。 Memが自分のコンピューターまたはサーバー上で実行されている場合はMem Vaultパスを使用します。
Nowledge Cloud
Nowledge Mem Cloud Raft Appをインストールし、Raftエージェントに使用させたいCloudワークスペースから接続します。
エージェントごとにCodexやClaudeを接続したり、APIキーをRaftにコピーしたり、NMEM_AGENT_IDを手動で設定したりする必要はありません。
RaftにAppをインストールする
- RaftでSettings → Applicationsを開き、Marketplaceを選択します。
- Nowledge Mem Cloudを見つけ、Installを選択します。
Appをインストールすると、Raftサーバーで利用できるようになります。 まだNowledge Cloudワークスペースは選択されません。
Cloudワークスペースを接続する
- Nowledge Cloudを開き、サインインして、Raftに使用させたいワークスペースを選択します。 そのワークスペースに対するオーナーまたは管理者権限が必要です。
- 左側のナビゲーションでConnectorsを選択します。
- Multi-agent orchestratorsの下でRaftを見つけ、Connectを選択します。
- Login with Raftを完了し、接続したいRaftサーバーを承認します。
フローがNowledge Cloudに戻ると、RaftコネクターはConnectedと表示され、承認されたサーバーが一覧表示されるはずです。 Cloudは引き続き、すべてのリクエストにワークスペースとTeamspaceの権限を適用します。
新しいエージェントセッションを開始する
Raftに戻り、新しいエージェントセッションを開始します。 接続が完了した後に開始されたセッションでは、AppがRaftエージェントのIDと管理されたMem接続を処理します。
動作を確認する
RaftエージェントにNowledgeコンテキストを確認するよう依頼し、次にメモリを1つ保存または検索します。 ローカルのMemサーバーやエージェントごとの環境変数なしで、承認されたCloudワークスペースを使用するはずです。 コネクターがConnectedと表示されない場合は、エージェントのトラブルシューティングを行う前にCloud接続を完了してください。
Nowledge Cloudを使用する場合は、以下のMem Vaultセットアップをスキップし、共有の実行トレース境界に進んでください。
Mem Vault
Raftは同じコンピューター上で複数の名前付きエージェントを実行できます。 Nowledge Memはそれらのエージェントを、1つの匿名のCodexまたはClaudeセッションとしてではなく、別々のワーカーとして扱います。
セットアップは意図的に小さく保たれています。 まずRaftが起動するAIツールを接続し、次に各Raftエージェントに1つの環境変数を設定します。
必要なもの
- Nowledge Memが実行されていること。
- Raftが起動するAIツールがすでにMemに接続されていること。 たとえばCodexやClaude Codeです。
- 各Raftワーカーに安定した役割があること。 たとえばCindy、Alice、Reviewerなどです。
最初の有用なセットアップ
Raftワーカー用にMem AI Identityを1つ作成します:
nmem agents upsert cindy \
--name "Cindy" \
--default-space onboarding \
--instructions "Help with onboarding. Explain one step at a time."これにより、Cindyという名前のMem AI Identityが作成されます。
そのコマンドと環境IDはcindyです。
このコマンドはIDレコードを作成するだけです。
すべてのCodexセッションがCindyを使用するようになるわけではありません。
IDは、NMEM_AGENT_ID=cindyを設定した場所、またはagent_id="cindy"を明示的に渡した場所でのみ使用されます。
次に、Raftエージェントのランタイム設定を開き、環境変数を1つ追加します:
NMEM_AGENT_ID=cindy
Mem AI Identityにすでにデフォルトスペースがある場合は、これで十分です。
後でCindyを移動する
Cindy IDはRaftではなくMemに属します。
後でCindyを別のオーケストレーターに移動する場合は、NMEM_AGENT_ID=cindyを維持し、新しいランチャーがその環境変数を渡すように設定します。
AIツールも変更できます。
CindyはCodexで開始し、後でPiやClaude Codeで実行できます。
その場合は、コネクターと--source-appを新しいAIツールに更新しますが、同じMem AI Identityを維持します。
関連するが異なるワーカーが必要な場合は、cindy-reviewerのような新しいIDを作成します。
これによりCindyを安定させたまま、新しいワーカーが独自のRulesを進化させられます。
Spaceを追加するタイミング
NMEM_SPACEは任意です。
これはRaftランタイムプロセス全体に適用されます。
このRaftエージェントが、その実行中のすべてのMem読み取りと書き込みでIDのデフォルトスペースを上書きすべき場合にのみ使用します:
NMEM_SPACE=onboardingエージェントが異なるプロジェクトをまたいで作業する可能性がある場合は、NMEM_SPACEを未設定のままにし、Memまたはエージェントが実行するコマンドからアクティブなスペースを変更します。
デフォルトで2つ目のIDを追加しない
ほとんどのユーザーはNMEM_HOST_AGENT_IDを設定すべきではありません。
NMEM_HOST_AGENT_IDは、インテグレーションの作者または上級ユーザーが、raft:<uuid>のような不変の外部ワーカーIDをMem AI Identityにマッピングする必要がある場合にのみ使用します。
通常のRaftセットアップでは、NMEM_AGENT_ID=cindyの方が明確で十分です。
レガシーのslock:プレフィックスも引き続きサポートされます。
成功時の状態
nmem 0.9.0以降では、新しいRaftワーカーセッションを開始し、Memを確認するよう依頼します:
nmem --json context --source-app codexRaftワーカー内では、コマンドはNMEM_AGENT_ID=cindyを継承し、設定したワーカーIDを返すはずです。
代わりに通常のターミナルから同じ確認を実行する場合は、IDを明示的に渡します:
nmem --json context --agent-id cindy --source-app codexワーカー内のメモリ呼び出しは、codex、claude-code、またはRaftが起動したランタイムをソースとして使用します。
将来のネイティブRaft Threadコネクターは、人間が閲覧できる会話にraftを使用し、子ランタイムをメタデータとして保持します。
実行トレースをThreadsから除外する
この境界は、Nowledge CloudとMem Vaultの両方のパスに適用されます。
RaftのマネージドコンピュートはワーカーとしてCodexを使用しますが、Raftはその受信トレイとメッセージトランスポートを通じて人間の会話を所有します。 Codexのロールアウト記録は制御通知とツール実行を記録しますが、Raftのメッセージングツールで送信された返信は、通常のCodexアシスタントメッセージとしてはそこに保存されません。 そのロールアウトをインポートすると、誤解を招くThreadが作成されます。
そのためNowledge Memは、構造化されたセッションオリジネーターがraft-daemonであるCodexロールアウトをスキップします。
レガシーのslock-daemonオリジネーターも引き続きサポートされます。
これはトランスクリプトごとに確認されるため、同じコンピューター上の通常のCodexセッションは引き続き自動的にキャプチャされます。
Working Memory、リコール、永続保存には、Raft内でMemスキルまたはMCPを使用してください。
ロスレスなRaft会話履歴にはRaftネイティブの会話コネクターが必要です。
その境界が利用可能になるまで、Raft管理のワーカーにはnmem t save --from codexを使用しないでください。