メインコンテンツへスキップ
オートメーション は、projectsレジストリ の両方で利用できます。オートメーションを作成する場所、使用できるイベント、スコープの仕組みは、それぞれ異なります。スコープごとのイベントタイプについては、Automation events and scopes を参照してください。 W&B Automations は、シンプルなパターンに従います。イベント が発生し、必要に応じて 条件 が満たされると、アクション が自動的に実行されます。たとえば次のとおりです。
  • run が失敗したとき (イベント) 、Slack チャンネルに通知します (アクション) 。
  • artifact に production alias が追加されたとき (イベント) 、webhook を呼び出して deployment をトリガーします (アクション) 。
project スコープと Registry スコープの Automations では、イベントと使用できる条件が異なります。Automation events and scopes を参照してください。 例: run が失敗した (イベント) 場合に、必要に応じて run 名フィルター (条件) を指定し、Slack 通知 (アクション) を送信します。別の例: alias production が追加された (イベント) 場合に、webhook (アクション) を実行します。

オートメーションを作成できる場所

  • project 内: project を開き、プロジェクトのサイドバーで Automations タブをクリックします。
  • Registry 内: Registry を開き、Automations タブをクリックします。

使用例

  • run の監視とアラート: run が失敗したときや、メトリクスがしきい値を超えたとき (たとえば、損失が NaN になる、または精度が低下する場合) にチームに通知します。
  • Registry CI/CD: 新しいモデル バージョンがリンクされたとき、または alias (stagingproduction など) が追加されたときに、webhook をトリガーしてテストを実行したり、デプロイしたりします。
  • project の artifact ワークフロー: 新しい artifact バージョンが作成されたとき、または project に alias が追加されたときに、後続のジョブを実行したり、Slack に投稿したりします。
イベントとスコープの詳細については、Automation events and scopes を参照してください。

オートメーションアクション

イベントによってオートメーションがトリガーされると、次のいずれかのアクションを実行できます。
  • Slack notification: トリガーされたイベントの詳細を含むメッセージを Slack チャンネルに送信します。メッセージにはイベントの概要と、W&B で詳細を表示するためのリンクが含まれます。
  • Webhook: トリガーされたイベントに関する情報を含む JSON ペイロードを使用して webhook URL を呼び出します。これにより、CI/CD パイプライン、モデルのデプロイサービス、またはカスタムワークフローなどの外部システムとインテグレーションできます。
実装の詳細については、Slack オートメーションの作成 および webhook オートメーションの作成 を参照してください。

オートメーションの動作

オートメーションを作成するには、次の手順を行います。
  1. 必要に応じて、アクセストークン、パスワード、機密性の高い設定の詳細など、オートメーションで必要になる機密文字列のためにシークレットを設定します。シークレットは Team Settings で定義します。シークレットは、主に webhook オートメーションで、認証情報やトークンを平文で公開したり webhook のペイロードにハードコードしたりすることなく、webhook の外部サービスに安全に渡すために使用されます。
  2. チームレベルの webhook または Slack インテグレーションを設定して、W&B が Slack に投稿したり、ユーザーに代わって webhook を実行したりできるようにします。1 つのオートメーションアクション (webhook または Slack 通知) を複数のオートメーションで使用できます。これらのアクションは Team Settings で定義します。
  3. project または レジストリ で、オートメーションを作成します。
    1. 監視するイベントを定義します。たとえば、新しい artifact バージョンが追加されたときです。
    2. イベント発生時に実行するアクション (Slack チャンネルへの投稿や webhook の実行) を定義します。webhook の場合は、必要に応じて、アクセストークンに使用するシークレットや、ペイロードとともに送信するシークレットを指定します。

推奨事項

  • 小さく始める: 価値の高いイベント (たとえば、run の失敗や本番 alias の変更) に対して、まずは 1 ~ 2 個のオートメーションから始めます。追加する前に、期待どおりに動作することを確認してください。
  • 本番前にテストする: まず、テスト用の project や webhook、または Slack チャンネルでオートメーションを作成します。イベントを手動でトリガーし、action が実行され、ペイロードまたはメッセージが正しいことを確認してください。
  • アラート疲れを避ける: run フィルター、メトリクスのしきい値、または alias パターンを使用して、オートメーションの発火頻度を抑えます。必要に応じて、重大度ごとに送信先チャネルを分けてください。

制限事項

run メトリクス Automationsrun メトリクスの z-score 変化 Automations は、現在 W&B Multi-tenant Cloud でのみサポートされています。

次のステップ