Skill 教訓
AI Agent 向け: このページの Markdown 版は https://ankole.agentbull.com/ja-JP/docs/skill-lessons/index.md にあります。ドキュメント索引は https://ankole.agentbull.com/ja-JP/llms.txt にあります。
Skill 教訓は、Agent が Skill を読み込むときに受け取る、日付付きの短い注意事項です。繰り返す tool の失敗、環境固有の問題、作業方法の誤りを避けるために使います。共有の SKILL.md は変わりません。
Skill 教訓は GBrain の Skill 最適化実験から着想を得たもので、Agent が Skill を使用する過程で蓄積する日付付きのメモです。Ankole は機械が書き込む内容をリース付きの Agent 固有のプロセスノートに限定し、Skill 本文を変更することはありません。
1 つの教訓は、1 つの Agent と 1 つの Skill に属します。すべての Agent に適用する規則は、Skill の source に記述します。
教訓になる内容
Ankole は次の 2 種類の作業上の注意事項を保持できます。
- 複数の Background Agent Job で発生した tool の問題または環境条件。
- Job の実行中に人が伝えた、他の task でも使える作業方法の修正。
教訓は、いつ停止するか、何を確認するか、tool をどう呼び出すかを示せます。成果物の品質、深さ、完全性、意見、語調、style を規定することはできません。Ankole は task の結果を採点して、教訓の効果を判断しません。
1 つの task だけに必要な指示は教訓ではありません。1 回限りの scope、format、用語の指定は、その task にだけ適用されます。多くの証拠 batch からは教訓が作られません。
必要な証拠
Ankole は、終了した Background Agent Job のうち、失敗した command または tool call がある Job、または開始後に人から message を受け取った Job を調べます。対象は直近 30 日間です。
Agent に未処理の signal Job が十分にたまると、Dreaming が reflection Job を作成します。既定の threshold は 10 です。reflection は、条件を満たす直近 30 件までの Job を受け取ります。
機械が書く教訓には、通常、2 つ以上の異なる Job の証拠が必要です。1 つの Job で十分なのは、その Job 内の人の message 自体が、教訓にまとめる再利用可能な修正を示している場合だけです。
reflection はローカル環境で読み取り専用の検査を実行できます。file の変更、network の使用、問題の修正はできません。error と tool output は信頼できない data として扱われます。
Agent が受け取る内容
有効な教訓は、完全な Skill 手順の後にある Agent-specific additions section に表示されます。各項目には日付があります。人が追加した教訓は Dreaming の教訓より先に表示されます。
廃止された教訓と、再確認の猶予期間を過ぎた機械教訓は配信されません。Skill を無効にすると、その教訓も Agent の context に入りません。保存された履歴は、引き続き運用者が確認できます。
機械教訓を最新に保つ
Dreaming の教訓は 7 日間のリースから始まります。定期実行される Dreaming は、リース期限が近づいたとき、Ankole release が変わったとき、または Skill 本文が変わったときに教訓を再確認します。
再確認には 3 つの結果があります。
- 更新：条件がまだ存在する場合、または新しい証拠がない場合に教訓を保持します。
- 陳腐化：環境に条件がなくなった場合、または Skill 本文が既に教訓を含む場合に廃止します。
- リース期限切れ：最近の実行で条件を確認できず、陳腐化したとも判断できない場合に、期限切れの教訓を廃止します。
再確認結果がない教訓は、7 日間の猶予期間後に配信を停止します。記録は履歴に残るため、運用者は経緯を確認できます。
人が追加した教訓にはリースがありません。Dreaming はそれを変更または廃止しません。
教訓を追加または廃止する
- Console で Agent Library を開きます。
- scope を グローバル既定 から対象の Agent に変更します。
- Agent Plugin または Skills で対象の Skill を見つけます。
- 教訓を追加を選び、最初に条件を、次に実行する action を記述します。
- 教訓が誤っている、古い、または不要になった場合は、廃止を選びます。
有効な Skill にだけ、人の教訓を追加できます。人の教訓には機械向けの長さ制限はありませんが、URL を含めることはできません。教訓を修正する場合は、古い項目を廃止してから新しい項目を追加します。教訓の本文は変更できません。
Console には、作成者、作成時刻、再確認日、確認済み release、証拠 Job、廃止理由が表示されます。人が取り消した内容は Dreaming の再学習禁止 list に残るため、Dreaming は同等の教訓を再追加しません。Agent は次の turn から廃止済み教訓を読みません。
学習を設定して状態を確認する
次の brain.* 設定が Skill 教訓を制御します。
| 設定 | 既定値 | 効果 |
|---|---|---|
brain.skill_learning_enabled |
true |
reflection、再確認、教訓の配信を有効にします。false にすると、保存済みの人の教訓と Dreaming 教訓を削除せずに非表示にします。 |
brain.skill_learning_reflection_threshold |
10 |
1 つの reflection Job を開始するために必要な未処理 signal Job 数を設定します。最小値は 2 です。 |
brain.maintainer_agent_uid |
未設定 | Brain メンテナンス Agent を選択し、その heavy profile でリース付き教訓を再確認します。利用可能な heavy profile がない場合、model を使う再確認を skip します。 |
brain.dreaming_task_cron |
0 5 * * * |
Dreaming が reflection の trigger を評価し、期限が近い教訓を再確認する時刻を設定します。 |
Brain → Health を開くと、Skill 学習の有効状態、Agent ごとの有効な教訓数、直近 7 日間に追加または廃止された教訓数、最も古い有効な Dreaming 教訓の age を確認できます。
制限と安全性
- 機械教訓は英語の短い 1～3 文で、最大 100 token です。条件、action、任意の確認方法で構成されます。
- 1 回の reflection が 1 つの Skill に追加できる教訓は 2 件までです。その Skill に有効な教訓が既に 10 件ある場合、Dreaming は追加しません。
- 機械教訓には URL や injection 検査に一致する内容を含められません。
- 教訓は Agent 固有です。Ankole は Agent 間で教訓を共有しません。
- task を再実行しなければ、教訓が正しいことや効果を予測することはできません。日付と条件がある文面により、Agent は実行前に現在の環境を確認します。