From d6b6dc248ed480e173f4197260e31c51124c5ec0 Mon Sep 17 00:00:00 2001
From: Juliet Shackell <63259011+jshackell-sfdc@users.noreply.github.com>
Date: Wed, 13 Nov 2024 08:35:27 -0800
Subject: [PATCH] edit messages (#1265)

---
 messages/open.agent.md | 16 ++++++++--------
 1 file changed, 8 insertions(+), 8 deletions(-)

diff --git a/messages/open.agent.md b/messages/open.agent.md
index 07581f14..80726dfc 100644
--- a/messages/open.agent.md
+++ b/messages/open.agent.md
@@ -1,32 +1,32 @@
 # summary
 
-Open an agent in the Agent Builder org UI in a browser.
+Open an agent in your org's Agent Builder UI in a browser.
 
 # description
 
-Use the --name flag to open an agent using the developer name (aka API name) in the Agent Builder Org UI.
+Use the --name flag to open an agent using its API name in the Agent Builder UI of your org. To find the agent's API name, go to Setup in your org and navigate to the agent's details page; the API name is shown in the top-right.
 
-To generate a URL but not launch it in your browser, specify --url-only.
+To generate the URL but not launch it in your browser, specify --url-only.
 
-To open in a specific browser, use the --browser flag. Supported browsers are "chrome", "edge", and "firefox". If you don't specify --browser, the org opens in your default browser.
+To open Agent Builder in a specific browser, use the --browser flag. Supported browsers are "chrome", "edge", and "firefox". If you don't specify --browser, the org opens in your default browser.
 
 # examples
 
-- Open the agent with developer name "Coral_Cloud_Agent using the default browser:
+- Open the agent with API name Coral_Cloud_Agent in your default org using your default browser:
 
   $ <%= config.bin %> <%= command.id %> --name Coral_Cloud_Agent
 
 - Open the agent in an incognito window of your default browser:
 
-  $ <%= config.bin %> <%= command.id %> --private --name Coral_Cloud_Agent
+  $ <%= config.bin %> <%= command.id %> --private --name Coral_Cloud_Agent:
 
-- Open the agent in the org with alias MyTestOrg1 using the Firefox browser:
+- Open the agent in an org with alias MyTestOrg1 using the Firefox browser:
 
   $ <%= config.bin %> <%= command.id %> --target-org MyTestOrg1 --browser firefox --name Coral_Cloud_Agent
 
 # flags.name.summary
 
-The developer name (aka API name) of the agent to open in the Agent Builder org UI.
+API name, also known as developer name, of the agent you want to open in the org's Agent Builder UI.
 
 # flags.private.summary