メインコンテンツへスキップ

​
概要

操作対象アプリの UI が変わって手順書のステップが失敗するようになったとき、--self-heal モードは強化された回復機能で手順書を実行し、すべての失敗を分類して AI による修正提案を生成します。
自動修復モードには Team 以上のプランが必要です。

​
自動修復の仕組み

1

--self-heal で実行

npx @refrainai/cli execute -- \
  --runbook ./login-flow.yaml \
  --context ./context.md \
  --secrets ./secrets.json \
  --self-heal
2

強化リカバリが有効化

自動修復モードでは、通常実行時にオフになっている複数の機能（セレクタキャッシュ、Agent Fallback、Vision Fallback、リトライ上限の引き上げ（3→5）、承認の自動承認）が自動的に有効になります。詳細は下記の比較表を参照してください。
3

失敗が分類される

各失敗ステップが 6つのエラーカテゴリのいずれかに分類されます。カテゴリによって、どのような修正が最も効果的かが決まります。
4

AI が修正提案を生成

各失敗に対して、AI は 2 種類の提案を生成します：
  • 手順書修正 — 手順書自体の変更（セレクタ更新、ステップ追加、ステップ削除）
  • コンテキスト修正 — context.md の更新（ページ構造の変更記録、ナビゲーションパスの変更）
エラーカテゴリが AI プロンプトに含まれ、提案精度が向上します。
5

診断レポートを出力

詳細なレポートが生成されます：
  • ステップごとの実行結果と失敗診断
  • 各失敗のエラー分類
  • AI 修正提案
  • 回復メカニズムの有効性統計

​
自動修復 vs 通常実行

設定通常実行自動修復モード
skipConfirmationfalsetrue
enableSelectorCacheプラン依存true
enableAgentFallbackプラン依存true
enableVisionFallbackプラン依存true
maxRetries35
実行戦略標準アグレッシブ
AI 修正提案なしあり
診断レポートリクエスト時（--report）常に生成

​
修正の適用

自動修復レポートを確認した後、fix-runbook コマンドで提案を適用します： 
npx @refrainai/cli fix-runbook -- \
  --runbook ./login-flow.yaml \
  --report ./login-flow-report.md
完全なワークフローは修正を適用するを参照してください。

​
ベストプラクティス

  • 定期的に自動修復を実行 — 定期的な自動修復で UI の変更を早期に検出し、本番ワークフローへの影響を防ぎます。
  • 手順書をバージョン管理 — fix-runbook の変更をレビュー・リバートできるよう、手順書を git で管理しましょう。
  • 適用前にレビュー — AI の提案は必ず確認してから適用してください。fix-runbook コマンドは各変更の差分プレビューを表示します。
  • 修正後に再実行 — 修正適用後は通常実行で手順書の動作を検証しましょう。

​
次のステップ

修正を適用する

AI 修正提案を手順書に適用。

エラー分類

失敗がどのようにカテゴリ分類されるか。

セレクタ解決

ページ上の要素がどのように見つけられるか。