スコアラーとカスタムスコアラー (ベータ)
スコアラー (ベータ) は、エージェントセッションを分析し、Agentforce Optimization および Analytics のスコア、ディメンション、基準を生成する Agentforce Studio の評価コンポーネントです。Salesforce 標準スコアを KPI のカスタム評価と組み合わせ、次世代テストを使用してカスタムスコアラーを作成し、セッションに適用して、最適化と Analytics の出力を使用してエージェントの改善に優先順位を付けます。
必要なエディション
| 使用可能なエディション: Einstein for Sales、Einstein for Platform、Einstein for Service、Einstein 1 Service、または Einstein GPT Service アドオンが付属する Enterprise Edition、Performance Edition、および Unlimited Edition。アドオンを購入するには、Salesforce アカウントエグゼクティブにお問い合わせください。 |
スコアラーはベータサービスであり、Agreements - Salesforce.com のベータサービス条件、またはお客様が実行した場合は書面による統合パイロット契約、および製品条件ディレクトリの適用条件が適用されます。このベータサービスは、お客様独自の裁量で使用するものとします。
最適化と分析でのスコアラーの表示場所
- 次世代テスト — 新規または既存のテストスイートの一部としてカスタムスコアラーを作成し、調整して公開します。
- スコアラー ハブ(Agentforce Studio) — スコアラーの表示、有効化、および管理を一元的に行います。
- Sessions and Intents テーブル — セッションにはスコアラーの結果が表示されます。カスタムスコアラーディメンションで絞り込んで分析します。
- セッションページ — セッションには、関連付けられたスコアラーの表示ラベルとスコアが表示されます。
- Analytics ダッシュボード: カスタムスコアラー基準がレポートの総計値として表示されます。
考慮事項と制限
- エージェント最適化および分析が有効になっている Salesforce Foundations Edition または Agentforce 1 Edition が付属する Enterprise Edition、Performance Edition、および Unlimited Edition の Lightning Experience で使用できます。
- カスタム スコアラーはベータであり、Agentforce以外の追加ライセンスは必要ありません。
- ベータ期間中は、セッションレベルのスコアラーのみがサポートされます。
- カスタム スコアラーは、Agentforce Employee Agent(AEA)エージェント タイプではサポートされません。
- SDR エージェント種別はスコアラーハブに表示されますが、最適化 UI エージェントドロップダウンには表示されません。
- 標準スコアラー (A&D、品質スコア) は、STDM がプロビジョニングされたときに作成されます。欠落している場合は、プロビジョニングの問題を確認してください。
- 標準スコアラーを編集する前にコピーする必要があります。ベータ期間中は直接編集はサポートされません。
- 式ベースのスコアラーには Boolean 出力種別が必要です。
- LLM は非常に狭い数値範囲ではパフォーマンスが低いため、0 ~ 1 スケールの数値スコアラーはお勧めしません。
- テストセンターセッションはカスタムスコアラーでスコアリングされません。テストセンターセッションには終了タイムスタンプが付与されないため、カスタムスコアラー評価をトリガーするデータアクションが起動されることはありません。
概要
スコアラーはエージェントセッションを評価し、スコア、ディメンション (テキスト値)、基準 (数値) を生成します。これらは、Agentforce Optimization and Observabilityの一部です。これらは設定可能なセッションの割合に対して自動的に実行され、最適化と Analytics で結果が表示されるため、システム管理者と開発者はエージェントのパフォーマンスを継続的に改善できます。
スコアラーには次の 2 種類があります。
- 標準スコアラーは Salesforce によって標準で提供されます。
- カスタムスコアラーは、ビジネス固有の条件を評価するために組織で定義されます。
標準スコアラー
標準スコアラーは、STDM プロビジョニングで自動的に作成される事前作成済みの評価です。エージェントセッションで実行され、追加の顧客設定は必要ありません。
現在の標準スコアラー
- Abandonment Score — エージェントが問題を解決する前に顧客がセッションを途中で終了したかどうかを示します。
- デフレクションスコア — エージェントがインタラクションを人のエスカレーションが必要ないように回避したかどうかを示します。
- 品質スコア — 定義済みのSalesforce条件に基づいてセッション全体の品質を測定します。
標準スコアラーは、ユーザーインターフェースで予約された場所を使用し、カスタムスコアラーリストとは異なります。
標準のスコアラーを直接編集することはできません。コピーして、ロジックを変更した新しいカスタムバージョンを作成します。
カスタムスコアラー
カスタムスコアラーを使用すると、評価ロジックを定義してセッションに適用できます。LLM-as-a-Judge アプローチ (プロンプトベースの評価) または式ベースのロジックを使用して、条件に対するセッションの表示ラベル付け、スコアリング、分類を行います。
カスタムスコアラーは Agentforce Studio の Next Gen Testing(NGT; 次世代テスト)で作成します。「Agentforce Studio でのテストの設定および実行 (ベータ)」を参照してください。詳細は、「Next Gen Testing on Slack」を参照してください。
カスタムスコアラーはセッションに対して実行され、Observability にカスタムスコアとディメンションが表示されます。
カスタムスコアラーのしくみ
カスタムスコアラーは、セッションの終了時に一括処理ジョブとして自動的に実行されるプロンプトテンプレートによってサポートされています。スコアラーがセッションで実行されると、セッションはそのスコアラーに関連付けられ、表示ラベルとスコアが最適化と Analytics に表示されます。
- スコアラーは、設定可能なセッションの割合 (サンプルレート) で実行されるプロンプトテンプレートです。
- スコアは、ライブ会話中ではなく、セッション終了時に適用されます。スコアリングデータアクションを起動するには、セッションで終了タイムスタンプを受信する必要があります。
- 結果は [Observability (可観測性)] にカスタム基準として表示されます。
executeAgentforceScoresJob呼び出し可能アクションを使用してスコアラーを手動でトリガーすることもできます。- スコアリングはセッションの終了後に実行されるため、ライブ会話中のエージェントの遅延やパフォーマンスにスコアラーが影響することはありません。
スコアラー設定
主要なフィールド
| 項目 | 説明 |
|---|---|
scorerApiName |
スコアラーの一意の API 参照名。 |
status |
スコアラーのライフサイクル状況 (ドラフト、対応可能など)。 |
isDraft |
ブール型。このスコアラー定義がドラフトかどうかを示します。 |
versionNumber |
スコアラー定義の整数バージョン。 |
engine |
評価エンジン: LLM ベースまたは式ベース。 |
inputScope |
粒度: セッションレベル (ベータおよび正式リリースのデフォルト) またはインタラクションレベル (予定)。 |
dataType |
スコアラーの出力種別 (テキスト、数値など)。 |
scorerValues / valuesSpecification |
いずれかを指定します。スコアラーの出力表示ラベルまたは数値範囲を定義します。 |
promptTemplateRef |
LLM ベースの評価用のプロンプトテンプレートへの参照。テンプレートが有効になっている必要があります。 |
agentApiName |
省略可能。スコアラーを特定のエージェントに関連付けます。使用できるエージェント API 参照名は 1 つのみです。 |
samplingRate |
スコアラーが実行したセッションの割合。 |
入力規則
scorerApiNameがすでに存在していない。promptTemplateRefが存在し、アクティブである必要があります。- テキストデータ型の場合: スコアラー値が存在する必要があり、1 つの値にのみ
isFallback: trueが必要です。1 つの値にのみisSystemFallback: trueが必要です (isFallbackも true の場合のみ)。 - 数値データ型の場合: 代替値はありません。値は有効な double として解析する必要があります。
valuesSpecification: を使用する場合は、step0 より大きい値、minより小さい値max、省略可能ですが、thresholdと の間minである必要がありますmax。 - スコアラー値の最大数: 101。
出力タイプ
- テキスト (表示ラベル) — スコアラーは各セッションに定義済みの文字列表示ラベルのセット ([解決済み]、[中止]、[エスカレーション済み] など) のいずれかを割り当てます。カテゴリ分類に使用します。
- 数値 — スコアラーは、定義された範囲の数値を返します (例: 0 ~ 5)。品質評価と連続スコアに適しています。LLM は通常、狭い 0 ~ 1 の範囲よりも個別のスケール (0 ~ 5 など) でパフォーマンスが優れています。
- Boolean (ストレッチまたは未来) — true または false を返します。式ベースのスコアラーでサポートされます。
本番でのスコアラーの実行
[スコアラー] タブからの有効化
カスタム スコアラーを作成してテストしたら、Agentforce Optimization のスコアラー ハブから有効化します。有効化すると、スコアラーは設定されたサンプルレートでライブセッションで実行できます。
| Agentforce 最適化へのアクセスと表示 | 「Agentforce 最適化へのアクセス」および「Data Cloud ユーザー」権限セットの割り当て |
| [スコアラー] タブの使用 (ベータ) | Agentforce Scorer Beta権限セットを割り当てる(Agentforce以外の追加ライセンスは不要) |
| スコアラーの作成 | 「次世代テスト (NGT)」アクセス権限セットを割り当てる |
| スコアラーの有効化 | AgentforceScorerActivation 権限セットを割り当てます (デフォルトで管理者プロファイルに含まれます)。 |
Salesforce フローから実行
履歴セッションでカスタムスコアラーを非同期に実行する新しい呼び出し可能なアクション TriggerAgentBulkScoring が用意されています。このアクションは、複数のセッションとスコアラーを受け入れ、以下からアクセスできます。
- Salesforce フロー
- REST API
- Apex
アクション名: TriggerAgentBulkScoring
| 入力パラメーター | 種別 | 説明 |
|---|---|---|
InputIds |
List<String> | 最大 500 個の一意のセッション ID のリスト。 |
InputScope |
Enum | スコアリングの範囲: セッション、モーメント、インタラクション。 |
ScoresApiNames |
List<String> | 実行されるスコアラーの最大 10 個の開発者名。 |
重要事項
- すべてのセッション ID と
scorerApiNamesは同じエージェントに属している必要があります。 - 実行前にスコアラーバージョンが [使用可能] であることを確認します。
REST API
POST 要求を標準アクション REST エンドポイントに送信します。
/services/data/v66.0/actions/standard/triggerAgentBulkScoring
ペイロードの例:
{
"inputs": [
{
"inputIds": ["019c9442-b760-7d62-837c-8ab80ecc0fc2"],
"inputScope": "Session",
"scorerApiNames": ["language_classifier"]
}
]
}フローで executeAgentforceScoresJob 呼び出し可能アクションを使用します。このアクションは、セッション ID とスコアラーのリストを受け入れ、ジョブを評価パイプラインに送信します。一般的な用途は次のとおりです。
- 履歴セッションでのスコアラーの実行
- 一括分析とカスタムレポート
- Agentforce Grid との統合
メタデータ API
Salesforce メタデータ API を使用してカスタムスコアラーを作成および管理し、CI/CD パイプラインを含むプロコードおよび DevOps ワークフローでスコアラーをリリースできるようにします。
使用事例
| 使用事例 | ユーザー目標 | スコアラーによる支援 |
|---|---|---|
| エージェント品質の監視 | エージェントが顧客の問題をどの程度適切に解決するかを理解する | 標準スコアラー (品質スコア、A&D) が自動的に実行され、設定なしで Analytics に結果が表示される |
| ビジネス固有の結果を評価 | カスタム KPI の測定 (トピック分類やコンプライアンスなど) | カスタムスコアラーは LLM プロンプトをセッションに適用し、結果をカスタムディメンションとして公開します。 |
| エージェントの反復と改善 | 弱いセッションでパターンを見つけて、命令を絞り込む | オブザーバビリティによりセッションごとのスコアラー結果が表示されるため、フラグ付きインタラクションにドリルインできます。 |
| 本番前にスコアラーをテストする | 有効化する前に、新しいスコアラーが正常に動作することを確認する | Agentforce Studio のテストセンターでは、テストケースに対するスコアラーの作成、実行、および絞り込みがサポートされています。 |
| スコアラーを大規模に実行 | 履歴セッションの大規模なバッチを評価する | executeAgentforceScoresJobはバッチ処理とカスタムレポートをサポート |
| スコアラーをコードとして管理 | CI/CD を介したスコアラーのリリース | メタデータ API のサポートにより、プロコードの作成と管理が可能 |
| 評価条件のカスタマイズ | 標準のスコアリングを調整または拡張する | 標準スコアラーをコピーして、プロンプトロジックを変更したカスタムバージョンを作成する |

