Method: projects.locations.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/*/locations/*}/suggestions:generateStatelessSummary

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

The URLs use gRPC Transcoding syntax.

Path parameters



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

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.


object (ConversationProfile)

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



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.



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:


For more information, see the Authentication Overview.