Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension


Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
49 changes: 29 additions & 20 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -25,7 +25,7 @@ $ npm install -g @salesforce/cli
$ sf COMMAND
running command...
$ sf (--version|-v)
@salesforce/cli/2.122.6 linux-x64 node-v22.22.0
@salesforce/cli/2.123.0 linux-x64 node-v22.22.0
$ sf --help [COMMAND]
USAGE
$ sf COMMAND
Expand Down Expand Up @@ -248,7 +248,7 @@ EXAMPLES
$ sf agent activate --api-name Resort_Manager --target-org my-org
```

_See code: [@salesforce/plugin-agent](https://github.com/salesforcecli/plugin-agent/blob/1.27.3/src/commands/agent/activate.ts)_
_See code: [@salesforce/plugin-agent](https://github.com/salesforcecli/plugin-agent/blob/1.27.5/src/commands/agent/activate.ts)_

## `sf agent create`

Expand Down Expand Up @@ -315,7 +315,7 @@ EXAMPLES
$ sf agent create --name "Resort Manager" --spec specs/resortManagerAgent.yaml --preview
```

_See code: [@salesforce/plugin-agent](https://github.com/salesforcecli/plugin-agent/blob/1.27.3/src/commands/agent/create.ts)_
_See code: [@salesforce/plugin-agent](https://github.com/salesforcecli/plugin-agent/blob/1.27.5/src/commands/agent/create.ts)_

## `sf agent deactivate`

Expand Down Expand Up @@ -355,7 +355,7 @@ EXAMPLES
$ sf agent deactivate --api-name Resort_Manager --target-org my-org
```

_See code: [@salesforce/plugin-agent](https://github.com/salesforcecli/plugin-agent/blob/1.27.3/src/commands/agent/deactivate.ts)_
_See code: [@salesforce/plugin-agent](https://github.com/salesforcecli/plugin-agent/blob/1.27.5/src/commands/agent/deactivate.ts)_

## `sf agent generate agent-spec`

Expand Down Expand Up @@ -462,7 +462,7 @@ EXAMPLES
$ sf agent generate agent-spec --tone formal --agent-user resortmanager@myorg.com
```

_See code: [@salesforce/plugin-agent](https://github.com/salesforcecli/plugin-agent/blob/1.27.3/src/commands/agent/generate/agent-spec.ts)_
_See code: [@salesforce/plugin-agent](https://github.com/salesforcecli/plugin-agent/blob/1.27.5/src/commands/agent/generate/agent-spec.ts)_

## `sf agent generate authoring-bundle`

Expand All @@ -471,18 +471,20 @@ Generate an authoring bundle from an existing agent spec YAML file.
```
USAGE
$ sf agent generate authoring-bundle -o <value> [--json] [--flags-dir <value>] [--api-name <value>] [--api-version <value>] [-f
<value>] [-d <value>] [-n <value>]
<value>] [--no-spec] [-d <value>] [-n <value>]

FLAGS
-d, --output-dir=<value> Directory where the authoring bundle files are generated.
-f, --spec=<value> Path to the agent spec YAML file; if not specified, the command provides a list that you
can choose from.
-f, --spec=<value> Path to the agent spec YAML file. If you don't specify the flag, the command provides a
list that you can choose from. Use the --no-spec flag to skip using an agent spec entirely.
-n, --name=<value> Name (label) of the authoring bundle; if not specified, you're prompted for the name.
-o, --target-org=<value> (required) Username or alias of the target org. Not required if the `target-org`
configuration variable is already set.
--api-name=<value> API name of the new authoring bundle; if not specified, the API name is derived from the
authoring bundle name (label); the API name can't exist in the org.
--api-version=<value> Override the api version used for api requests made by this command
--no-spec Skip prompting for an agent spec and use the default Agent Script boilerplate in the
generated authoring bundle.

GLOBAL FLAGS
--flags-dir=<value> Import flag values from a directory.
Expand All @@ -496,7 +498,9 @@ DESCRIPTION

Use this command to generate a new authoring bundle based on an agent spec YAML file, which you create with the "agent
generate agent-spec" command. The agent spec YAML file is a high-level description of the agent; it describes its
essence rather than exactly what it can do.
essence rather than exactly what it can do. The resulting Agent Script file is customized to reflect what's in the
agent spec file. You can also create an authoring bundle without an agent spec file by specifying the "--no-spec"
flag; in this case, the resulting Agent Script file is just the default boilerplate.

The metadata type for authoring bundles is aiAuthoringBundle, which consist of a standard
"<bundle-api-name>.bundle-meta.xml" metadata file and the Agent Script file (with extension ".agent"). When you run
Expand All @@ -516,6 +520,11 @@ EXAMPLES

$ sf agent generate authoring-bundle

Generate an authoring bundle without using an agent spec file; give the bundle the label "My Authoring Bundle" and
use your default org:

$ sf agent generate authoring-bundle --no-spec --name "My Authoring Bundle"

Generate an authoring bundle from the "specs/agentSpec.yaml" agent spec YAML file and give it the label "My
Authoring Bundle"; use your default org:

Expand All @@ -528,7 +537,7 @@ EXAMPLES
other-package-dir/main/default --target-org my-dev-org
```

_See code: [@salesforce/plugin-agent](https://github.com/salesforcecli/plugin-agent/blob/1.27.3/src/commands/agent/generate/authoring-bundle.ts)_
_See code: [@salesforce/plugin-agent](https://github.com/salesforcecli/plugin-agent/blob/1.27.5/src/commands/agent/generate/authoring-bundle.ts)_

## `sf agent generate template`

Expand Down Expand Up @@ -576,7 +585,7 @@ EXAMPLES
force-app/main/default/bots/My_Awesome_Agent/My_Awesome_Agent.bot-meta.xml --agent-version 1
```

_See code: [@salesforce/plugin-agent](https://github.com/salesforcecli/plugin-agent/blob/1.27.3/src/commands/agent/generate/template.ts)_
_See code: [@salesforce/plugin-agent](https://github.com/salesforcecli/plugin-agent/blob/1.27.5/src/commands/agent/generate/template.ts)_

## `sf agent generate test-spec`

Expand Down Expand Up @@ -637,7 +646,7 @@ EXAMPLES
force-app//main/default/aiEvaluationDefinitions/Resort_Manager_Tests.aiEvaluationDefinition-meta.xml
```

_See code: [@salesforce/plugin-agent](https://github.com/salesforcecli/plugin-agent/blob/1.27.3/src/commands/agent/generate/test-spec.ts)_
_See code: [@salesforce/plugin-agent](https://github.com/salesforcecli/plugin-agent/blob/1.27.5/src/commands/agent/generate/test-spec.ts)_

## `sf agent preview`

Expand Down Expand Up @@ -710,7 +719,7 @@ EXAMPLES
$ sf agent preview --use-live-actions --apex-debug --output-dir transcripts/my-preview
```

_See code: [@salesforce/plugin-agent](https://github.com/salesforcecli/plugin-agent/blob/1.27.3/src/commands/agent/preview.ts)_
_See code: [@salesforce/plugin-agent](https://github.com/salesforcecli/plugin-agent/blob/1.27.5/src/commands/agent/preview.ts)_

## `sf agent publish authoring-bundle`

Expand Down Expand Up @@ -759,7 +768,7 @@ EXAMPLES
$ sf agent publish authoring-bundle --api-name MyAuthoringbundle --target-org my-dev-org
```

_See code: [@salesforce/plugin-agent](https://github.com/salesforcecli/plugin-agent/blob/1.27.3/src/commands/agent/publish/authoring-bundle.ts)_
_See code: [@salesforce/plugin-agent](https://github.com/salesforcecli/plugin-agent/blob/1.27.5/src/commands/agent/publish/authoring-bundle.ts)_

## `sf agent test create`

Expand Down Expand Up @@ -814,7 +823,7 @@ EXAMPLES
$ sf agent test create --spec specs/Resort_Manager-testSpec.yaml --api-name Resort_Manager_Test --preview
```

_See code: [@salesforce/plugin-agent](https://github.com/salesforcecli/plugin-agent/blob/1.27.3/src/commands/agent/test/create.ts)_
_See code: [@salesforce/plugin-agent](https://github.com/salesforcecli/plugin-agent/blob/1.27.5/src/commands/agent/test/create.ts)_

## `sf agent test list`

Expand Down Expand Up @@ -849,7 +858,7 @@ EXAMPLES
$ sf agent test list --target-org my-org
```

_See code: [@salesforce/plugin-agent](https://github.com/salesforcecli/plugin-agent/blob/1.27.3/src/commands/agent/test/list.ts)_
_See code: [@salesforce/plugin-agent](https://github.com/salesforcecli/plugin-agent/blob/1.27.5/src/commands/agent/test/list.ts)_

## `sf agent test results`

Expand Down Expand Up @@ -915,7 +924,7 @@ FLAG DESCRIPTIONS
expression when using custom evaluations.
```

_See code: [@salesforce/plugin-agent](https://github.com/salesforcecli/plugin-agent/blob/1.27.3/src/commands/agent/test/results.ts)_
_See code: [@salesforce/plugin-agent](https://github.com/salesforcecli/plugin-agent/blob/1.27.5/src/commands/agent/test/results.ts)_

## `sf agent test resume`

Expand Down Expand Up @@ -988,7 +997,7 @@ FLAG DESCRIPTIONS
expression when using custom evaluations.
```

_See code: [@salesforce/plugin-agent](https://github.com/salesforcecli/plugin-agent/blob/1.27.3/src/commands/agent/test/resume.ts)_
_See code: [@salesforce/plugin-agent](https://github.com/salesforcecli/plugin-agent/blob/1.27.5/src/commands/agent/test/resume.ts)_

## `sf agent test run`

Expand Down Expand Up @@ -1062,7 +1071,7 @@ FLAG DESCRIPTIONS
expression when using custom evaluations.
```

_See code: [@salesforce/plugin-agent](https://github.com/salesforcecli/plugin-agent/blob/1.27.3/src/commands/agent/test/run.ts)_
_See code: [@salesforce/plugin-agent](https://github.com/salesforcecli/plugin-agent/blob/1.27.5/src/commands/agent/test/run.ts)_

## `sf agent validate authoring-bundle`

Expand Down Expand Up @@ -1109,7 +1118,7 @@ EXAMPLES
$ sf agent validate authoring-bundle --api-name MyAuthoringBundle --target-org my-dev-org
```

_See code: [@salesforce/plugin-agent](https://github.com/salesforcecli/plugin-agent/blob/1.27.3/src/commands/agent/validate/authoring-bundle.ts)_
_See code: [@salesforce/plugin-agent](https://github.com/salesforcecli/plugin-agent/blob/1.27.5/src/commands/agent/validate/authoring-bundle.ts)_

## `sf alias list`

Expand Down
6 changes: 3 additions & 3 deletions package.json
Original file line number Diff line number Diff line change
@@ -1,7 +1,7 @@
{
"name": "@salesforce/cli",
"description": "The Salesforce CLI",
"version": "2.122.6",
"version": "2.123.0",
"author": "Salesforce",
"bin": {
"sf": "./bin/run.js",
Expand Down Expand Up @@ -78,7 +78,7 @@
"jitPlugins": {
"@salesforce/plugin-code-analyzer": "5.9.0",
"@salesforce/plugin-community": "3.3.48",
"@salesforce/plugin-custom-metadata": "3.3.73",
"@salesforce/plugin-custom-metadata": "3.3.74",
"@salesforce/plugin-dev": "2.5.1",
"@salesforce/plugin-devops-center": "1.2.27",
"@salesforce/plugin-flow": "1.0.5",
Expand Down Expand Up @@ -157,7 +157,7 @@
"@oclif/plugin-which": "3.2.43",
"@salesforce/core": "^8.25.0",
"@salesforce/kit": "^3.1.6",
"@salesforce/plugin-agent": "1.27.3",
"@salesforce/plugin-agent": "1.27.5",
"@salesforce/plugin-apex": "3.9.5",
"@salesforce/plugin-api": "1.3.8",
"@salesforce/plugin-auth": "4.1.4",
Expand Down
8 changes: 4 additions & 4 deletions yarn.lock
Original file line number Diff line number Diff line change
Expand Up @@ -2208,10 +2208,10 @@
jszip "^3.10.1"
object-treeify "^2"

"@salesforce/plugin-agent@1.27.3":
version "1.27.3"
resolved "https://registry.yarnpkg.com/@salesforce/plugin-agent/-/plugin-agent-1.27.3.tgz#b266378972a69c76af35af65c96e357d03bde53f"
integrity sha512-pzSjZzvpOQXiPApMGy8LXm2Tjd74wwt9rAM4juqwZFcypnmHsqneMsQUSU82kEDR6NMHd2dV9inS2Hbsiv8Muw==
"@salesforce/plugin-agent@1.27.5":
version "1.27.5"
resolved "https://registry.yarnpkg.com/@salesforce/plugin-agent/-/plugin-agent-1.27.5.tgz#bfbd232f75a02931755ee15b629e0a5ea3975072"
integrity sha512-20Yaz+pbcMufQ7xGauWP9M+dn9XBkAHUfx/kRRLEOf+3mOwEkSUIOQ1nfuxOiYqSR9bNB2LPGIJ4l54ADGA4mQ==
dependencies:
"@inquirer/core" "^10.3.2"
"@inquirer/prompts" "^7.10.1"
Expand Down
Loading