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

概要

手順書は、ブラウザ自動化のステップを記述した YAML ファイルです。generate で生成し、execute で実行します。

最小例

title: ダッシュボードにログイン
settings:
  baseUrl: "https://app.example.com"
  defaultTimeout: 10000
  pauseBetweenSteps: 500
  stopOnError: true
metadata:
  startUrl: "https://app.example.com/login"
  goal: "ログインしてダッシュボードを表示する"
  goalAchieved: true
  totalSteps: 3
  generatedAt: "2025-01-15T10:30:00Z"
steps:
  - ordinal: 0
    description: "ログインページに遷移"
    url: "https://app.example.com/login"
    riskLevel: low
    requiresConfirmation: false
    action:
      type: navigate
      url: "https://app.example.com/login"
  - ordinal: 1
    description: "メールアドレスを入力"
    url: "https://app.example.com/login"
    riskLevel: low
    requiresConfirmation: false
    action:
      type: input
      value: "{{email}}"
      selector:
        tagName: input
        inputType: email
        placeholder: "Email address"
  - ordinal: 2
    description: "サインインをクリック"
    url: "https://app.example.com/login"
    riskLevel: medium
    requiresConfirmation: true
    action:
      type: click
      selector:
        tagName: button
        innerText: "Sign In"
variables:
  email:
    source: prompt
    description: "ログイン用メールアドレス"
    required: true

トップレベルフィールド

フィールド必須説明
titlestringYes手順書のタイトル
naturalLanguageSummarystringNoAI 生成のサマリー
settingsobjectYes実行設定(下記参照)
metadataobjectYes生成メタデータ
stepsStep[]Yesステップの順序付きリスト(最低1つ)
notesstringNo追加メモ
contextstringNoコンテキスト Markdown
variablesRecordNo変数定義
dataSourceobjectNoバッチ実行用データソースマッピング

settings

フィールドデフォルト説明
baseUrlstring対象アプリケーションのベース URL
defaultTimeoutinteger10000ステップタイムアウト(ミリ秒)
pauseBetweenStepsinteger500ステップ間の待機時間(ミリ秒)
stopOnErrorbooleantrue最初のエラーで実行を停止

metadata

フィールド必須説明
startUrlstringYes生成開始時の URL
goalstringYesゴールの説明
goalAchievedbooleanYes生成時にゴールが達成されたか
totalStepsintegerYesステップ総数
generatedAtstringYesISO 8601 タイムスタンプ
skillsstring[]No有効なスキルプラグイン

dataSource

--data を使用したバッチ実行で使用します。
フィールド説明
mappingRecord<string, string>変数名と CSV/JSON カラム名のマッピング
dataSource:
  mapping:
    email: "Email"
    name: "Full Name"

ステップ構造

各ステップは ParsedStep オブジェクトです。各サブ構造の詳細は以下を参照してください:

共通ステップフィールド

フィールド必須説明
ordinalintegerYesステップ番号(0始まり)
descriptionstringYesステップの説明
actionActionYes実行するアクション
urlstringYesステップ実行時の想定ページ URL
riskLevellow | medium | highYesリスク分類
requiresConfirmationbooleanYes実行前にユーザー承認が必要か
capturesCapture[]No実行後にキャプチャする値
conditionstringNoテンプレート式 — falsy の場合ステップをスキップ
loopLoopNoループ定義
stepsStep[]Noネストされたステップ(ループ内で使用)
branchesBranchNo条件分岐
memoryOperationsMemoryOp[]Noメモリ操作
1つのステップに loopbranches を同時に設定することはできません。