Merge pull request #183 from salesforcecli/jshackell-sfdc-patch-1

W-19176724: edit messages for "agent activate|deactivate"

Author: shetzel

messages/agent.activate.md

@@ -1,18 +1,20 @@
 # summary
 
-Activate an agent in the org.
+Activate an agent in an org.
 
 # description
 
-An agent can be active or inactive within an org. Active agents are available in the org and can be previewed using the CLI or VS Code while inactive agents cannot.
+Activating an agent makes it immediately available to your users. An agent must be active before you can preview it with the "agent preview" CLI command or VS Code.
+
+You must know the agent's API name to activate it; you can either be prompted for it or you can specify it with the --api-name flag. Find the agent's API name in its Agent Details page of your org's Agentforce Studio UI in Setup.
 
 # examples
 
-- Activate an agent in the default target org by being prompted:
+- Activate an agent in your default target org by being prompted:
 
   <%= config.bin %> <%= command.id %>
 
-- Activate an agent by specifying the agent API name and target org:
+- Activate an agent with API name Resort_Manager in the org with alias "my-org":
 
   <%= config.bin %> <%= command.id %> --api-name Resort_Manager --target-org my-org
 

messages/agent.activation.md

@@ -1,15 +1,15 @@
 # error.noAgentsInOrg
 
-No Agents found in org %s.
+No agents found in org %s.
 
 # error.missingAgentInOrg
 
 Agent %s not found in org %s.
 
 # error.agentIsDeleted
 
-Agent %s is deleted and cannot be activated.
+Agent %s has been deleted and can't be activated.
 
 # error.agentIsDefault
 
-Agent %s is an org default agent and cannot be activated.
+Agent %s is the default Agentforce agent in your org and you can't change its activation status. 

messages/agent.deactivate.md

@@ -1,18 +1,20 @@
 # summary
 
-Deactivate an agent in the org.
+Deactivate an agent in an org.
 
 # description
 
-An agent can be active or inactive within an org. Active agents are available in the org and can be previewed using the CLI or VS Code while inactive agents cannot.
+Deactivating an agent makes it unavailable to your users. To make changes to an agent, such as adding or removing topics or actions, you must deactivate it. You can't preview an agent with the "agent preview" CLI command or VS Code if it's deactivated.
+
+You must know the agent's API name to deactivate it; you can either be prompted for it or you can specify it with the --api-name flag. Find the agent's API name in its Agent Details page of your org's Agentforce Studio UI in Setup.
 
 # examples
 
-- Deactivate an agent in the default target org by being prompted:
+- Deactivate an agent in your default target org by being prompted:
 
   <%= config.bin %> <%= command.id %>
 
-- Deactivate an agent by specifying the agent API name and target org:
+- Deactivate the agent Resort_Manager in the org with alias "my_org":
 
   <%= config.bin %> <%= command.id %> --api-name Resort_Manager --target-org my-org
 

messages/agent.preview.md

@@ -10,7 +10,7 @@ This command is useful to test if the agent responds to your utterances as you e
 
 When the session concludes, the command asks if you want to save the API responses and chat transcripts. By default, the files are saved to the "./temp/agent-preview" directory. Specify a new default directory by setting the environment variable "SF_AGENT_PREVIEW_OUTPUT_DIR" to the directory. Or you can pass the directory to the --output-dir flag.
 
-Find the agent's API name in its main details page in your org's Agent page in Setup.
+Find the agent's API name in its Agent Details page of your org's Agentforce Studio UI in Setup. If your agent is currently deactivated, use the "agent activate" CLI command to activate it.
 
 IMPORTANT: Before you use this command, you must complete a number of configuration steps in your org and your DX project. The examples in this help assume you've completed the steps. See "Preview an Agent" in the "Agentforce Developer Guide" for complete documentation: https://developer.salesforce.com/docs/einstein/genai/guide/agent-dx-preview.html.
 
@@ -32,7 +32,7 @@ Enable Apex debug logging during the agent preview conversation.
 
 # examples
 
-- Interact with an agent with API name "Resort_Manager" in the org with alias "my-org" and the linked "agent-app" connected app:
+- Interact with an agent with API name Resort_Manager in the org with alias "my-org" and the linked "agent-app" connected app:
 
   <%= config.bin %> <%= command.id %> --api-name Resort_Manager --target-org my-org --client-app agent-app