Method: projects.locations.conversations.suggestions.generate

Generates all the suggestions using generators configured in the conversation profile. A generator is used only if its trigger event is matched.

HTTP request

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

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

The URLs use gRPC Transcoding syntax.

Path parameters

Parameters
conversation

string

Required. The conversation for which the suggestions are generated. Format: projects/<Project ID>/locations/<Location ID>/conversations/<Conversation ID>.

The conversation must be created with a conversation profile which has generators configured in it to be able to get suggestions.

Request body

The request body contains data with the following structure:

JSON representation
{
  "latestMessage": string,
  "triggerEvents": [
    enum (TriggerEvent)
  ]
}
Fields
latestMessage

string

Optional. The name of the latest conversation message for which the request is triggered. Format: projects/<Project ID>/locations/<Location ID>/conversations/<Conversation ID>/messages/<Message ID>.

triggerEvents[]

enum (TriggerEvent)

Optional. A list of trigger events. Only generators configured in the conversationProfile whose triggerEvent is listed here will be triggered.

Response body

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

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.