Skip Pub/Sub notifications for empty suggestions

By default, event-based suggestion features like proactive generative knowledge assist (PGKA) send a Pub/Sub notification for every suggestion attempt. This means Agent Assist sends a notification even when the feature determines there is no relevant suggestion to provide, resulting in an empty response. This can create unnecessary Pub/Sub traffic and processing overhead. You can suppress empty notifications with a single code field: skip_empty_event_based_suggestion.

Basics

The skip_empty_event_based_suggestion field is part of SuggestionConfig within HumanAgentAssistantConfig of your conversation profile. When you set its value to true, Agent Assist only sends a Pub/Sub notification when it generates a valid suggestion that isn't empty.

The skip_empty_event_based_suggestion field is designed for features that generate suggestions asynchronously with event based triggers and delivers them through Pub/Sub. Features that don't rely on Pub/Sub for suggestion delivery, or are not event based, are not affected.

The skip_empty_event_based_suggestion field has the following two possible values.

  • False: Agent Assist sends a Pub/Sub notification for every suggestion attempt. If Agent Assist doesn't find a suggestion for an event, you still receive a notification indicating an empty result.
  • True: Agent Assist sends a Pub/Sub notification only if the suggestion result is valid and not empty. If Agent Assist doesn't find a suggestion, it doesn't publish a Pub/Sub message for that event, reducing noise in your notification topic.

Configuration

To suppress empty notifications, update your conversation profile and set skip_empty_event_based_suggestion to true as follows.

{
  "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
    }
  }
}