空の候補の Pub/Sub 通知をスキップ

デフォルトでは、プロアクティブな生成ナレッジ アシスト(PGKA)などのイベントベースの候補機能は、候補を試みるたびに Pub/Sub 通知を送信します。つまり、関連する候補がないと判断された場合でも、Agent Assist は通知を送信するため、レスポンスが空になります。これにより、不要な Pub/Sub トラフィックと処理のオーバーヘッドが発生する可能性があります。空の通知は、単一のコード フィールド skip_empty_event_based_suggestion で抑制できます。

基本

skip_empty_event_based_suggestion フィールドは、会話プロファイルの HumanAgentAssistantConfig 内の SuggestionConfig に含まれています。この値を true に設定すると、Agent Assist は、空でない有効な候補が生成された場合にのみ Pub/Sub 通知を送信します。

skip_empty_event_based_suggestion フィールドは、イベントベースのトリガーで候補を非同期で生成し、Pub/Sub を介して配信する機能を対象としています。候補の配信に Pub/Sub を使用しない機能や、イベントベースではない機能は影響を受けません。

skip_empty_event_based_suggestion フィールドには、次の 2 つの値を使用できます。

  • False: Agent Assist は、候補を試みるたびに Pub/Sub 通知を送信します。Agent Assist がイベントの候補を見つけられなかった場合でも、結果が空であることを示す通知が届きます。
  • True: Agent Assist は、候補の結果が有効で空でない場合にのみ Pub/Sub 通知を送信します。Agent Assist が候補を見つけられなかった場合、そのイベントの Pub/Sub メッセージは公開されず、通知トピックのノイズが軽減されます。

構成

空の通知を抑制するには、会話プロファイルを更新し、次のように skip_empty_event_based_suggestiontrue に設定します。

{
  "name": "projects/PROJECT_ID/locations/LOCATION/conversationProfiles/PROFILE_ID",
  "human_agent_assistant_config": {
    "human_agent_suggestion_config": {
      "feature_configs": [
        {
          "suggestion_feature": {
            "type": "KNOWLEDGE_ASSIST"
          },
          "enable_event_based_suggestion": true
        },
      ],
      "skip_empty_event_based_suggestion": true
    }
  }
}