From d15461d6679a72971033b855dd557782bf33aaa7 Mon Sep 17 00:00:00 2001 From: svc-cli-bot Date: Tue, 3 Jun 2025 18:06:38 +0000 Subject: [PATCH] chore(release): bump to 2.92.6 --- README.md | 784 +++++++++++++++++++++++++++++++++++++++++++++++++-- package.json | 6 +- yarn.lock | 47 ++- 3 files changed, 800 insertions(+), 37 deletions(-) diff --git a/README.md b/README.md index bc6dfecfa..31d74a218 100644 --- a/README.md +++ b/README.md @@ -25,7 +25,7 @@ $ npm install -g @salesforce/cli $ sf COMMAND running command... $ sf (--version|-v) -@salesforce/cli/2.92.5 linux-x64 node-v22.16.0 +@salesforce/cli/2.92.6 linux-x64 node-v22.16.0 $ sf --help [COMMAND] USAGE $ sf COMMAND @@ -42,6 +42,16 @@ See [architecture page](ARCHITECTURE.md) for diagrams of the Salesforce CLI. +- [`sf agent create`](#sf-agent-create) +- [`sf agent generate agent-spec`](#sf-agent-generate-agent-spec) +- [`sf agent generate template`](#sf-agent-generate-template) +- [`sf agent generate test-spec`](#sf-agent-generate-test-spec) +- [`sf agent preview`](#sf-agent-preview) +- [`sf agent test create`](#sf-agent-test-create) +- [`sf agent test list`](#sf-agent-test-list) +- [`sf agent test results`](#sf-agent-test-results) +- [`sf agent test resume`](#sf-agent-test-resume) +- [`sf agent test run`](#sf-agent-test-run) - [`sf alias list`](#sf-alias-list) - [`sf alias set`](#sf-alias-set) - [`sf alias unset`](#sf-alias-unset) @@ -124,6 +134,7 @@ See [architecture page](ARCHITECTURE.md) for diagrams of the Salesforce CLI. - [`sf org refresh sandbox`](#sf-org-refresh-sandbox) - [`sf org resume sandbox`](#sf-org-resume-sandbox) - [`sf org resume scratch`](#sf-org-resume-scratch) +- [`sf package convert`](#sf-package-convert) - [`sf package create`](#sf-package-create) - [`sf package delete`](#sf-package-delete) - [`sf package install`](#sf-package-install) @@ -187,6 +198,646 @@ See [architecture page](ARCHITECTURE.md) for diagrams of the Salesforce CLI. - [`sf visualforce generate page`](#sf-visualforce-generate-page) - [`sf which`](#sf-which) +## `sf agent create` + +Create an agent in your org using a local agent spec file. + +``` +USAGE + $ sf agent create -o [--json] [--flags-dir ] [--api-version ] [--name ] [--api-name + ] [--spec ] [--preview] + +FLAGS + -o, --target-org= (required) Username or alias of the target org. Not required if the `target-org` + configuration variable is already set. + --api-name= 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= Override the api version used for api requests made by this command + --name= Name (label) of the new agent. + --preview Preview the agent without saving it in your org. + --spec= Path to an agent spec file. + +GLOBAL FLAGS + --flags-dir= Import flag values from a directory. + --json Format output as json. + +DESCRIPTION + Create an agent in your org using a local agent spec file. + + 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 ". + +EXAMPLES + 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: + + $ sf 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: + + $ sf agent create --name "Resort Manager" --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: + + $ sf agent create --name "Resort Manager" --spec specs/resortManagerAgent.yaml --preview +``` + +_See code: [@salesforce/plugin-agent](https://github.com/salesforcecli/plugin-agent/blob/1.22.7/src/commands/agent/create.ts)_ + +## `sf agent generate agent-spec` + +Generate an agent spec, which is a YAML file that captures what an agent can do. + +``` +USAGE + $ sf agent generate agent-spec -o [--json] [--flags-dir ] [--api-version ] [--type customer|internal] + [--role ] [--company-name ] [--company-description ] [--company-website ] [--max-topics + ] [--agent-user ] [--enrich-logs true|false] [--tone formal|casual|neutral] [--spec ] + [--output-file ] [--full-interview] [--grounding-context --prompt-template ] + [--force-overwrite] + +FLAGS + -o, --target-org= (required) Username or alias of the target org. Not required if the `target-org` + configuration variable is already set. + --agent-user= Username of a user in your org to assign to your agent; determines what your agent + can access and do. + --api-version= Override the api version used for api requests made by this command + --company-description= Description of your company. + --company-name= Name of your company. + --company-website= Website URL of your company. + --enrich-logs=