Update agent.create.md

Author: jshackell-sfdc

messages/agent.create.md

@@ -4,13 +4,13 @@ Create an agent in your org using a local agent spec file.
 
 # description
 
-Before you run this command, you must first generate an agent spec file by running the "agent generate spec" CLI command, which outputs a YAML file with the agent properties and list of AI-generated topics. Topics define the range of jobs the agent can handle. Then specify the generated agent spec file to this command using the --spec flag, along with the name (label) of the new agent using the --agent-name flag.
+To run this comand, you must have an agent spec file, which is a YAML file that define the agent properties and contains a list of AI-generated topics. Topics define the range of jobs the agent can handle. Use the "agent generate agent-spec" CLI command to generate an agent spec file. Then specify the file to this command using the --spec flag, along with the name (label) of the new agent with the --agent-name flag. If you don't specify any of the required flags, the command prompts you.
 
-When this command finishes, your org contains the new agent, which you can then edit in the Agent Builder UI. The new agent's topics are the same as the ones listed in the agent spec file. The agent might also have some AI-generated actions. This command also retrieves all the metadata files associated with the new agent to your local Salesforce DX project.
+When this command completes, your org contains the new agent, which you can then edit and customize in the Agent Builder UI. The new agent's topics are the same as the ones listed in the agent spec file. The agent might also have some AI-generated actions, or you can add them. This command also retrieves all the metadata files associated with the new agent to your local Salesforce DX project.
 
-Use the --preview flag to review what the agent looks like without actually saving it in your org. Rather, the command creates a JSON file with all the agent details in the current directory.
+Use the --preview flag to review what the agent looks like without actually saving it in your org. When previewing, the command creates a JSON file in the current directory with all the agent details.
 
-To open the new agent in your org's Agent Builder UI, run this command: "sf org open agent --name <api-name-of-your-agent>".
+To open the new agent in your org's Agent Builder UI, run this command: "sf org open agent --name <agent-api-name>".
 
 # flags.spec.summary
 
@@ -42,14 +42,18 @@ Missing required flags: %s
 
 # error.missingRequiredSpecProperties
 
-Missing required spec file properties: %s
+Your agent spec file is missing these required properties: %s.
 
 # examples
 
-- Create an agent called "ResortManager" in an org with alias "my-org" using the specified agent spec file:
+- Create an agent by being prompted for the required information, such as the agent spec file, agent name, and agent API name and then create it in your default org:
 
-  <%= config.bin %> <%= command.id %> --agent-name ResortManager --spec specs/resortManagerAgent.yaml --target-org my-org
+  <%= config.bin %> <%= command.id %>
 
-- Preview the creation of an agent called "ResortManager" and use your default org:
+- Create an agent by specifying the agent name, API name, and spec file with flags; use the org with alias "my-org"; the command fails if the API name is already being used in your org:
 
-  <%= config.bin %> <%= command.id %> --agent-name ResortManager --spec specs/resortManagerAgent.yaml --preview
+  <%= config.bin %> <%= command.id %> --agent-name "Resort Manager" --agent-api-name Resort_Manager --spec specs/resortManagerAgent.yaml --target-org my-org
+
+- Preview the creation of an agent named "Resort Manager" and use your default org:
+
+  <%= config.bin %> <%= command.id %> --agent-name "Resort Manager" --spec specs/resortManagerAgent.yaml --preview