To run this command, 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 –name flag. If you don’t specify any of the required flags, the command prompts you.
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. When previewing, the command creates a JSON file in the current directory with all the agent details. The name of the JSON file is the agent’s API name and a timestamp.
To open the new agent in your org’s Agent Builder UI, run this command: “sf org open agent –api-name <api-name>”.
Flags
Flag Name (Long)
Flag Name (Short)
Description
‑‑api‑name
N/A
Type: Value
API name of the new agent; if not specified, the API name is derived from the agent name (label); the API name must not exist in the org.
‑‑api‑version
N/A
Type: Value
Override the api version used for api requests made by this command
‑‑flags‑dir
N/A
Type: Value
Import flag values from a directory.
‑‑json
N/A
Type: Boolean
Format output as json.
‑‑name
N/A
Type: Value
Name (label) of the new agent.
‑‑preview
N/A
Type: Boolean
Preview the agent without saving it in your org.
‑‑spec
N/A
Type: Value
Path to an agent spec file.
‑‑target‑org
‑o
Type: Value Required
Username or alias of the target org. Not required if the target-org configuration variable is already set.
Examples for agent create
Create an agent by being prompted for the required information, such as the agent spec file and agent name, and then create it in your default org:
1sf agent create
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:
j