Method: projects.suggestions.generateStatelessSummary

Generates and returns a summary for a conversation that does not have a resource created for it.

HTTP request

POST https://{endpoint}/v2/{statelessConversation.parent=projects/*}/suggestions:generateStatelessSummary

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

The URLs use gRPC Transcoding syntax.

Path parameters

Parameters
statelessConversation.parent

string

Required. The parent resource to charge for the Summary's generation. Format: projects/<Project ID>/locations/<Location ID>.

Request body

The request body contains data with the following structure:

JSON representation
{
  "statelessConversation": {
    "messages": [
      {
        "name": string,
        "content": string,
        "languageCode": string,
        "participant": string,
        "participantRole": enum (Role),
        "createTime": string,
        "sendTime": string,
        "messageAnnotation": {
          object (MessageAnnotation)
        },
        "sentimentAnalysis": {
          object (SentimentAnalysisResult)
        }
      }
    ],
    "parent": string
  },
  "conversationProfile": {
    object (ConversationProfile)
  },
  "latestMessage": string,
  "maxContextSize": integer
}
Fields
statelessConversation.messages[]

object (Message)

Required. The messages that the Summary will be generated from. It is expected that this message content is already redacted and does not contain any PII. Required fields: {content, languageCode, participant, participantRole} Optional fields: {sendTime} If sendTime is not provided, then the messages must be provided in chronological order.

conversationProfile

object (ConversationProfile)

Required. A ConversationProfile containing information required for Summary generation. Required fields: {languageCode, securitySettings} Optional fields: {agent_assistant_config}

latestMessage

string

Optional. The name of the latest conversation message used as context for generating a Summary. If empty, the latest message of the conversation will be used. The format is specific to the user and the names of the messages provided.

maxContextSize

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.

Response body

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

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.