Slack連携#
SlackをUltralytics Platformに接続すると、Platformを開いたままにしなくても、時間のかかる処理が完了したことを確認できます。ワークスペースで使用するSlackチャンネルを1つ選択し、必要な結果を指定します。
Slack APIキー、Webhook、技術的な設定は必要ありません。開始する前にSlackにサインインし、Platformのアラートを受け取るチャンネルを決めてください。Platformでチームのワークスペースを使用する場合は、ワークスペースの管理者またはオーナーである必要があります。
Slackを接続する#
- Settings > Integrationsを開き、連携の一覧からSlackを選択します。
- 設定の概要を確認し、Continue to Slackをクリックします。
- チャンネルを選択し、Allowをクリックします。Platformは、そのチャンネルのみに投稿する権限を要求します。SlackにRequest approvalと表示された場合は、リクエストを送信し、Slackワークスペースの管理者にアプリの承認を依頼してください。
- Platformに戻ったら、受け取りたいアラートを選択し、Save alertsをクリックします。初期状態では、Training completeとTraining failedが選択されています。
接続に成功すると、Platformは選択したチャンネルに確認メッセージを直ちに投稿します。その後、連携画面に接続先のSlackワークスペースとチャンネルが表示されます。ワークスペースの管理者は、Integrationsタブから、ワークスペース全体の接続とアラートの選択を管理できます。
Slackにより、Platformは選択したチャンネルにメッセージを投稿できます。この接続を通じて、PlatformがSlackのメッセージを読み取ったり、他のチャンネルに投稿したりすることはできません。
利用可能なアラート#
| アラート | 送信されるタイミング |
|---|---|
| Training complete | モデルのトレーニングが完了したとき |
| Training failed | トレーニングの実行がエラーで停止したとき |
| Export complete | モデルのエクスポートの準備が完了したとき |
| Export failed | モデルのエクスポートがエラーで停止したとき |
| Deployment ready | デプロイメントの準備が完了したとき |
| Deployment failed | デプロイメントの開始に失敗したとき |
各メッセージには、完了した処理の内容と、Platform内の関連するモデルまたはデプロイメントへの直接リンクが記載されます。トレーニングのアラートには、データセット名、モデルの主要メトリック、実行時間、費用が追加されます。エクスポートのアラートには、形式とファイルサイズが追加されます。ジョブ失敗のアラートには、利用可能な場合、短いエラー概要がインラインノートとして、または長いメッセージの場合はコードブロックとして含まれます。Slackへの配信によって、トレーニング、エクスポート、デプロイメントの結果が変わることはありません。モデルのトレーニングページまたはエクスポートページ、あるいはDeploymentsページで現在の結果を確認してください。
エージェントワークフローメッセージ#
Agents内のSlackブロックを使用して、ワークフローの条件が一致したときにメッセージを送信します。接続されている同じチャンネルを使用します。ブロック内でメッセージを構成し、上流の結果に対して{output}を含めます。これらのメッセージは、上記のジョブ通知の選択肢とは別個のものです。
Slackの変更または接続解除#
投稿する結果を変更するには、アラートを選択または選択解除して、Save alertsをクリックします。少なくとも1つのアラートを選択したままにする必要があります。
別のチャンネルを使用するには、Disconnectをクリックしてから、Slackを再度接続し、新しいチャンネルを選択します。接続を解除すると、すべてのSlackアラートが直ちに停止しますが、Platformのジョブやリソースには影響しません。
トラブルシューティング#
- Slack連携で管理者による接続が必要と表示される場合: Platformのワークスペース管理者またはオーナーに接続を完了してもらってください。
- SlackにAllowではなくRequest approvalと表示される場合: リクエストを送信し、Slackワークスペースの管理者にアプリの承認を依頼してください。APIキーやWebhookを作成する必要はありません。
- Slackワークスペースまたはチャンネルが見つからない場合: 正しいSlackワークスペースにサインインしていること、またチャンネルにアプリを追加できることを確認してください。
- 接続は成功したが、アラートが停止した場合: Slackを再接続してチャンネルの権限を更新してください。通常、アプリの権限が取り消された場合や、チャンネルが削除された場合に必要となります。
- ジョブが完了したのにSlackメッセージが届かない場合: Settings > Integrationsで選択したアラートを確認し、Platformで関連するモデルまたはデプロイメントを開いてください。Slackアラートは情報提供のみを目的としており、ジョブ処理を制御することはありません。
Platform連携の概要に戻ると、データ、ストレージ、またはOn Premiseサービスを接続できます。
FAQ#
いいえ。Slackの接続はOAuthフローです。Continue to Slackをクリックし、チャンネルを選択してAllowをクリックします。Platformがアクセス権を受け取るのは、その1つのチャンネルへの投稿のみです。
各ワークスペースは1つのチャンネルに接続します。チャンネルを切り替えるには、Slackの接続を解除し、新しいチャンネルを選択して再度接続します。
チームワークスペースでは、管理者またはオーナーのroleが全員分の接続とアラートの選択を管理します。アラートはすべてのプランで利用できます。
Settings > Integrationsで該当するアラートが選択されていることを確認し、アプリの権限が取り消されていたりチャンネルが削除されていたりする場合はSlackを再接続してください。アラートは情報提供のみを目的としており、トレーニング、エクスポート、デプロイ自体に影響を与えることはありません。