AI フォーム入力 API で Web フォームを自動化

1. タスクを説明する

   几帳面なアシスタントに指示するつもりでゴールを書きます。フォームに必要なすべての値と、何をもって成功とするか（「確認番号を教えてください」など）を含めます。フォームの URL がわかっているなら、そのフォームから始めましょう。

2. エージェントがフォームを入力する

   エージェントはステップごとにページを読み、クリック、入力、選択肢の選択、ファイルのアップロード、保存済みシークレットの入力のいずれか 1 つの操作を行います。フォームを送信するボタンをクリックする前には、すべてのフィールドをゴールと照合し、合わない値を修正します。

3. あなたが承認し、エージェントが送信する

   デフォルトでは、エージェントは購入、予約、メッセージ送信、削除、応募の前に一時停止し、フォームの値を見せます。あなたが承認を返信すると、実行は answer と、スキーマを指定した場合はそのスキーマに沿った data を返して終了します。

curl https://lovelyrouter.com/v1/browser/runs \
  -H "Authorization: Bearer $LOVELY_API_KEY" \
  -H "content-type: application/json" \
  -d '{
    "goal": "Request a quote for 500 blue 750 ml water bottles with our logo, delivered to 12 Main St, Springfield, IL 62701 by December 1, 2026. Contact: Ada Lovelace, ada@example.com. Submit the form and tell me the quote reference.",
    "start_url": "https://supplier.example.com/quote",
    "approve": "submit",
    "output_schema": {"quote_reference": "string", "confirmation_message": "string"},
    "webhook": "https://api.example.com/hooks/browser"
  }'

リクエストはすぐに 202 を返し、エージェントはバックグラウンドで作業します。"approve": "submit" を指定すると送信ボタンの手前で止まり、Webhook に署名付きの run.waiting イベントが届きます。その needs には、人に向けた prompt、fields に入ったフォームの値、action に入ったボタンのラベル、そしてスクリーンショットが含まれます。次のように承認します。

curl https://lovelyrouter.com/v1/browser/runs/brun_5b7d9f1a3c5e7a9b1d3f5a7c/reply \
  -H "Authorization: Bearer $LOVELY_API_KEY" \
  -H "content-type: application/json" \
  -d '{"approve": true}'

エージェントがボタンをクリックして作業を終えると、answer と data の JSON を含む run.finished が届きます。代わりに {"approve": false, "reason": "Wrong address"} と返信すると、エージェントは送信しません。理由を読み、別の方法を試すか、送信できない理由を報告します。

各認証情報は PUT /v1/browser/vault/{name} で一度だけ保存します。値の value、種類の kind（password、username、text、totp）、入力してよい origins を指定します。実行の secrets には名前を渡します。モデルに見えるのは portal_password のような名前だけで、値は許可したサイトでしか入力されないため、そっくりな偽のログインページに値が渡ることはありません。

実行の様子を見るには、"stream": true, "screen": true を追加すると、各ステップとブラウザの画面をリアルタイムで受け取れます。ページに CAPTCHA が表示されると、エージェントがライブビューのリンクを渡します。あなたが CAPTCHA を解いて {"done": true} と返信すると、エージェントは作業を続けます。エージェントは、あなたが所有しているか利用を許可されているアカウントでのみ使ってください。詳しくは利用規定をご覧ください。

料金はステップ単位で、高速モードは $0.006、日付ピッカー、地図、独自ウィジェット向けの高精度モードは $0.012 です。モデル料金は含まれており、実行料金はかかりません。ログインには 4〜8 ステップ、複数ページにわたる長いフォームには 15〜25 ステップかかります。各ステップには 1 分が含まれており、人の対応を待つ時間がそれを超えると 1 分あたり $0.005 がかかります。一時停止そのものはステップとして課金されません。実行は max_steps × ステップ単価に、human_timeout_minutes までの待機 1 回分を加えた額を仮押さえし、実際の利用分で精算されます。失敗した実行や停止した実行は、実行済みのステップ分を支払います。料金と、ベンチマークについてはブラウザエージェントのページをご覧ください。