service-omni-channel-limits-analyze

service-omni-channel-limits-analyze

サポートされている顧客組織向け API を通じて安全に取得できる、保留中のサービスルーティングの使用状況を報告します。Salesforce の 設定 → Omni-Channel → 制限 ページは読み取り専用であり、REST、Tooling、Metadata、Connect API では公開されていない内部値も表示します。このスキルでは、現在の PSR 件数を報告し、検証できない値にはすべて明示的にラベルを付けます。

入力

bash scripts/analyze.sh <org-alias> [--routing-model enhanced|legacy] [--max-psrs <integer>]

• org-alias は必須で、Salesforce CLI で認証済みである必要があります。
• --routing-model のデフォルトは enhanced です。--max-psrs が指定されていない場合に、参照用の最大値を選択します。
• --max-psrs は、管理者が指定する 1 から 1,000,000 までの最大値を受け付けます。この値には、API で検証されていないことを示すラベルが引き続き付けられます。

実行

対象の組織を指定して scripts/analyze.sh を実行し、現在の件数、ラベル付きの比較値、取得できない時間あたりの値、ブロックの詳細については、その JSON 結果を参照してください。このスクリプトは内部で sf org display と sf data query を実行します。クエリや計算のロジックをスクリプトの外で再現しないでください。

変更後に同梱スクリプトの契約を検証するには、python3 scripts/tests/test_limits_analyze_contracts.py を実行してください。テストモジュールは、ローカルの scripts/tests/_bootstrap.py フィクスチャを自動的に読み込みます。

出力契約

スクリプトは、次の JSON オブジェクトを出力します。

• skill：service-omni-channel-limits-analyze
• status：analyzed または blocked
• routing_model：enhanced または legacy
• metrics.current_pending_service_routings：現在の件数、比較用最大値、概算割合、ソースラベル
• metrics.pending_service_routing_rate_per_hour：取得できない現在の値、参照用最大値、ソースラベル
• caveats：必須の精度に関する注意事項
• blocking_issue：対処可能な失敗理由、または null

PendingServiceRouting をクエリできない場合は、status: blocked を返してください。利用できないオブジェクト、存在しない機能、権限エラーを、使用量ゼロと解釈しないでください。

制約

• Visualforce の設定ページをスクレイピング、再送、送信しないでください。そのセッション状態とコントローラーは、サポートされている顧客向け API ではありません。
• 参照用のデフォルト値を、組織に設定された最大値として説明しないでください。
• 現在の時間あたりのレートを捏造したり、その使用率を計算したりしないでください。
• ルーティング、キュー、エージェント、制限、メタデータを変更しないでください。
• PSR 件数は、作業のルーティング中に変化する可能性がある時点のスナップショットとして扱ってください。
• チャネルとルーティングの全体的なインベントリには、service-omni-channel-inventory-analyze を使用してください。
• ユーザー承認済みの Omni 設定をエンドツーエンドで行う場合は、service-omni-channel-setup-coordinate に引き継いでください。この制限分析ツールは読み取り専用です。

参考資料

レポートで設定ページのすべての値を正確に再現できない理由を説明する場合は、references/api-notes.md をお読みください。