diff --git a/modules/ROOT/pages/api-changelog.adoc b/modules/ROOT/pages/api-changelog.adoc index d01dc1e0f..9888aaeac 100644 --- a/modules/ROOT/pages/api-changelog.adoc +++ b/modules/ROOT/pages/api-changelog.adoc @@ -105,9 +105,9 @@ For more information, see xref:full-app-customize.adoc#_search_components[Search |==== |[tag greenBackground]#NEW FEATURE# a| You can now embed the following ThoughtSpot Spotter components in your app: -* `ConversationEmbed` + +* `SpotterEmbed` + Embeds Spotter conversation interface in your app -* `BodylessConversation` + +* `SpotterAgentEmbed` + Creates a conversation component without the body, which can be integrated into chatbots or other conversational apps. For more information, see xref:embed-spotter.adoc[Embed Spotter] and xref:spotter-in-custom-chatbot.adoc[Integrate Spotter into your chatbot]. diff --git a/modules/ROOT/pages/developer-playground.adoc b/modules/ROOT/pages/developer-playground.adoc index f21887e96..47bfa6898 100644 --- a/modules/ROOT/pages/developer-playground.adoc +++ b/modules/ROOT/pages/developer-playground.adoc @@ -435,7 +435,7 @@ For more information about the configuration settings and parameters, see the fo * xref:SearchViewConfig.adoc[SearchViewConfig] * xref:SageViewConfig.adoc[SageViewConfig] -* xref:BodylessConversationViewConfig.adoc[BodylessConversationViewConfig] +* xref:SpotterAgentEmbedViewConfig.adoc[SpotterAgentEmbedViewConfig] * xref:LiveboardViewConfig[LiveboardViewConfig] * xref:AppViewConfig.adoc[AppViewConfig] diff --git a/modules/ROOT/pages/embed-action-ref.adoc b/modules/ROOT/pages/embed-action-ref.adoc index d69ab41a2..49042ceb1 100644 --- a/modules/ROOT/pages/embed-action-ref.adoc +++ b/modules/ROOT/pages/embed-action-ref.adoc @@ -241,24 +241,24 @@ The following action IDs are available for the Spotter component: [options='header'] |===== |Action string in SDK| Required SDK library|Action label in the UI -|xref:Action.adoc#_previewdataspotter[`Action.PreviewDataSpotter`] | `ConversationEmbed` + +|xref:Action.adoc#_previewdataspotter[`Action.PreviewDataSpotter`] | `SpotterEmbed` + `AppEmbed` |*Preview data* action on the Spotter conversation panel. Shows the underlying data used for Spotter queries. -|xref:Action.adoc#_resetspotterchat[`Action.ResetSpotterChat`] |`ConversationEmbed` + +|xref:Action.adoc#_resetspotterchat[`Action.ResetSpotterChat`] |`SpotterEmbed` + `AppEmbed` | *Preview data* action on the Spotter conversation panel. Shows the underlying data used for Spotter queries. -|xref:Action.adoc#_editpreviousprompt[`Action.EditPreviousPrompt`] |`ConversationEmbed` + +|xref:Action.adoc#_editpreviousprompt[`Action.EditPreviousPrompt`] |`SpotterEmbed` + `AppEmbed` | The edit icon on the Spotter prompt panel. Allows editing the prompt sent to Spotter. -|xref:xref:Action.adoc#_deletepreviousprompt[`Action.DeletePreviousPrompt`] |`ConversationEmbed` + +|xref:xref:Action.adoc#_deletepreviousprompt[`Action.DeletePreviousPrompt`] |`SpotterEmbed` + `AppEmbed` | The delete icon on the Spotter prompt panel. Allows deleting the prompt sent to Spotter. -|xref:xref:Action.adoc#_spotterfeedback[`Action.SpotterFeedback`] |`ConversationEmbed` + +|xref:xref:Action.adoc#_spotterfeedback[`Action.SpotterFeedback`] |`SpotterEmbed` + `AppEmbed` | The Spotter feedback widget in the generated Answer. Allows sending feedback about the response received from Spotter. |===== -For information about the action IDs available for Answers generated from Spotter (`ConversationEmbed`), see xref:embed-action-ref#answer-actions[Answers]. +For information about the action IDs available for Answers generated from Spotter (`SpotterEmbed`), see xref:embed-action-ref#answer-actions[Answers]. [#answer-actions] == Answers @@ -268,38 +268,38 @@ The following actions are available on saved Answers and the Answers generated b [options='header'] |===== |Action string in SDK| Required SDK library|Action label in the UI -|xref:Action.adoc#_choosedatasources[`Action.ChooseDataSources`]| `ConversationEmbed` + +|xref:Action.adoc#_choosedatasources[`Action.ChooseDataSources`]| `SpotterEmbed` + `SageEmbed` + `SearchEmbed` + `SearchBarEmbed` + `AppEmbed`|The *Choose sources* option in the Search page and Spotter conversation panel. + Allows selecting data sources to query data. + -|xref:Action.adoc#_addformula[`Action.AddFormula`]| `ConversationEmbed` + +|xref:Action.adoc#_addformula[`Action.AddFormula`]| `SpotterEmbed` + `SageEmbed` + `SearchEmbed` + `SearchBarEmbed` + `AppEmbed`| *Create formula* option on the data panel of an Answer page + Allows adding formulas to a search query. + -|xref:Action.adoc#_addparameter[`Action.AddParameter`]|`ConversationEmbed` + +|xref:Action.adoc#_addparameter[`Action.AddParameter`]|`SpotterEmbed` + `SageEmbed` + `SearchEmbed` + `AppEmbed`| *Add Parameters* option in the data panel on a Search page + Allows adding parameters to an Answer. -|xref:Action.adoc#_answerchartswitcher[`Action.AnswerChartSwitcher`]|`ConversationEmbed` + +|xref:Action.adoc#_answerchartswitcher[`Action.AnswerChartSwitcher`]|`SpotterEmbed` + `SageEmbed` + `SearchEmbed` + `AppEmbed` | Chart toggle icon + Allows switching to the table or chart mode. -|xref:Action.adoc#_edit[`Action.Edit`]| `ConversationEmbed` + +|xref:Action.adoc#_edit[`Action.Edit`]| `SpotterEmbed` + `AppEmbed` | *Edit* action on charts and tables generated from a Spotter query. Opens a table or chart in the edit mode. -|xref:Action.adoc#_pin[`Action.Pin`]| `ConversationEmbed` + +|xref:Action.adoc#_pin[`Action.Pin`]| `SpotterEmbed` + `SageEmbed` + `SearchEmbed` + `AppEmbed` | *Pin* action on the visualization generated from a Spotter query. Allows adding a visualization generated from Spotter to a Liveboard. -|xref:Action.adoc#_save[`Action.Save`]| `ConversationEmbed` + +|xref:Action.adoc#_save[`Action.Save`]| `SpotterEmbed` + `SageEmbed` + `SearchEmbed` + `AppEmbed` | *Save* action on the visualization generated from a Spotter query @@ -320,7 +320,7 @@ Allows generating SpotIQ analyses. Available as a primary button and contextual `AppEmbed`|*Share* + Allows you to share an Answer with another user or group. -|xref:Action.adoc#_querydetailsbuttons[`Action.QueryDetailsButtons`]| `ConversationEmbed` + +|xref:Action.adoc#_querydetailsbuttons[`Action.QueryDetailsButtons`]| `SpotterEmbed` + `SageEmbed` + `SearchEmbed` + `AppEmbed` @@ -329,7 +329,7 @@ a|The *Query visualizer* and *Query SQL* buttons in *Query details* on the Answe * The *Query visualizer* button displays the tables and filters used in a search query. + * The *Query SQL* button displays the SQL statements used in a search query to fetch data. + -|xref:Action.adoc#_download[`Action.Download`]|`ConversationEmbed` + +|xref:Action.adoc#_download[`Action.Download`]|`SpotterEmbed` + `SageEmbed` + `SearchEmbed` + `AppEmbed` a|*Download* + @@ -345,28 +345,28 @@ If you are using Visual Embed SDK version 1.21.0 or later to embed Liveboard, Se ** `Action.DownloadAsXlsx` + ** `Action.DownloadAsPng` -|xref:Action.adoc#_downloadascsv[`Action.DownloadAsCsv`]|`ConversationEmbed` + +|xref:Action.adoc#_downloadascsv[`Action.DownloadAsCsv`]|`SpotterEmbed` + `SageEmbed` + `SearchEmbed` + `AppEmbed` |*Download* > *CSV* + Downloads the answer data in the CSV file format. -|xref:Action.adoc#_downloadasxlsx[`Action.DownloadAsXLSX`]|`ConversationEmbed` + +|xref:Action.adoc#_downloadasxlsx[`Action.DownloadAsXLSX`]|`SpotterEmbed` + `SageEmbed` + `SearchEmbed` + `AppEmbed` | *Download* > *XLSX* + Downloads the answer data in the XLSX file format. -|xref:Action.adoc#_downloadaspdf[`Action.DownloadAsPdf`]|`ConversationEmbed` + +|xref:Action.adoc#_downloadaspdf[`Action.DownloadAsPdf`]|`SpotterEmbed` + `SageEmbed` + `SearchEmbed` + `AppEmbed` |*Download* > *PDF* + Downloads the answer data as a PDF file. Available only for tables. -|xref:Action.adoc#_downloadaspng[`Action.DownloadAsPng`]|`ConversationEmbed` + +|xref:Action.adoc#_downloadaspng[`Action.DownloadAsPng`]|`SpotterEmbed` + `SageEmbed` + `SearchEmbed` + `AppEmbed` |*Download* > *PNG* + Downloads the chart as a PNG file. Available only for charts. -|xref:Action.adoc#_showunderlyingdata[`Action.ShowUnderlyingData`]|`ConversationEmbed` + +|xref:Action.adoc#_showunderlyingdata[`Action.ShowUnderlyingData`]|`SpotterEmbed` + `SageEmbed` + `SearchEmbed` + `AppEmbed`|*Show underlying data* + @@ -385,7 +385,7 @@ Allows creating a sync to send data to external business apps such as Slack, Sal `SearchEmbed` + `AppEmbed`| The *Manage pipelines* action in the **More** actions menu. + Allows managing data sync pipelines to external business apps set as sync destinations in ThoughtSpot. -|xref:Action.adoc#_exporttml[`Action.ExportTML`]|`ConversationEmbed` + +|xref:Action.adoc#_exporttml[`Action.ExportTML`]|`SpotterEmbed` + `SageEmbed` + `SearchEmbed` + `AppEmbed` | *Export TML* + @@ -405,24 +405,24 @@ The following actions are available in the contextual menu of an Answer: [options='header'] |===== |Action string in SDK| Required SDK library|Action label in the UI -|xref:Action.adoc#_drillexclude[`Action.DrillExclude`]|`ConversationEmbed` + +|xref:Action.adoc#_drillexclude[`Action.DrillExclude`]|`SpotterEmbed` + `SageEmbed` + `SearchEmbed` + `AppEmbed`|*Exclude* + Allows you to exclude a specific data point when drilling down on an Answer. -|xref:Action.adoc#_drillinclude[`Action.DrillInclude`]|`ConversationEmbed` + +|xref:Action.adoc#_drillinclude[`Action.DrillInclude`]|`SpotterEmbed` + `SageEmbed` + `SearchEmbed` + `AppEmbed` |*Include* + Allows you to include a specific data point during drill down on an Answer. -|xref:Action.adoc#_drilldown[`Action.DrillDown`]|`ConversationEmbed` + +|xref:Action.adoc#_drilldown[`Action.DrillDown`]|`SpotterEmbed` + `SageEmbed` + `SearchEmbed` + `AppEmbed` |*Drill down* + Allows you to drill down the data for additional details and granular information. Available as a contextual menu action. -|xref:Action.adoc#_copytoclipboard[`Action.CopyToClipboard`] |`ConversationEmbed` + +|xref:Action.adoc#_copytoclipboard[`Action.CopyToClipboard`] |`SpotterEmbed` + `SageEmbed` + `SearchEmbed` + `AppEmbed`|*Copy to clipboard* + diff --git a/modules/ROOT/pages/embed-spotter.adoc b/modules/ROOT/pages/embed-spotter.adoc index 12d9f7f20..9ccfdf20b 100644 --- a/modules/ROOT/pages/embed-spotter.adoc +++ b/modules/ROOT/pages/embed-spotter.adoc @@ -4,7 +4,7 @@ :page-title: Embed Spotter :page-pageid: embed-spotter -:page-description: You can use the ConversationEmbed SDK library to embed Conversational analytics experience in your application. +:page-description: You can use the SpotterEmbed SDK library to embed Conversational analytics experience in your application. ThoughtSpot supports Natural Language Search queries and AI-generated Answers. With ThoughtSpot Spotter, this experience is further enhanced to a full conversational interface that users can interact with, ask follow-up questions, and get insights. @@ -12,9 +12,9 @@ Visual Embed SDK offers several options to seamlessly embed conversational analy To integrate Spotter capabilities into your application environment, the following components are available: -* `ConversationEmbed` + +* `SpotterEmbed` + Allows embedding the full Spotter interface with a conversation panel and body. -* `BodylessConversation` + +* `SpotterAgentEmbed` + Allows integrating xref:spotter-in-custom-chatbot.adoc[Spotter capabilities into a chatbot]. Additionally, you can also use xref:spotter-apis.adoc[REST APIs to create a conversation session, ask follow-up questions, and generate Answers]. @@ -23,7 +23,7 @@ This article describes how to embed Spotter with a conversation panel and body i === Spotter components -The `ConversationEmbed` package adds the following components to your embedding application: +The `SpotterEmbed` package adds the following components to your embedding application: * A conversation panel and prompt button to interact with Spotter. * The data source selector that allows application users to select a data source for Spotter analysis. @@ -41,13 +41,13 @@ Before you begin, check the following: == Import the SDK package -Import the `ConversationEmbed` SDK library to your application environment: +Import the `SpotterEmbed` SDK library to your application environment: **npm** [source,JavaScript] ---- import { - ConversationEmbed, + SpotterEmbed, AuthType, init, prefetch, @@ -60,7 +60,7 @@ from '@thoughtspot/visual-embed-sdk'; ----