spotter-coaching terminology udpate

Author: ShashiSubramanya

modules/ROOT/pages/api-changelog.adoc

@@ -328,13 +328,13 @@ For more information, see xref:embed-spotter.adoc[Embedding Spotter] and xref:em
 
 Events::
 
-* `EmbedEvent.AddToCoaching` for the *Add to coaching* workflow in a Spotter conversation session
-* `HostEvent.AddToCoaching` to trigger the *Add to coaching* action in a Spotter conversation session.
+* `EmbedEvent.AddToCoaching` for the *Add to Coaching* workflow in a Spotter conversation session
+* `HostEvent.AddToCoaching` to trigger the *Add to Coaching* action in a Spotter conversation session.
 * `HostEvent.StartNewSpotterConversation` to trigger the action to start a new chat session with Spotter.
 
 [NOTE]
 ====
-On Spotter embed deployments running version 26.2.0.cl or later, the *Add to Coaching* feature is enabled by default. To disable or hide the **Add to Coaching** button, use the xref:Action.adoc#_inconversationtraining[InConversationTraining] action ID.
+On Spotter embed deployments running version 26.2.0.cl or later, the *Add to Coaching* feature is enabled by default. To disable or hide the *Add to Coaching* button, use the xref:Action.adoc#_inconversationtraining[InConversationTraining] action ID.
 ====
 
 |[tag greenBackground]#NEW FEATURE# a| **Liveboard experience enhancements** +
@@ -596,11 +596,12 @@ Replaced with `SpotterAgentEmbed`
 Replaced with `SpotterAgentEmbedViewConfig`
 
 The deprecated components with old names in the existing Spotter embed implementations will continue to function until further notice. For code samples with new component names, see xref:embed-spotter.adoc[Spotter embed documentation].
-|[tag greenBackground]#NEW FEATURE# a| *Action ID of Spotter coaching* +
-For ThoughtSpot instances that have the new Spotter feedback and coaching workflow enabled, SDK provides the action ID `Action.InConversationTraining` to manage the visibility of the *Add to coaching* button on Answer generated from Spotter prompts.
+
+|[tag greenBackground]#NEW FEATURE# a| *Action ID for Spotter in-conversation training* +
+For ThoughtSpot instances that have the new Spotter in-conversation training workflow enabled, the SDK provides the action ID `Action.InConversationTraining` to manage the visibility of the *Add to Coaching* button on Answers generated from Spotter prompts.
 
 [NOTE]
-The **Add to Coaching** feature is currently in beta and is turned off by default on embed deployments. To enable this feature on your instance, contact ThoughtSpot Support.
+The *Add to Coaching* feature is currently in beta and is turned off by default on embed deployments. To enable this feature on your instance, contact ThoughtSpot Support.
 
 |[tag greenBackground]#NEW FEATURE# a|*Events support for Spotter embed*
 

modules/ROOT/pages/common/nav-rest-api.adoc

@@ -22,7 +22,7 @@ REST APIs
 * link:{{navprefix}}/spotter-api[Spotter APIs]
 ** link:{{navprefix}}/spotter-agent-apis[AI APIs (Spotter Agent and Spotter 3)]
 ** link:{{navprefix}}/spotter-apis-classic[AI APIs (Spotter Classic) ^BETA^]
-** link:{{navprefix}}/spotter-coaching-apis[Spotter coaching APIs ^BETA^]
+** link:{{navprefix}}/spotter-nl-instructions[Spotter instructions APIs ^BETA^]
 * link:{{navprefix}}/audit-logs[Audit logs]
 * link:{{navprefix}}/tml[TML]
 * link:{{navprefix}}/collections[Collections ^BETA^]

modules/ROOT/pages/rest-apiv2-changelog.adoc

@@ -241,11 +241,12 @@ Allows modifying storage configuration for a webhook.
 Retrieves storage configuration details.
 
 === Object privilege APIs
-Administrators and users with edit access to data models can now use `/api/rest/2.0/security/metadata/manage-object-privilege` to assign object-level permissions to users and groups and allow access to Spotter coaching information.
+Administrators and users with edit access to data models can now use `/api/rest/2.0/security/metadata/manage-object-privilege` to assign object-level permissions to users and groups and control access to Spotter data model instructions.
 
 To fetch object privileges for a data model, user, or group, use the `/api/rest/2.0/security/metadata/fetch-object-privileges` API endpoint.
 
-For more information, see xref:spotter-apis.adoc#_spotter_coaching_access[Spotter coaching access].
+For more information, see xref:spotter-nl-instructions.adoc#_spotter_data_model_instructions_access[Spotter data model instructions access].
+
 
 === User API enhancements
 
@@ -321,7 +322,7 @@ The `include_variable_values` parameter in the API request allows including vari
 This release introduces the following Spotter APIs:
 
 * `POST /api/rest/2.0/ai/instructions/set` +
-Allows configuring natural language (NL) instructions on a model to coach Spotter on how to interpret queries, handle data nuances, and improve responses.
+Allows configuring natural language (NL) instructions on a data model to define how Spotter interprets queries, handles data nuances, and improves responses.
 * `POST /api/rest/2.0/ai/instructions/get` +
 Gets NL instructions that are currently assigned to a model.
 * `POST /api/rest/2.0/ai/data-source-suggestions` +

modules/ROOT/pages/spotter-agent-instructions.adoc

@@ -8,7 +8,7 @@
 
 Administrators and developers can configure persistent behavioral instructions for the Spotter agent using the agent instructions APIs. These instructions guide how Spotter responds within a conversation context. For example, to focus on specific business domains, enforce response formats, or apply analytical constraints.
 
-Unlike xref:spotter-nl-instructions.adoc[NL coaching instructions], which operate at the data model level, agent instructions operate at the agent level and do not require a data source identifier.
+Unlike xref:spotter-nl-instructions.adoc[data model instructions], which operate at the data model level, agent instructions operate at the agent level and do not require a data source identifier.
 
 [NOTE]
 ====
@@ -126,7 +126,7 @@ If no instructions are configured, ThoughtSpot returns an empty value for the `i
 
 == Related resources
 
-* For information about coaching Spotter at the data model level, see xref:spotter-nl-instructions.adoc[Spotter coaching APIs].
+* For information about adding instructions at the data model level, see xref:spotter-nl-instructions.adoc[Data model instruction APIs].
 * For information about Spotter agent conversation workflows, see xref:spotter-agent-apis.adoc[AI APIs (Spotter Agent and Spotter 3)].
 * Visit the +++<a href="{{navprefix}}/restV2-playground?apiResourceId=http%2Fapi-endpoints%2Fai%2Fset-agent-instructions" id="preview-in-playground">REST API v2.0 Playground</a>+++ to test the set agent instructions endpoint.
 * Visit the +++<a href="{{navprefix}}/restV2-playground?apiResourceId=http%2Fapi-endpoints%2Fai%2Fget-agent-instructions" id="preview-in-playground">REST API v2.0 Playground</a>+++ to test the get agent instructions endpoint.

modules/ROOT/pages/spotter-nl-instructions.adoc

@@ -1,15 +1,15 @@
-= Spotter instructions API
+= Data model instructions API
 :toc: true
 :toclevels: 2
 
-:page-title: Spotter APIs
-:page-pageid: spotter-coaching-apis
-:page-description: You can use Spotter REST APIs to receive Answers for your analytical queries sent through the conversational experience with ThoughtSpot.
+:page-title: Data model instructions APIs
+:page-pageid: spotter-nl-instructions
+:page-description: Use the data model instructions APIs to set and retrieve natural language instructions at the data model level to guide how Spotter interprets and answers user queries.
 
-Administrators and data owners can guide and refine how Spotter interprets and answers user questions. The natural language (NL) instructions API allows you to set instructions at the data model level. The API provides business context and preferred interpretations for specific queries or terminology to coach Spotter, but it does not train or change the underlying LLM.
+Administrators and data owners can guide and refine how Spotter interprets and answers user questions. The natural language (NL) instructions API allows you to set instructions at the data model level. The API provides business context and preferred interpretations for specific queries or terminology, but it does not train or change the underlying LLM.
 
 == Set NL instructions
-To coach and instruct the Spotter system on how to interpret queries, apply filters, select columns, handle data nuances, and present answers using the data from a specific model, you can set global rules in natural language format. Setting instructions helps Spotter generate precise and consistent responses for user queries.
+To define how Spotter interprets queries, applies filters, selects columns, handles data nuances, and presents answers using the data from a specific model, you can set global rules in natural language format. Setting data model instructions helps Spotter generate precise and consistent responses for user queries.
 
 To set instructions for a Model, send a `POST` request to the `/api/rest/2.0/ai/instructions/set` API endpoint.
 
@@ -35,7 +35,7 @@ Sets the scope for the rules. By default, the rules are applied globally for all
 
 === Example request
 
-The following example defines instructions to coach Spotter on how to interpret the query:
+The following example defines data model instructions that guide Spotter on how to interpret queries:
 
 [source,cURL]
 ----
@@ -109,13 +109,14 @@ If the instructions are configured on the Model specified in the API request, Th
 }
 ----
 
-== Spotter coaching access
 
-ThoughtSpot supports publishing Spotter coaching information to other Orgs. Coaching changes from the primary Org are synchronized with the data models published in secondary Orgs.
+== Spotter data model instructions access
 
-=== Assign Spotter coaching access privilege
+ThoughtSpot supports publishing data model instructions to other Orgs. Data model instruction changes from the primary Org are synchronized with the data models published in secondary Orgs.
 
-To allow users and groups to access spotter coaching information in data models, assign the `SPOTTER_COACHING_PRIVILEGE` via `POST` request to the `/api/rest/2.0/security/metadata/manage-object-privilege` API endpoint.
+=== Assign the data model instructions privilege
+
+To allow users and groups to access data model instructions, assign the `SPOTTER_COACHING_PRIVILEGE` via `POST` request to the `/api/rest/2.0/security/metadata/manage-object-privilege` API endpoint.
 
 In the API request, specify the data model, user, and group, and ensure that the object privilege is set to `SPOTTER_COACHING_PRIVILEGE`.
 
@@ -145,9 +146,10 @@ curl -X POST \
 
 If the request is successful, the API returns the 204 response code.
 
-=== Get a list of users or groups with Spotter coaching privilege
 
-To get a list of users and groups with the Spotter coaching privilege for a specific data model or all data models, send a `POST` request to the `/api/rest/2.0/security/metadata/fetch-object-privileges` API endpoint.
+=== Get a list of users or groups with the data model instructions privilege
+
+To get a list of users and groups with the data model instructions privilege (`SPOTTER_COACHING_PRIVILEGE`) for a specific data model or all data models, send a `POST` request to the `/api/rest/2.0/security/metadata/fetch-object-privileges` API endpoint.
 
 In the API request, specify the user or the group for which you want to retrieve the object privilege details.
 

modules/ROOT/pages/whats-new.adoc

@@ -364,7 +364,7 @@ Administrators and users with edit access to data models can programmatically co
 
 Users and groups with `SPOTTER_COACHING_PRIVILEGE` can import and export coaching TML on data models in the source and destination Orgs where the model is published, and can also share these objects with other users and groups.
 
-For more information, see xref:spotter-apis.adoc#_spotter_coaching_access[Spotter coaching access].
+For more information, see xref:spotter-nl-instructions.adoc#_spotter_data_model_instructions_access[Spotter data model instructions access].
 
 ---