keep_session: true を設定するとタスク完了後に一時停止し、sandbox_id が返されます。その sandbox_id を次の BROWSER_USE_SANDBOX_RUN_TASK ステップに渡すことで、同じブラウザセッションに再接続してタスクを続行できます。
設定
入力
クレジット消費
openai_api_key が空の場合、このステップはステップあたりの定額ではなく、選択した llm_model のレートでトークン単位のJinbaクレジットが課金されます。自分のAPIキーを指定した場合はOpenAIに直接課金されるため、クレジットは消費しません。
- 実行前に、
max_steps× ブラウザ1ステップあたりの想定トークン数(各ステップでページのDOMと実行履歴を送り直します)を、そのモデルのレートで換算した分が予約されます。この予約額は実行可否の判定も兼ねており、残高が予約額に満たない場合はサンドボックスが起動する前にステップが失敗します。 - 実行後に、予約額はエージェントが実際に報告したトークン使用量に置き換えられます。タスクが成功しても失敗しても同じです。
max_steps: 100の上限がかかるのは予約額だけで、最終的な課金額は実使用量に従います。 - 使用量がまったく報告されずに終了した実行は、ツールの最低課金額(定額)で確定します。これは1回あたりの料金ではなく、使用量を報告した実行はトークン分だけ課金されます。
- リストに対して繰り返し実行するステップ(
forEach)は、1回ごとに精算されます。 各回は単独で実行した場合と同じく上記2つのルールで課金され(その回が報告したトークン、報告がなければ最低課金額)、ステップの課金額は全回の合計です。予約額だけは引き続き1回分なので、実行前の残高チェックは最終的な課金額の上限にはなりません。20回繰り返すループは1回分の最大20倍まで課金され得ます。forEachを使うブラウザ操作ステップは、予約額ではなく「1回あたりのコスト × 件数」で見積もってください。フロー実行中は、まとめて実行する単位ごとに残高を再確認します。完了した回の課金額を差し引いた残高で、予約額1回分ずつ賄える件数だけを次に開始するため、残高が少ないループは同時実行数を減らして進みます。1回分の予約額も賄えなくなった時点でループは止まります。次の回はInsufficientCreditsで失敗し、残りはスキップされ、実行済みの回は結果が残り課金されます。「ステップ実行」と、サブフロー内に置いたループにはこの確認はありません。
max_steps と llm_model の価格に応じて増えるため、max_steps を大きくすると、数ステップで終わるタスクであっても実行前に必要な残高が増えます。ステップのバッジには「動的価格」と表示され、各実行に課金された額は使用量ページで確認できます(ツールの価格の決まり方)。
出力
files[]
ファイルが黙って消えることはありません。 持ち出せなかった場合は
url の代わりに error が入ります。理由は、1ファイル10MB超過・実行全体で20MB超過・21件目以降・エージェント停止時にダウンロード未完了・拡張子が対象外、のいずれかです。
対応拡張子: csv, html, json, txt, xml, yaml, yml, md, tsv, log, sql, xls, xlsx, pdf, docx, pptx, png, svg, jpg, jpeg, gif, webp
エージェントに見せずに秘匿値を入力させる
task の中に <secret>MY_SECRET</secret> と書きます。MY_SECRET はワークスペースシークレットの名前です。エージェントもLLMもプレースホルダしか見ず、実値はブラウザへ入力する直前だけ復元されます。ステップ出力には値ではなく Typed sensitive data が記録されます。
使えるのはワークスペースシークレットと組織シークレットのみです。個人(ユーザー)シークレットはこのツールからは参照できません。シークレットはエージェントに紐づき、サイトには紐づきません。browser-use はエージェントが到達したページであれば入力します。訪問先を限定したタスクを書き、影響範囲を許容できる認証情報を使ってください。