人間レビューと承認

概要

すべての作業が完全自律であるべきではありません。

Supervity は Human-in-Command モデルに従い、オペレーターは 人間の判断、承認、入力が必要になるまで 自律的に動作します。

人間レビューは例外や回避策ではなく、実運用のエンタープライズグレードオペレーション向けに設計された 第一級のガバナンス機構 です。

人間レビューが存在する理由

人間レビューは、説明責任を維持しながらオペレーターへの作業委任を安全にします。

コンプライアンスとガバナンス

• 財務承認
• 法務・契約レビュー
• ポリシー適用
• 監査・規制要件

品質管理

• コンテンツモデレーション
• 出力検証
• データ精度チェック

重要な意思決定

• 外部顧客へのコミュニケーション
• インフラまたはシステム変更
• アクセスと権限の変更

例外処理

• 高額取引
• 異常なパターン
• エッジケースと異常値

人間レビューの仕組み

実行の一時停止と再開

オペレーターがレビューステップに到達すると：

1. 実行が 自動的に一時停止 します
2. レビュアーに通知されます
3. 完全な実行コンテキスト付きのレビューフォームが生成されます
4. 人間が決定を送信します
5. その決定に基づきオペレーターが 実行を再開 します

明示的に設定しない限り、オペレーターはレビューステップをバイパスしません。

レビューフォーム

レビューフォームは動的に生成され、以下を含められます。

• 承認 / 却下アクション
• コメントまたは理由フィールド
• ファイルアップロードと添付
• 複数選択の決定
• 回答に基づく条件ロジック

フォームは Supervity 内でアクセスするか、外部に埋め込めます。

人間レビューステップの作成

オペレーターを使用（推奨）

自然言語で人間の監督をリクエストできます。

「送信前に下書きメールをマネージャーの承認に回してください。」

オペレーターは以下を行います。

• レビューステップを挿入する
• 承認フォームを設計する
• 通知を設定する
• 再開動作を定義する

人間レビューを追加する最も速く安全な方法です。

手動設定

レビューステップを明示的に追加することもできます。

1. Human Review ステップを追加する
2. フォームを設定する：
   • フィールド（テキスト、選択、ファイルなど）
   • 必須入力
   • レビュアー向け指示
3. レビュアーを割り当てる：
   • 特定ユーザー
   • ロール
   • 外部メールアドレス
4. タイムアウトとエスカレーションルールを定義する

レビュー体験

レビュアー向け

レビューへのアクセス

レビュアーは以下の経路でレビューリクエストを受け取ります。

• メール通知
• アプリ内レビューダッシュボード
• 埋め込み外部システム（エンタープライズ）

各レビューには以下が含まれます。

• 先行ステップからのコンテキスト
• 関連データと添付
• 必要事項に関する明確な指示

レビュアーのアクション

レビュアーは以下が可能です。

• 承認または却下
• コメントの追加
• 補足ファイルのアップロード
• 入力の修正（許可されている場合）
• エスカレーションまたは委任（有効な場合）

すべてのアクションはログに記録され、監査可能です。

ワークフロー所有者向け

レビューステータスのモニタリング

各レビューは明確な状態を遷移します。

• Pending
• Approved
• Rejected
• Expired

ステータスはリアルタイムで可視化されます。

監査証跡と履歴

Supervity は以下を記録します。

• 誰がレビューしたか
• いつ決定したか
• 決定結果
• コメントと添付
• 下流実行への影響

監査、コンプライアンス、振り返りを支援します。

設定オプション

レビュアーの割り当て

レビュアーは以下の形式で割り当てられます。

• 単一レビュアー
• 複数レビュアー：
  • いずれか 1 名
  • 全員必須
  • 過半数
• ロールベース（例：Manager、Admin）
• ワークフローデータに基づく動的割り当て

通知とエスカレーション

レビュアーへの通知方法：

• メール
• Slack / Microsoft Teams
• アプリ内通知

エスカレーションオプション：

• X 時間後のリマインダー
• バックアップレビュアー
• 階層的エスカレーション

タイムアウトとフォールバック

アクションが取られない場合の動作を定義します。

• 自動承認
• 自動却下
• エスカレーション
• 無期限一時停止

例：

「24 時間以内にレビューされない場合、シニアマネージャーにエスカレーションする。」

一般的な Human-in-Command パターン

承認ゲート

条件付きレビュー

多段階レビュー

ベストプラクティス

設計原則

• 判断が必要な箇所でのみレビューを使用する
• レビュアーに完全なコンテキストを提供する
• フォームは簡潔に保つ
• 不要な承認レイヤーを避ける

パフォーマンスの考慮

• 妥当なタイムアウトを設定する
• エスカレーションパスを使用する
• レビューのボトルネックを監視する

セキュリティ

• レビュアーアクセスを制限する
• 機微データを保護する
• 監査ログを有効にする

外部および API 駆動レビュー（エンタープライズ）

人間レビューは以下に埋め込めます。

• 外部ダッシュボード
• コマンドセンター
• 社内ツール

API を使用すると、外部システムは以下が可能です。

• 保留中のレビューを取得する
• レビューフォームを描画する
• 承認または却下アクションを送信する
• プログラムでオペレーター実行を再開する

API リファレンス を参照してください。

モニタリングと分析

以下を用いてレビューパフォーマンスを追跡します。

• 平均レビュー時間
• 承認率と却下率
• ボトルネック
• SLA コンプライアンス

これらのインサイトは運用効率の改善に役立ちます。

トラブルシューティング

レビューが届かない

• 通知設定を確認する
• レビュアー権限を確認する
• レビューリクエストを再送する

ワークフローが待機状態のまま

• タイムアウト設定を確認する
• 手動でエスカレーションする（Admin）
• 実行をキャンセルまたは再起動する

はじめに

• チュートリアル：承認ワークフロー
  /u/alpha/tutorials/library/advanced/human-approval-workflows

• 例：経費承認
  /u/alpha/tutorials/examples/content-approval-process

• 保留中のレビューを表示
  Human Review ダッシュボードから利用可能

Human Review により、オペレーターは 自律的に動作しつつ、説明責任なしには行動しません。