SCAL-289687: Fix AI create agent conversation documentation

api-spec/openapiSpecv3-2_0.json

@@ -179,10 +179,10 @@
     "/api/rest/2.0/ai/agent/conversation/create": {
       "post": {
         "operationId": "createAgentConversation",
-        "description": "<span class=\"since-beta-tag\">Beta</span> <span class=\"since-beta-tag\">Version: 10.13.0.cl or later</span>",
+        "description": "<span class=\"since-beta-tag\">Beta</span> <span class=\"since-beta-tag\">Version: 26.2.0.cl or later</span>",
         "tags": [
           "AI",
-          "10.13.0.cl"
+          "26.2.0.cl"
         ],
         "requestBody": {
           "content": {
@@ -694,10 +694,10 @@
     "/api/rest/2.0/ai/agent/{conversation_identifier}/converse": {
       "post": {
         "operationId": "sendAgentMessage",
-        "description": "\n<span class=\"since-beta-tag\">Beta</span> <span class=\"since-beta-tag\">Version: 10.15.0.cl or later</span>\n\nThis API allows users to initiate or continue an agent (Spotter) conversation by submitting one or more natural language messages. \nTo use this API, the user must have access to the relevant conversational session (via conversation_identifier) and submit at least one message.\n\n\n#### Usage guidelines\n\nTo initiate or continue a conversation, the request must include:\n- `conversation_identifier`: a unique session ID for continuity and message tracking\n- `messages`: an array of one or more text messages, each with a value and type\n\nThe API returns a array of object with a type, message, and metadata.\n- `type`: Type of the message — text, answer, or error.\n- `message`: Main content of the response.\n- `metadata`: Additional info depending on the message type.\n\n> ###### Note:\n> * This endpoint is currently in Beta. Breaking changes may be introduced before the endpoint is made Generally Available.\n> * This endpoint requires Spotter - please contact ThoughtSpot support to enable Spotter on your cluster.\n\n\n\n#### Endpoint URL\n",
+        "description": "\n<span class=\"since-beta-tag\">Beta</span> <span class=\"since-beta-tag\">Version: 26.2.0.cl or later</span>\n\nThis API allows users to initiate or continue an agent (Spotter) conversation by submitting one or more natural language messages. \nTo use this API, the user must have access to the relevant conversational session (via conversation_identifier) and submit at least one message.\n\n\n#### Usage guidelines\n\nTo initiate or continue a conversation, the request must include:\n- `conversation_identifier`: a unique session ID for continuity and message tracking\n- `messages`: an array of one or more text messages, each with a value and type\n\nThe API returns a array of object with a type, message, and metadata.\n- `type`: Type of the message — text, answer, or error.\n- `message`: Main content of the response.\n- `metadata`: Additional info depending on the message type.\n\n> ###### Note:\n> * This endpoint is currently in Beta. Breaking changes may be introduced before the endpoint is made Generally Available.\n> * This endpoint requires Spotter - please contact ThoughtSpot support to enable Spotter on your cluster.\n\n\n\n#### Endpoint URL\n",
         "tags": [
           "AI",
-          "10.15.0.cl"
+          "26.2.0.cl"
         ],
         "requestBody": {
           "content": {
@@ -779,10 +779,10 @@
     "/api/rest/2.0/ai/agent/converse/sse": {
       "post": {
         "operationId": "sendAgentMessageStreaming",
-        "description": "\n<span class=\"since-beta-tag\">Beta</span> <span class=\"since-beta-tag\">Version: 10.13.0.cl or later</span>\n\nThis API allows users to initiate or continue an agent (Spotter) conversation by submitting one or more natural language messages. \nTo use this API, the user must have access to the relevant conversational session (via conversation_identifier) and submit at least one message.\n\n\n#### Usage guidelines\n\nTo initiate or continue a conversation, the request must include:\n- `conversation_identifier`: a unique session ID for continuity and message tracking\n- `messages`: an array of one or more text messages, each with a value and type\n\nAdditionally, user can specify what tool can be included `conversation_settings` parameter, which supports:\n- `enable_contextual_change_analysis` (default: false)\n- `enable_natural_language_answer_generation` (default: true)\n- `enable_reasoning` (default: false)\n\nIf the request is valid, the API returns a stream of messages in real time, including:\n- `ack`: confirms receipt of the request\n- `text / text-chunk`: content chunks, optionally formatted (e.g., markdown)\n- `answer`: the final structured response with metadata and analytics\n- `error`: if a failure occurs\n- `notification`: notification messages for operation being performed\n\n> ###### Note:\n> * This endpoint is currently in Beta. Breaking changes may be introduced before the endpoint is made Generally Available.\n> * This endpoint requires Spotter - please contact ThoughtSpot support to enable Spotter on your cluster.\n> * The streaming protocol uses Server-Sent Events (SSE)\n\n\n\n#### Endpoint URL\n",
+        "description": "\n<span class=\"since-beta-tag\">Beta</span> <span class=\"since-beta-tag\">Version: 26.2.0.cl or later</span>\n\nThis API allows users to initiate or continue an agent (Spotter) conversation by submitting one or more natural language messages. \nTo use this API, the user must have access to the relevant conversational session (via conversation_identifier) and submit at least one message.\n\n\n#### Usage guidelines\n\nTo initiate or continue a conversation, the request must include:\n- `conversation_identifier`: a unique session ID for continuity and message tracking\n- `messages`: an array of one or more text messages, each with a value and type\n\nAdditionally, user can specify what tool can be included `conversation_settings` parameter, which supports:\n- `enable_contextual_change_analysis` (default: false)\n- `enable_natural_language_answer_generation` (default: true)\n- `enable_reasoning` (default: false)\n\nIf the request is valid, the API returns a stream of messages in real time, including:\n- `ack`: confirms receipt of the request\n- `text / text-chunk`: content chunks, optionally formatted (e.g., markdown)\n- `answer`: the final structured response with metadata and analytics\n- `error`: if a failure occurs\n- `notification`: notification messages for operation being performed\n\n> ###### Note:\n> * This endpoint is currently in Beta. Breaking changes may be introduced before the endpoint is made Generally Available.\n> * This endpoint requires Spotter - please contact ThoughtSpot support to enable Spotter on your cluster.\n> * The streaming protocol uses Server-Sent Events (SSE)\n\n\n\n#### Endpoint URL\n",
         "tags": [
           "AI",
-          "10.13.0.cl"
+          "26.2.0.cl"
         ],
         "requestBody": {
           "content": {
@@ -24249,65 +24249,18 @@
           "type": {
             "type": "string",
             "enum": [
-              "answer",
-              "liveboard",
-              "data_source"
+              "DATA_SOURCE"
             ],
             "description": "Type of the context.",
             "nullable": true
           },
-          "answer_context": {
-            "$ref": "#/components/schemas/AnswerContextInput",
-            "description": "Answer context.",
-            "nullable": true
-          },
-          "liveboard_context": {
-            "$ref": "#/components/schemas/LBContextInput",
-            "description": "Liveboard context.",
-            "nullable": true
-          },
           "data_source_context": {
             "$ref": "#/components/schemas/DataSourceContextInput",
             "description": "Data source context.",
             "nullable": true
           }
         }
       },
-      "AnswerContextInput": {
-        "type": "object",
-        "required": [
-          "session_identifier",
-          "generation_number"
-        ],
-        "properties": {
-          "session_identifier": {
-            "type": "string",
-            "description": "Unique identifier of the answer session."
-          },
-          "generation_number": {
-            "type": "integer",
-            "format": "int32",
-            "description": "Generation number of the answer."
-          }
-        }
-      },
-      "LBContextInput": {
-        "type": "object",
-        "required": [
-          "liveboard_identifier",
-          "visualization_identifier"
-        ],
-        "properties": {
-          "liveboard_identifier": {
-            "type": "string",
-            "description": "Unique identifier of the liveboard."
-          },
-          "visualization_identifier": {
-            "type": "string",
-            "description": "Unique identifier of the visualization."
-          }
-        }
-      },
       "DataSourceContextInput": {
         "type": "object",
         "required": [
@@ -24919,4 +24872,4 @@
       }
     }
   ]
-}
+}

sdks/java/.openapi-generator/FILES

@@ -19,7 +19,6 @@ docs/ActivateUserRequest.md
 docs/AgentConversation.md
 docs/AiApi.md
 docs/AnswerContent.md
-docs/AnswerContextInput.md
 docs/AnswerDataResponse.md
 docs/AssignChangeAuthorRequest.md
 docs/AssignTagRequest.md
@@ -182,7 +181,6 @@ docs/JWTMetadataObject.md
 docs/JWTParameter.md
 docs/JWTUserOptions.md
 docs/JWTUserOptionsFull.md
-docs/LBContextInput.md
 docs/LiveboardContent.md
 docs/LiveboardDataResponse.md
 docs/LiveboardOptions.md
@@ -468,7 +466,6 @@ src/main/java/com/thoughtspot/client/model/ActionDetailsInputCreate.java
 src/main/java/com/thoughtspot/client/model/ActivateUserRequest.java
 src/main/java/com/thoughtspot/client/model/AgentConversation.java
 src/main/java/com/thoughtspot/client/model/AnswerContent.java
-src/main/java/com/thoughtspot/client/model/AnswerContextInput.java
 src/main/java/com/thoughtspot/client/model/AnswerDataResponse.java
 src/main/java/com/thoughtspot/client/model/AssignChangeAuthorRequest.java
 src/main/java/com/thoughtspot/client/model/AssignTagRequest.java
@@ -622,7 +619,6 @@ src/main/java/com/thoughtspot/client/model/JWTMetadataObject.java
 src/main/java/com/thoughtspot/client/model/JWTParameter.java
 src/main/java/com/thoughtspot/client/model/JWTUserOptions.java
 src/main/java/com/thoughtspot/client/model/JWTUserOptionsFull.java
-src/main/java/com/thoughtspot/client/model/LBContextInput.java
 src/main/java/com/thoughtspot/client/model/LiveboardContent.java
 src/main/java/com/thoughtspot/client/model/LiveboardDataResponse.java
 src/main/java/com/thoughtspot/client/model/LiveboardOptions.java
@@ -861,7 +857,6 @@ src/test/java/com/thoughtspot/client/model/ActionDetailsTest.java
 src/test/java/com/thoughtspot/client/model/ActivateUserRequestTest.java
 src/test/java/com/thoughtspot/client/model/AgentConversationTest.java
 src/test/java/com/thoughtspot/client/model/AnswerContentTest.java
-src/test/java/com/thoughtspot/client/model/AnswerContextInputTest.java
 src/test/java/com/thoughtspot/client/model/AnswerDataResponseTest.java
 src/test/java/com/thoughtspot/client/model/AssignChangeAuthorRequestTest.java
 src/test/java/com/thoughtspot/client/model/AssignTagRequestTest.java
@@ -1015,7 +1010,6 @@ src/test/java/com/thoughtspot/client/model/JWTMetadataObjectTest.java
 src/test/java/com/thoughtspot/client/model/JWTParameterTest.java
 src/test/java/com/thoughtspot/client/model/JWTUserOptionsFullTest.java
 src/test/java/com/thoughtspot/client/model/JWTUserOptionsTest.java
-src/test/java/com/thoughtspot/client/model/LBContextInputTest.java
 src/test/java/com/thoughtspot/client/model/LiveboardContentTest.java
 src/test/java/com/thoughtspot/client/model/LiveboardDataResponseTest.java
 src/test/java/com/thoughtspot/client/model/LiveboardOptionsInputTest.java

sdks/java/api/openapi.yaml

@@ -17603,43 +17603,12 @@ components:
         type:
           description: Type of the context.
           enum:
-          - answer
-          - liveboard
-          - data_source
+          - DATA_SOURCE
           nullable: true
           type: string
-        answer_context:
-          $ref: '#/components/schemas/AnswerContextInput'
-        liveboard_context:
-          $ref: '#/components/schemas/LBContextInput'
         data_source_context:
           $ref: '#/components/schemas/DataSourceContextInput'
       type: object
-    AnswerContextInput:
-      properties:
-        session_identifier:
-          description: Unique identifier of the answer session.
-          type: string
-        generation_number:
-          description: Generation number of the answer.
-          format: int32
-          type: integer
-      required:
-      - generation_number
-      - session_identifier
-      type: object
-    LBContextInput:
-      properties:
-        liveboard_identifier:
-          description: Unique identifier of the liveboard.
-          type: string
-        visualization_identifier:
-          description: Unique identifier of the visualization.
-          type: string
-      required:
-      - liveboard_identifier
-      - visualization_identifier
-      type: object
     DataSourceContextInput:
       properties:
         guid: