Method: projects.locations.conversations.suggestions.suggestConversationSummary

Suggest summary for a conversation based on specific historical messages. The range of the messages to be used for summary can be specified in the request.

HTTP request

POST https://{endpoint}/v2beta1/{conversation=projects/*/locations/*/conversations/*}/suggestions:suggestConversationSummary

Where {endpoint} is one of the supported service endpoints.

The URLs use gRPC Transcoding syntax.

Path parameters

Parameters
conversation

string

Required. The conversation to fetch suggestion for. Format: projects/<Project ID>/locations/<Location ID>/conversations/<Conversation ID>.

Request body

The request body contains data with the following structure:

JSON representation 
{
  "latestMessage": string,
  "contextSize": integer,
  "assistQueryParams": {
    object (AssistQueryParameters)
  }
}
Fields
latestMessage

string

Optional. The name of the latest conversation message used as context for compiling suggestion. If empty, the latest message of the conversation will be used.

Format: projects/<Project ID>/locations/<Location ID>/conversations/<Conversation ID>/messages/<Message ID>.
contextSize

integer

Optional. Max number of messages prior to and including [latestMessage] to use as context when compiling the suggestion. By default 500 and at most 1000.
assistQueryParams

object (AssistQueryParameters)

Optional. Parameters for a human assist query. Only used for POC/demo purpose.

Response body

If successful, the response body contains an instance of SuggestConversationSummaryResponse.

Authorization scopes

Requires one of the following OAuth scopes:

  • https://www.googleapis.com/auth/cloud-platform
  • https://www.googleapis.com/auth/dialogflow

For more information, see the Authentication Overview.