概要
手順書は、ブラウザ自動化のステップを記述した YAML ファイルです。generate で生成し、execute で実行します。
最小例
トップレベルフィールド
| フィールド | 型 | 必須 | 説明 |
|---|---|---|---|
title | string | Yes | 手順書のタイトル |
naturalLanguageSummary | string | No | AI 生成のサマリー |
settings | object | Yes | 実行設定(下記参照) |
metadata | object | Yes | 生成メタデータ |
steps | Step[] | Yes | ステップの順序付きリスト(最低1つ) |
notes | string | No | 追加メモ |
context | string | No | コンテキスト Markdown |
variables | Record | No | 変数定義 |
dataSource | object | No | バッチ実行用データソースマッピング |
settings
| フィールド | 型 | デフォルト | 説明 |
|---|---|---|---|
baseUrl | string | — | 対象アプリケーションのベース URL |
defaultTimeout | integer | 10000 | ステップタイムアウト(ミリ秒) |
pauseBetweenSteps | integer | 500 | ステップ間の待機時間(ミリ秒) |
stopOnError | boolean | true | 最初のエラーで実行を停止 |
metadata
| フィールド | 型 | 必須 | 説明 |
|---|---|---|---|
startUrl | string | Yes | 生成開始時の URL |
goal | string | Yes | ゴールの説明 |
goalAchieved | boolean | Yes | 生成時にゴールが達成されたか |
totalSteps | integer | Yes | ステップ総数 |
generatedAt | string | Yes | ISO 8601 タイムスタンプ |
skills | string[] | No | 有効なスキルプラグイン |
dataSource
--data を使用したバッチ実行で使用します。
| フィールド | 型 | 説明 |
|---|---|---|
mapping | Record<string, string> | 変数名と CSV/JSON カラム名のマッピング |
ステップ構造
各ステップはParsedStep オブジェクトです。各サブ構造の詳細は以下を参照してください:
アクション
12種類のアクション型: click, input, select, navigate, scroll, wait, hover, extract, download, export, memory, key
セレクタ
14のセレクタフィールドと優先順位ベースの解決
変数
6つの変数ソースと解決優先順位
キャプチャ
ステップからデータを抽出する5つの戦略
ループ・分岐
while/forEach ループと条件分岐
メモリ操作
ステップ間でデータを蓄積・集計
共通ステップフィールド
| フィールド | 型 | 必須 | 説明 |
|---|---|---|---|
ordinal | integer | Yes | ステップ番号(0始まり) |
description | string | Yes | ステップの説明 |
action | Action | Yes | 実行するアクション |
url | string | Yes | ステップ実行時の想定ページ URL |
riskLevel | low | medium | high | Yes | リスク分類 |
requiresConfirmation | boolean | Yes | 実行前にユーザー承認が必要か |
captures | Capture[] | No | 実行後にキャプチャする値 |
condition | string | No | テンプレート式 — falsy の場合ステップをスキップ |
loop | Loop | No | ループ定義 |
steps | Step[] | No | ネストされたステップ(ループ内で使用) |
branches | Branch | No | 条件分岐 |
memoryOperations | MemoryOp[] | No | メモリ操作 |
1つのステップに
loop と branches を同時に設定することはできません。