アーキテクチャ

​

システムアーキテクチャ

​

Agent モードのワークフロー

1. メッセージ受信 — チャネルを通じてユーザーの入力を受信
2. 意図の理解 — タスク要件とコンテキストを分析
3. タスク計画 — 複雑なタスクを複数のステップに分解
4. ツール呼び出し — 各ステップに適切なツールを選択・実行
5. 記憶・ナレッジの更新 — 重要な情報を長期記憶に保存し、構造化された知識をナレッジベースに整理
6. 結果の返却 — 実行結果をユーザーに送信

​

ワークスペース

​

システムワークスペース

~/cow/
├── system.md          # Agent システムプロンプト
├── user.md            # ユーザープロフィール
├── MEMORY.md          # コアメモリ
├── memory/            # 長期記憶ストレージ
│   └── YYYY-MM-DD.md  # デイリーメモリ
├── knowledge/         # パーソナルナレッジベース
│   ├── index.md       # ナレッジインデックス
│   └── <category>/    # トピック別ページ
├── skills/            # カスタム Skill
│   ├── skill-1/
│   └── skill-2/
└── agents/            # マルチエージェントチーム
    ├── team.json      # チーム名簿とチャネルのバインド
    └── <agent-id>/    # 非デフォルト Agent 専用のワークスペース

~/.cow/
└── .env               # Skill 用のシークレットキー

​

プロジェクトワークスペース

​

マルチエージェントワークスペース

• システム共有：シークレットファイル（~/.cow/.env）とチーム設定（~/cow/agents/team.json）はインスタンス全体で共有されます。
• メンバーごとに分離：各 Agent のコアファイル（SYSTEM.md、USER.md、AGENT.md、RULE.md）、記憶（MEMORY.md、memory/）、生成ファイルはそれぞれのワークスペース内にあり、メンバー間で互いに見えません。
• 共有／分離を選択可能：Skill とナレッジベースはチームで共有することも、特定のメンバー専用にすることもでき、両モードはいつでも切り替えられます。

サブ Agent はメイン Agent が一時的に立ち上げる実行ユニットで、メイン Agent とワークスペースを共有し、独自の記憶は持ちません。一方チームメンバーは常駐する正式な Agent で、ワークスペースと記憶が完全に独立しています。詳細は サブ Agent を参照してください。

​

セッション単位のモデルと権限

• モデル：セッションごとに異なるモデルへ切り替えられ、タスクに応じた選択が容易です。
• 権限：Agent が操作できる範囲を制御し、読み取り専用、ワークスペース書き込み可、フルアクセス の 3 段階があります。設定でグローバルのデフォルト権限（agent_permission_mode）を指定でき、新しいセッションはそれを引き継ぎ、必要に応じて個別に調整できます。権限は誤操作のリスクを下げるためのものです。強い分離が必要な場合はコンテナ内での実行を推奨します。

​

コア設定

{
  "agent": true,
  "agent_workspace": "~/cow",
  "agent_max_context_tokens": 40000,
  "agent_max_context_turns": 30,
  "agent_max_steps": 15,
  "agent_permission_mode": "full-access",
  "cow_lang": "auto"
}