Merge pull request #432 from thoughtspot/main

main release sync

Author: ShashiSubramanya

modules/ROOT/pages/ai-integration-options.adoc

@@ -0,0 +1,61 @@
+= ThoughtSpot AI analytics integration
+:toc: true
+:toclevels: 3
+
+:page-title: AI integration options
+:page-pageid: ai-analytics-integration
+:page-description: Learn the different ways to integrate ThoughtSpot analytics and AI experiences into your applications and AI agents, including MCP Server, Spotter Embed, and Spotter APIs.
+
+ThoughtSpot provides several options to bring governed analytics and AI-powered experiences into your applications, AI agents, and workflows.
+
+== AI integration options
+
+The primary ways to integrate ThoughtSpot analytics and AI into your environment are:
+
+* xref:ai-integration-options.adoc#_thoughtspot_mcp_server[ThoughtSpot Model Context Protocol (MCP) Server]
+* xref:ai-integration-options.adoc#_embedding_spotter_in_your_app[Embedding Spotter in your app]
+* xref:ai-integration-options.adoc#_spotter_rest_apis[Spotter REST APIs]
+
+[NOTE]
+====
+All options allow using your existing ThoughtSpot data models, Liveboards, Answers, row-level and column-level security, and governance. The main differences are where the UI or conversation layer exists and who orchestrates the analytics workflow.
+====
+
+=== ThoughtSpot MCP Server
+
+ThoughtSpot xref:mcp-integration.adoc[MCP Server] exposes governed analytics as MCP tools and resources to AI agents and clients. The MCP Server can be integrated with your MCP client, agent, LLM, or application UI, allowing your users to explore ThoughtSpot's agentic capabilities within the context of your application.
+
+ThoughtSpot recommends using the MCP Server in these scenarios:
+
+* When you want to plug ThoughtSpot into AI agents and clients that already support MCP, such as Claude, ChatGPT, Gemini, IDEs, and custom MCP clients.
+* If you are building your own MCP-based chatbot or application, and want to call ThoughtSpot MCP tools behind a custom web experience.
+
+For more information, see the xref:mcp-integration.adoc[MCP Server] documentation.
+
+=== Embedding Spotter in your app
+
+Developers can embed ThoughtSpot's xref:embed-spotter.adoc[conversational UI experience and its agentic capabilities] directly into their applications using the Visual Embed SDK.
+
+If your business requires you to quickly integrate the Spotter experience into your applications and workflows, and provide a native AI search and analysis experience within your app, use this option.
+
+For more information, see the xref:embed-ai-analytics.adoc[Embed AI Search and Analytics] and xref:embed-spotter.adoc[Spotter embed] documentation.
+
+=== Spotter REST APIs
+
+Spotter REST APIs provide programmatic access to Spotter conversation sessions, analytics, and agentic workflows. REST API clients use these APIs to send questions and receive structured answers, charts, or get relevant questions for a specific data model.
+
+ThoughtSpot recommends using Spotter REST APIs in the following scenarios:
+
+* When you want your application, agent, or orchestration logic to interact with ThoughtSpot programmatically, without requiring MCP.
+* If you need to integrate ThoughtSpot responses and workflows with other systems.
+* For fine-grained control over the user experience.
+
+//* For fine-grained control over data context, query options, and prompt structure, and .
+
+For more information, see the xref:spotter-apis.adoc[Spotter AI API] documentation.
+
+== Additional resources
+
+* For information about MCP, see the link:https://modelcontextprotocol.io[Model Context Protocol specification, window=_blank].
+* For information about SDK libraries for embedding, see the link:https://github.com/thoughtspot/visual-embed-sdk[Visual Embed SDK GitHub repository, window=_blank].
+* To view Spotter APIs, visit the +++<a href="{{navprefix}}/restV2-playground?apiResourceId=http%2Fgetting-started%2Fintroduction">REST API v2.0 Playground</a>+++ and navigate to the **AI** section.

modules/ROOT/pages/api-changelog.adoc

@@ -66,9 +66,9 @@ Use this enhanced configuration to override ThoughtSpot URLs on hover or when op
 
 [width="100%" cols="1,4"]
 |====
-|[tag greenBackground]#NEW FEATURE# a|**Spotter enhancements **
+|[tag greenBackground]#NEW FEATURE# a| **Spotter enhancements**
 
-You can now embed the Spotter 3 experience in your application and use features such as  Auto mode for automatic data model selection, Chat history, and a new chat prompt interface.
+You can now embed the Spotter 3 experience in your application and use features such as Auto mode for automatic data model selection, chat history, and a new chat prompt interface.
 
 * To enable the new chat prompt interface, set `updatedSpotterChatPrompt` to `true`.
 * To use Auto mode, set the `worksheetId` to `auto_mode`.
@@ -91,7 +91,7 @@ On Spotter embed deployments running version 26.2.0.cl or later, the *Add to Coa
 
 Styling and grouping::
 
-* The `isLiveboardStylingAndGrouping` attribute, used for enabling the Liveboard styling and grouping feature, is now replaced with `isLiveboardMasterpiecesEnabled`. While your existing configuration with the deprecated attribute, `isLiveboardStylingAndGrouping` continues to work, we recommend switching to the new configuration setting.
+* The `isLiveboardStylingAndGrouping` attribute, used to enable the Liveboard styling and grouping feature, is now replaced with `isLiveboardMasterpiecesEnabled`. While your existing configuration with the deprecated `isLiveboardStylingAndGrouping` attribute continues to work, we recommend switching to the new configuration setting.
 * The following action IDs are now available to show, disable, or hide the grouping menu actions on a Liveboard:
 ** `Action.MoveToGroup` for the **Move to Group** menu action.
 ** `Action.MoveOutOfGroup` for the **Move out of Group** menu action.
@@ -105,21 +105,21 @@ For more information, see link:https://docs.thoughtspot.com/cloud/latest/securit
 +
 The `showMaskedFilterChip` setting is also available in full application embedding.
 
-|[tag greenBackground]#NEW FEATURE# a|**Publishing objects**
+|[tag greenBackground]#NEW FEATURE# a| **Publishing objects**
 
 The following action IDs are available for the data publishing menu actions in the *Data workspace* page:
 
 * `Action.Publish` for *Publish*
-* `Action.ManagePublishing` for *Manange publishing*
-* `Action.Unpublish` foe *Unpublish*
+* `Action.ManagePublishing` for *Manage publishing*
+* `Action.Unpublish` for *Unpublish*
 * `Action.Parameterize` for *Parameterize*
 |[tag greenBackground]#NEW FEATURE#  a| **Error handling improvements**
 
 To handle errors in the embedding workflows, the SDK includes the following features:
 
-* `ErrorDetailsTypes` enum for categorizing error types, such as `API`, `VALIDATION_ERROR`, `NETWORK` error.
-* `EmbedErrorCodes` enum with specific error codes for programmatic error handling
-* `EmbedErrorDetailsEvent` interface for structured error event handling
+* `ErrorDetailsTypes` enum for categorizing error types, such as `API`, `VALIDATION_ERROR`, and `NETWORK`.
+* `EmbedErrorCodes` enum with specific error codes for programmatic error handling.
+* `EmbedErrorDetailsEvent` interface for structured error event handling.
 
 For more information, see link:https://developers.thoughtspot.com/docs/Enumeration_EmbedErrorCodes[EmbedErrorCodes] and link:https://developers.thoughtspot.com/docs/Enumeration_ErrorDetailsTypes[ErrorDetailsTypes].
 |====
@@ -129,7 +129,7 @@ For more information, see link:https://developers.thoughtspot.com/docs/Enumerati
 [width="100%" cols="1,4"]
 |====
 
-|[tag redBackground]#DEPRECATED# | ** Use `minimumHeight` instead of `defaultHeight` **  +
+|[tag redBackground]#DEPRECATED# | **Use `minimumHeight` instead of `defaultHeight`** +
 
 The `defaultHeight` parameter is deprecated in Visual Embed SDK v1.44.2 and later.
 To set the minimum height of the embed container for ThoughtSpot components such as a Liveboard, use the `minimumHeight` attribute instead.
@@ -144,7 +144,7 @@ Allows configuring which API calls to intercept.
 * `interceptTimeout` +
 Sets the timeout duration for handling interception.
 * `isOnBeforeGetVizDataInterceptEnabled` +
-When set to true, it enables the use of `EmbedEvent.OnBeforeGetVizDataIntercept` event to emit and intercept search execution calls initiated by the users and implement custom logic or workflow to allow or restrict search execution.
+When set to true, it enables use of `EmbedEvent.OnBeforeGetVizDataIntercept` to emit and intercept search execution calls initiated by users and implement custom logic or workflows to allow or restrict search execution.
 * `EmbedEvent.ApiIntercept` +
 Emits when an API call matching the conditions defined in `interceptUrls` is detected.
 
@@ -157,7 +157,7 @@ For more information, see xref:api-intercept.adoc[Intercept API calls and search
 |====
 |[tag greenBackground]#NEW FEATURE# a| *Code-based custom actions*
 
-The following enumerations are available for code based custom actions:
+The following enumerations are available for code-based custom actions:
 
 * `CustomActionTarget` +
 To define the target object for the custom action, such as on a Liveboard, visualization, Answer, or in Spotter.

modules/ROOT/pages/common/nav.adoc

@@ -219,7 +219,10 @@ include::generated/typedoc/CustomSideNav.adoc[]
 ** link:{{navprefix}}/SpotterCode[SpotterCode for IDEs]
 *** link:{{navprefix}}/integrate-SpotterCode[Integrating SpotterCode]
 *** link:{{navprefix}}/spottercode-prompting-guide[SpotterCode prompting guide]
-** link:{{navprefix}}/mcp-integration[ThoughtSpot MCP server]
+** link:{{navprefix}}/ai-analytics-integration[ThoughtSpot AI analytics integration]
+*** link:{{navprefix}}/mcp-integration[ThoughtSpot MCP server]
+*** link:{{navprefix}}/connect-mcp-server-to-clients[Connecting MCP Server to MCP clients]
+*** link:{{navprefix}}/custom-chatbot-integration-mcp[Integrating MCP Server in a custom application or chatbot]
 
 *  link:{{navprefix}}/development-and-deployment[Deployment and integration]
 ** link:{{navprefix}}/development-and-deployment[Development and deployment]