すべてのオートメーションには2つのタブがあります。概要は、そのオートメーションが行う1つのことを表示するライブダッシュボードです。設定では、記録済みの手順ではないすべて、つまりMCP公開、型付きパラメータ、cronスケジュール、再記録を管理します。

​
概要

​
エンドポイントが主役

ページ上部には、呼び出し可能なエンドポイント自体のカードが表示されます。
  • メソッド + パス — POST /v1/run/:flow。:flow はオートメーション名です。
  • ダイジェスト — 公開後、カードにはエンドポイントの背後で現在ライブになっている content-addressed な flow_digest が表示されます（ダイジェスト）。
  • コピーしやすい curl コマンド。オートメーションで宣言された入力があらかじめ入っており、返されるJSONレスポンスの形も表示されます。
curl -X POST https://<host>/v1/run/get-order-status \
  -H "Authorization: Bearer jbt_live_…" \
  -H "Content-Type: application/json" \
  -d '{"orderId":"<string>"}'

{
  "run_id": "run_…",
  "status": "succeeded",
  "flow_digest": "sha256:…",
  "output": { "status": "Delivered", "eta": "2026-07-02" }
}
curlの Authorization ヘッダーには、実際のキーではなくマスクされた jbt_live_… プレースホルダーが入ります。スニペット下の注記は、キーを発行するためのPlaygroundとAPIキーを示します。レスポンスの形は、そのオートメーション自身の自動生成されたDocsページと対応しています。
エンドポイントカードは、オートメーションに公開済みの digest がある場合にだけ表示されます。下書きのオートメーションでは、代わりに Build で手順を記録するよう促す短い案内が表示されます。まだ呼び出せるものはありません。

​
手順（読み取り専用）

エンドポイントの下には、オートメーションの記録済み手順リストが表示されます。これは Build Studio のキャンバスに表示されるものと同じ手順ですが、ここでは 読み取り専用 として表示されるため、「このオートメーションは実際に何をするのか？」をエディターを開かずに確認できます。オーナーには Build へ直接移動する ステップを編集 ボタンが表示されます。編集はサーバー側でオーナー限定のため、非オーナーにはリストだけが表示されます。

​
実行履歴テーブル

手順の下には 実行履歴 が表示されます。このオートメーションの記録された実行が新しい順に並び、ライブでポーリングされます。各行には次が表示されます。
列意味
状態成功、失敗、実行中、または待機中
呼び出し元呼び出しを行ったAPIキーまたはトリガー
所要時間Run にかかった実時間
開始相対的な「…前」形式のタイムスタンプ
行（またはその 詳細 リンク）をクリックすると、その Run の完全なインスペクタービューが開きます。まだ呼び出しがないオートメーションでは、テーブルの代わりに空状態のヒントが表示されます。「実行履歴は空です。エンドポイントが呼び出されるとここに表示されます。」

​
再記録バナー

オートメーションの直近の呼び出しで locator-mismatch エラーが発生した場合、つまり記録済み手順の対象サイトのマークアップが変わった場合、状態は 公開済み から 失敗中 に変わり、概要の上部に 「サイトが変更された可能性があります。再記録してください。」 というバナーと、Build へ直接移動する 再記録 ボタンが表示されます。このバナーは、オートメーションが failing 状態の間だけ表示されます。正常なオートメーションや、まだ下書きのオートメーションでは何も表示されません。
これは要約にすぎません。ドリフト検出の詳しい仕組み、locator-mismatch エラーの見え方、復旧ループについては、トラブルシューティング: 「サイト変更 - 再記録」 を参照してください。

​
設定

設定では、オートメーションのうち記録済み手順ではないすべて、つまりMCP公開、型付きパラメータ、スケジュール、レート制限、危険ゾーンを管理します。
MCP公開とREST公開は、独立した2つのゲートです。 「MCP経由で公開」トグルが制御するのは、このオートメーションがMCP接続エージェント向けに、ホスト型MCPエンドポイント（POST /mcp）の tools/list でMCPツールとして表示されるかどうかだけです。これは POST /v1/run/:flow には影響しません。有効なAPIキーを持つREST呼び出し元は、このトグルがオンでもオフでも、公開済みのオートメーションを呼び出せます。MCP公開をオフにすると、オートメーションがMCPツール検出から削除されるだけです。オンにしても、RESTに対してまだ公開されていなかったものが公開されるわけではありません。2つの公開状態は独立して設定され、読み取られます。

​
MCP経由で公開

このチェックボックスは、設定ヘッダー内でオートメーションの状態バッジの隣にあります。これは オーナー限定 です。非オーナーには、制限を説明するツールチップ付きで無効化された状態で表示されます。新しいオートメーションではデフォルトで オン です（値が記録されていないレガシーオートメーションも、後方互換性のため公開対象になります）。
  • オン（デフォルト）: 公開済みで下書きではないオートメーションは、オートメーションごとに1つのMCPツールとして登録され、組織のBearerキーで認証された任意のMCPクライアントから検出および呼び出しができます。
  • オフ: ホスト型MCPエンドポイントがツールリストを構築するときに、このオートメーションはスキップされます。MCPクライアントは検出も呼び出しもできなくなります。一方で、まったく同じオートメーションの /v1/run/:flow は、REST呼び出し元に対して変更なく動作し続けます。
UI上のトグルは楽観的に動作します（すぐに切り替わり、サーバーが変更を拒否した場合は元に戻ります）。ただし、その背後の書き込みは通常のオーナー制限付き PATCH であり、MCPトランスポート固有の処理はありません。

​
パラメータ

パラメータ セクションには、オートメーションの名前付き・型付き入力が表示されます。これは、記録エージェントが取得した同じ {{slot}} 名に、宣言された型と必須/任意の情報が付いたものです。各パラメータには次が表示されます。
  • name（等幅表示、記録済みの fill 手順で使われるスロットと一致）
  • type — string、number、または boolean
  • 必須 / 任意
  • 任意の sample 値。次回の記録時に対応するフィールドへ入力され、実データで Flow が実行されるようにします。
  • 手順で使用中。記録済みの fill 手順が、リテラル値ではなくこのパラメータをまだ参照している場合に表示されます。
オーナーは、リスト下のフォームから新しいパラメータ（名前、型、任意のサンプル、必須チェックボックス）を追加できます。記録済み手順からまだ参照されているパラメータは削除できません。その 削除 ボタンは、理由を説明するツールチップ付きで無効化されます。そのため、削除によって、パラメータを期待する手順が静かに孤立することはありません。先に参照している手順を削除する（または別のパラメータを参照するように変更する）と、そのパラメータ自体を削除できるようになります。
型付きパラメータが存在する前に作成されたレガシーオートメーションは、素の input_slots リストにフォールバックし、すべてのスロットが { type: "string", required: true } として読み取られます。これは、エンドポイントの入力検証で使われる後方互換性ルールと同じです。

​
スケジュール

スケジュールは、呼び出し元なしでこのオートメーションを cron の周期で起動します。ワーカーが直接実行します。
1

先に公開する

スケジュールは公開済みのオートメーションに対してだけ存在します。スケジュールを作成すると、作成時点でオートメーションの 現在ライブな digest に固定されます。下書きには固定対象がないため、作成フォームの代わりに、先に公開するよう促す案内が表示されます。
2

cron式と任意の入力を設定する

標準の5フィールドcron文字列（例: 0 9 * * *）に加えて、そのスケジュール呼び出し用の任意のJSON入力オブジェクトを指定します。サービスはどちらもサーバー側で検証します。範囲外のcronフィールド（またはプラットフォームが許可するより短い間隔）は bad_request で拒否されます。固定された digest の公開済みスキーマに一致しない入力は、/v1/run/:flow が強制するものと同じ入力契約により invalid_inputs で拒否されます。シークレットスロット値をスケジュール入力から渡すことはできません。
3

作成と削除はオーナー限定

スケジュールの作成と削除はいずれもオーナー制限付きです。非オーナーには、他の場所と同じ「操作はオーナーに制限されています」というヒント付きでコントロールが無効化されて表示されます。
リスト内の各スケジュールには、cron式、固定された digest（短縮表示）、作成日時が表示されます。また、有効 のチェックを外して作成された場合は、一時停止中 バッジも表示されます。
有効チェックボックスが表示されるのは 作成 時だけです。現在の実装では、作成済みスケジュールに対する個別の一時停止/再開操作はありません。あとから利用できる変更操作は 削除 だけです。既存のスケジュールを「一時停止」するには、現時点では削除し、準備ができたら新しく作成する必要があります（その新しいスケジュールは、その後の時点 でライブになっている digest に再固定されます。元の digest とは限りません）。インプレースの有効/無効トグルが予定されているかどうかはオーナーに確認してください。このページでは、現在存在するAPIを説明しています。
スケジュールは作成時に digest に固定されるため、オートメーションを再記録して再公開しても（下の危険ゾーンを参照）、既存のスケジュールが新しい digest へ遡及的に移動することはありません。削除して再作成するまでは、作成時に固定された正確な Recording を実行し続けます。

​
レート制限

このセクションは情報提供用です。制限はここで設定するのではなく、Run ゲートウェイ自体で強制されます。/v1/run/:flow へのすべての呼び出しは、固定ウィンドウで組織ごとにレート制限されます。各レスポンスには次が含まれます。
Header意味
X-RateLimit-Limitウィンドウごとに許可される呼び出し数
X-RateLimit-Remaining現在のウィンドウ内で残っている呼び出し数
X-RateLimit-Resetウィンドウがリセットされる時刻（unixミリ秒）
制限を超えると、Retry-After ヘッダー（秒）付きで 429 と { "error": "rate_limited" } が返されます。制限はオートメーション単位ではなく組織全体です。/v1/run/* 経由で組織が呼び出すすべてのオートメーションに適用され、1つの予算を共有します。

​
危険ゾーン

ここには破壊的な操作が1つだけあります。再記録 です。これは Build Studio へ直接移動します。Build Studio で新しい手順を生成すると、現在の Recording が置き換えられ、公開時に新しい content-addressed な digest が生成されます。既存のスケジュールは、再作成するまで影響を受けません（上記参照）。固定された digest に対して実行され続けます。ドリフトエラーによって再記録が自動的に促されるケースを含む、再記録の完全な手順については、トラブルシューティング: 「サイト変更 - 再記録」 を参照してください。

​
次のステップ

Build Studio

手順の記録、編集、公開を実際に行う場所です。

PlaygroundとAPIキー

エンドポイントをライブで試し、curlスニペットに必要なBearerキーを発行します。

Docsページを読む

このオートメーションについて自動生成される、完全なリクエスト/レスポンスリファレンスです。

サイト変更 - 再記録

ドリフト検出器、失敗中バナー、復旧ループの全体です。