> ## Documentation Index
> Fetch the complete documentation index at: https://docs.cowagent.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# 自律進化

> Self-Evolution — 会話がアイドル状態になった後に振り返り、記憶を蓄積し、スキルを改善し、未完了のタスクに対応する

## 機能概要

### はじめに

自律進化（Self-Evolution）は、Agent が単発のタスクをこなすだけでなく、あなたとのやり取りを通じて成長し続けられるようにする仕組みです。会話が一段落すると、Agent は静かに振り返りを行います。覚えておくべきことを長期記憶に保存し、スキルで見つかった問題を修正し、やり残したタスクを引き継いで進めます。使い込むほど、Agent はあなたの好みを理解し、同じ失敗を繰り返さなくなり、自分から物事を仕上げるようになります。これらはすべてバックグラウンドで静かに行われ、実際に何かを行ったときだけ簡潔に知らせます。

> 自律進化は[夢境蒸留](/ja/memory/deep-dream)と補完し合います。夢境蒸留が記憶そのものを整理するのに対し、自律進化はさらに一歩進んでスキルを改善し、未完了のタスクを前に進め、日々の利用を通じて Agent の能力を磨きます。

### 3 つの目標

自律進化は次の 3 つを軸に動きます：

| 目標             | 説明                                                                            |
| -------------- | ----------------------------------------------------------------------------- |
| **記憶の蓄積**      | 会話中の重要な好み、決定、事実を記憶に補い、メインの会話の取りこぼしを補完します                                      |
| **スキルの改善**     | スキルの利用中に問題（設定の誤りや手順の欠落など）が見つかったら、メモを残すだけでなくスキルファイルを直接修正します。必要に応じて新しいスキルも作成します |
| **未完了タスクへの対応** | 会話に残ったやるべきことを見つけ、可能なときにその場で完了させます                                             |

振り返りが終わり、実際に変更を加えた場合は、Agent が「何を学び、どこを調整したか」を会話の中で一言で伝えるので、元に戻すかどうかを判断できます。

## 使い方

### トリガーのタイミング

自律進化は定時実行ではなく、**会話が自然に終わってアイドル状態になった後**にのみ起動するため、進行中のやり取りを妨げることはありません。次の 2 つの条件を同時に満たす必要があります：

* **会話がアイドル状態**：最後のやり取りから、設定したアイドル時間（デフォルトは 10 分）以上が経過している
* **振り返るだけの内容がある**：前回の進化から十分なターン数が蓄積されている、またはコンテキストが容量の上限に近づいている

両方の条件を満たしたときにのみ振り返りが始まります。これにより、振り返る価値のある内容を確保しつつ、会話の途中で邪魔をしないようにしています。

### 関連設定

自律進化は Web コンソールの「設定 → Agent 設定」（「ディープシンキング」の下）にあるスイッチで切り替えられるほか、設定ファイルで調整することもできます：

| パラメータ                         | 説明                                | デフォルト値  |
| ----------------------------- | --------------------------------- | ------- |
| `self_evolution_enabled`      | 自律進化を有効にするかどうか（新規インストールはデフォルトで有効） | `false` |
| `self_evolution_idle_minutes` | 会話がアイドル状態になってからトリガーするまでの時間（分）     | `10`    |
| `self_evolution_min_turns`    | トリガーに必要な最小会話ターン数                  | `6`     |

<Tip>
  Web コンソールでは有効・無効のスイッチのみを提供しています。アイドル時間やターン数のしきい値を変更したい場合は、設定ファイルを編集してください。変更は即時に反映され、再起動は不要です。
</Tip>

### 進化の記録

各振り返りは日付ごとに `memory/evolution/YYYY-MM-DD.md` に記録され、Web コンソールの「メモリ管理 → 自律進化」タブで確認できます。このタブには自律進化の記録と夢日記の両方がまとめられており、Agent の成長の軌跡を一箇所で振り返ることができます。

### 元に戻す方法

ある振り返りの変更に納得できない場合は、会話の中で Agent に「直前の変更を取り消して」と伝えるだけで、振り返り前のバックアップから該当ファイルを復元します。各振り返りはそれぞれ独立したバックアップを持つため、互いに干渉することはありません。

## 設計

自律進化はシステムの既存の機能を再利用しており、軽量に保たれています：

* **隔離実行**：各振り返りは独立した短命のタスクとして実行されます。メインの会話と同じモデルを使いますが、ツールは制限されています（コンテキストの読み取りと、記憶およびスキルファイルの編集のみ可能）。メインの会話のコンテキストを汚さず、その動作にも影響しません。
* **バックアップによる取り消し**：振り返り前に該当ファイルのスナップショットを取り、取り消し時にそのスナップショットから復元するため、すべての変更が追跡可能で元に戻せます。
* **変更検知**：振り返り後にファイルのスナップショットを比較して実際に変更があったかを確認し、それをもとに通知するかどうかを判断します。これにより「何もしなければ通知しない」ことを仕組みとして保証します。

### 抑制と安全性

自律進化は、必要なときに動き、それ以外のときは邪魔をしないように設計されています：

| 仕組み              | 説明                                       |
| ---------------- | ---------------------------------------- |
| **何もしなければ通知しない** | 振り返りで実際の変更がなければ、静かなままで何も送りません            |
| **アイドル時のみトリガー**  | 会話がアイドル状態になったときだけ実行し、進行中の会話を妨げません        |
| **変更を元に戻せる**     | 振り返りごとに事前にバックアップを取るため、納得できない結果は取り消せます    |
| **組み込みスキルの保護**   | 製品に付属する組み込みスキルは保護され、変更されません              |
| **ワークスペースに限定**   | すべての読み書きはワークスペース内に限定され、他のシステムファイルには触れません |
| **バックグラウンド実行**   | 振り返りはバックグラウンドで実行され、通常の返信を妨げません           |