Skip to content

Commit 547fb62

Browse files
committed
chore(release): 1.23.4 [skip ci]
1 parent cdd32a8 commit 547fb62

File tree

3 files changed

+24
-52
lines changed

3 files changed

+24
-52
lines changed

CHANGELOG.md

Lines changed: 6 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -1,3 +1,9 @@
1+
## [1.23.4](https://github.com/salesforcecli/plugin-agent/compare/1.23.3...1.23.4) (2025-07-23)
2+
3+
### Bug Fixes
4+
5+
- remove configuration steps from "agent preview" help ([#176](https://github.com/salesforcecli/plugin-agent/issues/176)) ([cdd32a8](https://github.com/salesforcecli/plugin-agent/commit/cdd32a88ebced8d7a5f30fa7429462df60cc6969))
6+
17
## [1.23.3](https://github.com/salesforcecli/plugin-agent/compare/1.23.2...1.23.3) (2025-07-13)
28

39
### Bug Fixes

README.md

Lines changed: 17 additions & 51 deletions
Original file line numberDiff line numberDiff line change
@@ -130,7 +130,7 @@ EXAMPLES
130130
$ sf agent create --name "Resort Manager" --spec specs/resortManagerAgent.yaml --preview
131131
```
132132

133-
_See code: [src/commands/agent/create.ts](https://github.com/salesforcecli/plugin-agent/blob/1.23.3/src/commands/agent/create.ts)_
133+
_See code: [src/commands/agent/create.ts](https://github.com/salesforcecli/plugin-agent/blob/1.23.4/src/commands/agent/create.ts)_
134134

135135
## `sf agent generate agent-spec`
136136

@@ -235,7 +235,7 @@ EXAMPLES
235235
$ sf agent generate agent-spec --tone formal --agent-user resortmanager@myorg.com
236236
```
237237

238-
_See code: [src/commands/agent/generate/agent-spec.ts](https://github.com/salesforcecli/plugin-agent/blob/1.23.3/src/commands/agent/generate/agent-spec.ts)_
238+
_See code: [src/commands/agent/generate/agent-spec.ts](https://github.com/salesforcecli/plugin-agent/blob/1.23.4/src/commands/agent/generate/agent-spec.ts)_
239239

240240
## `sf agent generate template`
241241

@@ -283,7 +283,7 @@ EXAMPLES
283283
force-app/main/default/bots/My_Awesome_Agent/My_Awesome_Agent.bot-meta.xml --agent-version 1
284284
```
285285

286-
_See code: [src/commands/agent/generate/template.ts](https://github.com/salesforcecli/plugin-agent/blob/1.23.3/src/commands/agent/generate/template.ts)_
286+
_See code: [src/commands/agent/generate/template.ts](https://github.com/salesforcecli/plugin-agent/blob/1.23.4/src/commands/agent/generate/template.ts)_
287287

288288
## `sf agent generate test-spec`
289289

@@ -341,7 +341,7 @@ EXAMPLES
341341
force-app//main/default/aiEvaluationDefinitions/Resort_Manager_Tests.aiEvaluationDefinition-meta.xml
342342
```
343343

344-
_See code: [src/commands/agent/generate/test-spec.ts](https://github.com/salesforcecli/plugin-agent/blob/1.23.3/src/commands/agent/generate/test-spec.ts)_
344+
_See code: [src/commands/agent/generate/test-spec.ts](https://github.com/salesforcecli/plugin-agent/blob/1.23.4/src/commands/agent/generate/test-spec.ts)_
345345

346346
## `sf agent preview`
347347

@@ -386,59 +386,25 @@ DESCRIPTION
386386
387387
Find the agent's API name in its main details page in your org's Agent page in Setup.
388388
389-
Before you use this command, you must complete these steps:
390-
391-
1. Using your org's Setup UI, create a connected app in your org as described in the "Create a Connected App" section
392-
here: https://developer.salesforce.com/docs/einstein/genai/guide/agent-api-get-started.html#create-a-connected-app. Do
393-
these additional steps:
394-
395-
a. When specifying the connected app's Callback URL, add this second callback URL on a new line:
396-
"http://localhost:1717/OauthRedirect".
397-
398-
b. When adding the scopes to the connected app, add "Manage user data via Web browsers (web)".
399-
400-
2. Add the connected app to your agent as described in the "Add Connected App to Agent" section here:
401-
https://developer.salesforce.com/docs/einstein/genai/guide/agent-api-get-started.html#add-connected-app-to-agent.
402-
403-
3. Copy the consumer key from your connected app as described in the "Obtain Credentials" section here:
404-
https://developer.salesforce.com/docs/einstein/genai/guide/agent-api-get-started.html#obtain-credentials.
405-
406-
4. If you haven't already, run the "org login web" CLI command as usual to authorize the development org that contains
407-
the agent you want to preview.
408-
409-
5. Re-run the "org web login" command to link the new connected app to your already-authenticated user. Use the
410-
--client-app flag to give the link a name; you can specify any string, but make a note of it because you'll need it
411-
later. Use --username to specify the username that you used to log into the org in the previous step. Use --client-id
412-
to specify the consumer key you previously copied. Finally, use --scopes as indicated to specify the required API
413-
scopes. Here's an example:
414-
415-
sf org login web --client-app agent-app --username <username> --client-id <consumer-key> --scopes "sfap_api
416-
chatbot_api refresh_token api web"
417-
418-
IMPORTANT: You must use the "--client-id <CONNECTED-APP-CONSUMER-KEY>" flag of "org login web", where
419-
CONNECTED-APP-CONSUMER-KEY is the consumer key you previously copied. This step ensures that the "org login web"
420-
command uses your custom connected app, and not the default CLI connected app.
421-
422-
6. Press Enter to skip sharing the client secret, then log in with your org username as usual and click Accept.
423-
424-
7. Run this command ("agent preview") to interact with an agent by using the --target-org flag to specify the org
425-
username or alias as usual and --client-app to specify the linked connected app ("agent-app" in the previous example).
426-
Use the "org display" command to get the list of client apps associated with an org.
389+
IMPORTANT: Before you use this command, you must complete a number of configuration steps in your org and your DX
390+
project. The examples in this help assume you've completed the steps. See "Preview an Agent" in the "Agentforce
391+
Developer Guide" for complete documentation:
392+
https://developer.salesforce.com/docs/einstein/genai/guide/agent-dx-preview.html.
427393
428394
EXAMPLES
429395
Interact with an agent with API name "Resort_Manager" in the org with alias "my-org" and the linked "agent-app"
430396
connected app:
431397
432-
$ sf agent preview --api-name "Resort_Manager" --target-org my-org --client-app agent-app
398+
$ sf agent preview --api-name Resort_Manager --target-org my-org --client-app agent-app
433399
434400
Same as the preceding example, but this time save the conversation transcripts to the "./transcripts/my-preview"
435401
directory rather than the default "./temp/agent-preview":
436402
437-
$ sf agent preview --api-name "Resort_Manager" --target-org my-org --client-app agent-app --output-dir \
438-
"transcripts/my-preview"
403+
$ sf agent preview --api-name Resort_Manager --target-org my-org --client-app agent-app --output-dir \
404+
transcripts/my-preview
439405
```
440406

441-
_See code: [src/commands/agent/preview.ts](https://github.com/salesforcecli/plugin-agent/blob/1.23.3/src/commands/agent/preview.ts)_
407+
_See code: [src/commands/agent/preview.ts](https://github.com/salesforcecli/plugin-agent/blob/1.23.4/src/commands/agent/preview.ts)_
442408

443409
## `sf agent test create`
444410

@@ -493,7 +459,7 @@ EXAMPLES
493459
$ sf agent test create --spec specs/Resort_Manager-testSpec.yaml --api-name Resort_Manager_Test --preview
494460
```
495461

496-
_See code: [src/commands/agent/test/create.ts](https://github.com/salesforcecli/plugin-agent/blob/1.23.3/src/commands/agent/test/create.ts)_
462+
_See code: [src/commands/agent/test/create.ts](https://github.com/salesforcecli/plugin-agent/blob/1.23.4/src/commands/agent/test/create.ts)_
497463

498464
## `sf agent test list`
499465

@@ -528,7 +494,7 @@ EXAMPLES
528494
$ sf agent test list --target-org my-org
529495
```
530496

531-
_See code: [src/commands/agent/test/list.ts](https://github.com/salesforcecli/plugin-agent/blob/1.23.3/src/commands/agent/test/list.ts)_
497+
_See code: [src/commands/agent/test/list.ts](https://github.com/salesforcecli/plugin-agent/blob/1.23.4/src/commands/agent/test/list.ts)_
532498

533499
## `sf agent test results`
534500

@@ -584,7 +550,7 @@ FLAG DESCRIPTIONS
584550
test results aren't written.
585551
```
586552

587-
_See code: [src/commands/agent/test/results.ts](https://github.com/salesforcecli/plugin-agent/blob/1.23.3/src/commands/agent/test/results.ts)_
553+
_See code: [src/commands/agent/test/results.ts](https://github.com/salesforcecli/plugin-agent/blob/1.23.4/src/commands/agent/test/results.ts)_
588554

589555
## `sf agent test resume`
590556

@@ -647,7 +613,7 @@ FLAG DESCRIPTIONS
647613
test results aren't written.
648614
```
649615

650-
_See code: [src/commands/agent/test/resume.ts](https://github.com/salesforcecli/plugin-agent/blob/1.23.3/src/commands/agent/test/resume.ts)_
616+
_See code: [src/commands/agent/test/resume.ts](https://github.com/salesforcecli/plugin-agent/blob/1.23.4/src/commands/agent/test/resume.ts)_
651617

652618
## `sf agent test run`
653619

@@ -711,6 +677,6 @@ FLAG DESCRIPTIONS
711677
test results aren't written.
712678
```
713679

714-
_See code: [src/commands/agent/test/run.ts](https://github.com/salesforcecli/plugin-agent/blob/1.23.3/src/commands/agent/test/run.ts)_
680+
_See code: [src/commands/agent/test/run.ts](https://github.com/salesforcecli/plugin-agent/blob/1.23.4/src/commands/agent/test/run.ts)_
715681

716682
<!-- commandsstop -->

package.json

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,7 +1,7 @@
11
{
22
"name": "@salesforce/plugin-agent",
33
"description": "Commands to interact with Salesforce agents",
4-
"version": "1.23.3",
4+
"version": "1.23.4",
55
"author": "Salesforce",
66
"bugs": "https://github.com/forcedotcom/cli/issues",
77
"dependencies": {

0 commit comments

Comments
 (0)