@@ -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
428394EXAMPLES
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 -->
0 commit comments