@salesforce/plugin-agent 1.27.2 → 1.27.4-preview.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +33 -17
- package/lib/commands/agent/generate/template.js.map +1 -1
- package/lib/commands/agent/preview.d.ts +7 -2
- package/lib/commands/agent/preview.js +39 -2
- package/lib/commands/agent/preview.js.map +1 -1
- package/messages/agent.preview.md +28 -0
- package/oclif.manifest.json +116 -93
- package/package.json +7 -7
- package/schemas/agent-preview.json +11 -1
package/README.md
CHANGED
|
@@ -112,7 +112,7 @@ EXAMPLES
|
|
|
112
112
|
$ sf agent activate --api-name Resort_Manager --target-org my-org
|
|
113
113
|
```
|
|
114
114
|
|
|
115
|
-
_See code: [src/commands/agent/activate.ts](https://github.com/salesforcecli/plugin-agent/blob/1.27.
|
|
115
|
+
_See code: [src/commands/agent/activate.ts](https://github.com/salesforcecli/plugin-agent/blob/1.27.4-preview.0/src/commands/agent/activate.ts)_
|
|
116
116
|
|
|
117
117
|
## `sf agent create`
|
|
118
118
|
|
|
@@ -179,7 +179,7 @@ EXAMPLES
|
|
|
179
179
|
$ sf agent create --name "Resort Manager" --spec specs/resortManagerAgent.yaml --preview
|
|
180
180
|
```
|
|
181
181
|
|
|
182
|
-
_See code: [src/commands/agent/create.ts](https://github.com/salesforcecli/plugin-agent/blob/1.27.
|
|
182
|
+
_See code: [src/commands/agent/create.ts](https://github.com/salesforcecli/plugin-agent/blob/1.27.4-preview.0/src/commands/agent/create.ts)_
|
|
183
183
|
|
|
184
184
|
## `sf agent deactivate`
|
|
185
185
|
|
|
@@ -219,7 +219,7 @@ EXAMPLES
|
|
|
219
219
|
$ sf agent deactivate --api-name Resort_Manager --target-org my-org
|
|
220
220
|
```
|
|
221
221
|
|
|
222
|
-
_See code: [src/commands/agent/deactivate.ts](https://github.com/salesforcecli/plugin-agent/blob/1.27.
|
|
222
|
+
_See code: [src/commands/agent/deactivate.ts](https://github.com/salesforcecli/plugin-agent/blob/1.27.4-preview.0/src/commands/agent/deactivate.ts)_
|
|
223
223
|
|
|
224
224
|
## `sf agent generate agent-spec`
|
|
225
225
|
|
|
@@ -326,7 +326,7 @@ EXAMPLES
|
|
|
326
326
|
$ sf agent generate agent-spec --tone formal --agent-user resortmanager@myorg.com
|
|
327
327
|
```
|
|
328
328
|
|
|
329
|
-
_See code: [src/commands/agent/generate/agent-spec.ts](https://github.com/salesforcecli/plugin-agent/blob/1.27.
|
|
329
|
+
_See code: [src/commands/agent/generate/agent-spec.ts](https://github.com/salesforcecli/plugin-agent/blob/1.27.4-preview.0/src/commands/agent/generate/agent-spec.ts)_
|
|
330
330
|
|
|
331
331
|
## `sf agent generate authoring-bundle`
|
|
332
332
|
|
|
@@ -392,7 +392,7 @@ EXAMPLES
|
|
|
392
392
|
other-package-dir/main/default --target-org my-dev-org
|
|
393
393
|
```
|
|
394
394
|
|
|
395
|
-
_See code: [src/commands/agent/generate/authoring-bundle.ts](https://github.com/salesforcecli/plugin-agent/blob/1.27.
|
|
395
|
+
_See code: [src/commands/agent/generate/authoring-bundle.ts](https://github.com/salesforcecli/plugin-agent/blob/1.27.4-preview.0/src/commands/agent/generate/authoring-bundle.ts)_
|
|
396
396
|
|
|
397
397
|
## `sf agent generate template`
|
|
398
398
|
|
|
@@ -440,7 +440,7 @@ EXAMPLES
|
|
|
440
440
|
force-app/main/default/bots/My_Awesome_Agent/My_Awesome_Agent.bot-meta.xml --agent-version 1
|
|
441
441
|
```
|
|
442
442
|
|
|
443
|
-
_See code: [src/commands/agent/generate/template.ts](https://github.com/salesforcecli/plugin-agent/blob/1.27.
|
|
443
|
+
_See code: [src/commands/agent/generate/template.ts](https://github.com/salesforcecli/plugin-agent/blob/1.27.4-preview.0/src/commands/agent/generate/template.ts)_
|
|
444
444
|
|
|
445
445
|
## `sf agent generate test-spec`
|
|
446
446
|
|
|
@@ -501,7 +501,7 @@ EXAMPLES
|
|
|
501
501
|
force-app//main/default/aiEvaluationDefinitions/Resort_Manager_Tests.aiEvaluationDefinition-meta.xml
|
|
502
502
|
```
|
|
503
503
|
|
|
504
|
-
_See code: [src/commands/agent/generate/test-spec.ts](https://github.com/salesforcecli/plugin-agent/blob/1.27.
|
|
504
|
+
_See code: [src/commands/agent/generate/test-spec.ts](https://github.com/salesforcecli/plugin-agent/blob/1.27.4-preview.0/src/commands/agent/generate/test-spec.ts)_
|
|
505
505
|
|
|
506
506
|
## `sf agent preview`
|
|
507
507
|
|
|
@@ -509,8 +509,8 @@ Interact with an agent to preview how it responds to your statements, questions,
|
|
|
509
509
|
|
|
510
510
|
```
|
|
511
511
|
USAGE
|
|
512
|
-
$ sf agent preview -o <value> [--flags-dir <value>] [--api-version <value>] [-n <value>]
|
|
513
|
-
<value>] [-d <value>] [-x] [--use-live-actions]
|
|
512
|
+
$ sf agent preview -o <value> [--json] [--flags-dir <value>] [--api-version <value>] [-n <value>]
|
|
513
|
+
[--authoring-bundle <value>] [-d <value>] [-x] [--use-live-actions] [--utterance <value>] [--session-id <value>]
|
|
514
514
|
|
|
515
515
|
FLAGS
|
|
516
516
|
-d, --output-dir=<value> Directory where conversation transcripts are saved.
|
|
@@ -521,11 +521,16 @@ FLAGS
|
|
|
521
521
|
--api-version=<value> Override the api version used for api requests made by this command
|
|
522
522
|
--authoring-bundle=<value> API name of the authoring bundle metadata component that contains the agent's Agent
|
|
523
523
|
Script file.
|
|
524
|
+
--session-id=<value> Session ID of an in-progress preview session; use with --utterance to send a message
|
|
525
|
+
to that session and return the response without starting the interactive preview.
|
|
524
526
|
--use-live-actions Use real actions in the org; if not specified, preview uses AI to simulate (mock)
|
|
525
527
|
actions.
|
|
528
|
+
--utterance=<value> Message to send to the agent; creates a new session, returns the response, and exits
|
|
529
|
+
without starting the interactive preview.
|
|
526
530
|
|
|
527
531
|
GLOBAL FLAGS
|
|
528
532
|
--flags-dir=<value> Import flag values from a directory.
|
|
533
|
+
--json Format output as json.
|
|
529
534
|
|
|
530
535
|
DESCRIPTION
|
|
531
536
|
Interact with an agent to preview how it responds to your statements, questions, and commands (utterances).
|
|
@@ -572,9 +577,20 @@ EXAMPLES
|
|
|
572
577
|
"./transcripts/my-preview" directory, enable the Apex debug logs, and use your default org:
|
|
573
578
|
|
|
574
579
|
$ sf agent preview --use-live-actions --apex-debug --output-dir transcripts/my-preview
|
|
580
|
+
|
|
581
|
+
Send a message to the agent and print the response without starting the interactive preview (requires --api-name or
|
|
582
|
+
--authoring-bundle):
|
|
583
|
+
|
|
584
|
+
$ sf agent preview --authoring-bundle My_Agent_Bundle --utterance "What can you help me with?" --target-org \
|
|
585
|
+
my-dev-org
|
|
586
|
+
|
|
587
|
+
Send a follow-up message to an existing preview session:
|
|
588
|
+
|
|
589
|
+
$ sf agent preview --authoring-bundle My_Agent_Bundle --session-id <session-id> --utterance "Tell me more" \
|
|
590
|
+
--target-org my-dev-org
|
|
575
591
|
```
|
|
576
592
|
|
|
577
|
-
_See code: [src/commands/agent/preview.ts](https://github.com/salesforcecli/plugin-agent/blob/1.27.
|
|
593
|
+
_See code: [src/commands/agent/preview.ts](https://github.com/salesforcecli/plugin-agent/blob/1.27.4-preview.0/src/commands/agent/preview.ts)_
|
|
578
594
|
|
|
579
595
|
## `sf agent publish authoring-bundle`
|
|
580
596
|
|
|
@@ -623,7 +639,7 @@ EXAMPLES
|
|
|
623
639
|
$ sf agent publish authoring-bundle --api-name MyAuthoringbundle --target-org my-dev-org
|
|
624
640
|
```
|
|
625
641
|
|
|
626
|
-
_See code: [src/commands/agent/publish/authoring-bundle.ts](https://github.com/salesforcecli/plugin-agent/blob/1.27.
|
|
642
|
+
_See code: [src/commands/agent/publish/authoring-bundle.ts](https://github.com/salesforcecli/plugin-agent/blob/1.27.4-preview.0/src/commands/agent/publish/authoring-bundle.ts)_
|
|
627
643
|
|
|
628
644
|
## `sf agent test create`
|
|
629
645
|
|
|
@@ -678,7 +694,7 @@ EXAMPLES
|
|
|
678
694
|
$ sf agent test create --spec specs/Resort_Manager-testSpec.yaml --api-name Resort_Manager_Test --preview
|
|
679
695
|
```
|
|
680
696
|
|
|
681
|
-
_See code: [src/commands/agent/test/create.ts](https://github.com/salesforcecli/plugin-agent/blob/1.27.
|
|
697
|
+
_See code: [src/commands/agent/test/create.ts](https://github.com/salesforcecli/plugin-agent/blob/1.27.4-preview.0/src/commands/agent/test/create.ts)_
|
|
682
698
|
|
|
683
699
|
## `sf agent test list`
|
|
684
700
|
|
|
@@ -713,7 +729,7 @@ EXAMPLES
|
|
|
713
729
|
$ sf agent test list --target-org my-org
|
|
714
730
|
```
|
|
715
731
|
|
|
716
|
-
_See code: [src/commands/agent/test/list.ts](https://github.com/salesforcecli/plugin-agent/blob/1.27.
|
|
732
|
+
_See code: [src/commands/agent/test/list.ts](https://github.com/salesforcecli/plugin-agent/blob/1.27.4-preview.0/src/commands/agent/test/list.ts)_
|
|
717
733
|
|
|
718
734
|
## `sf agent test results`
|
|
719
735
|
|
|
@@ -779,7 +795,7 @@ FLAG DESCRIPTIONS
|
|
|
779
795
|
expression when using custom evaluations.
|
|
780
796
|
```
|
|
781
797
|
|
|
782
|
-
_See code: [src/commands/agent/test/results.ts](https://github.com/salesforcecli/plugin-agent/blob/1.27.
|
|
798
|
+
_See code: [src/commands/agent/test/results.ts](https://github.com/salesforcecli/plugin-agent/blob/1.27.4-preview.0/src/commands/agent/test/results.ts)_
|
|
783
799
|
|
|
784
800
|
## `sf agent test resume`
|
|
785
801
|
|
|
@@ -852,7 +868,7 @@ FLAG DESCRIPTIONS
|
|
|
852
868
|
expression when using custom evaluations.
|
|
853
869
|
```
|
|
854
870
|
|
|
855
|
-
_See code: [src/commands/agent/test/resume.ts](https://github.com/salesforcecli/plugin-agent/blob/1.27.
|
|
871
|
+
_See code: [src/commands/agent/test/resume.ts](https://github.com/salesforcecli/plugin-agent/blob/1.27.4-preview.0/src/commands/agent/test/resume.ts)_
|
|
856
872
|
|
|
857
873
|
## `sf agent test run`
|
|
858
874
|
|
|
@@ -926,7 +942,7 @@ FLAG DESCRIPTIONS
|
|
|
926
942
|
expression when using custom evaluations.
|
|
927
943
|
```
|
|
928
944
|
|
|
929
|
-
_See code: [src/commands/agent/test/run.ts](https://github.com/salesforcecli/plugin-agent/blob/1.27.
|
|
945
|
+
_See code: [src/commands/agent/test/run.ts](https://github.com/salesforcecli/plugin-agent/blob/1.27.4-preview.0/src/commands/agent/test/run.ts)_
|
|
930
946
|
|
|
931
947
|
## `sf agent validate authoring-bundle`
|
|
932
948
|
|
|
@@ -973,6 +989,6 @@ EXAMPLES
|
|
|
973
989
|
$ sf agent validate authoring-bundle --api-name MyAuthoringBundle --target-org my-dev-org
|
|
974
990
|
```
|
|
975
991
|
|
|
976
|
-
_See code: [src/commands/agent/validate/authoring-bundle.ts](https://github.com/salesforcecli/plugin-agent/blob/1.27.
|
|
992
|
+
_See code: [src/commands/agent/validate/authoring-bundle.ts](https://github.com/salesforcecli/plugin-agent/blob/1.27.4-preview.0/src/commands/agent/validate/authoring-bundle.ts)_
|
|
977
993
|
|
|
978
994
|
<!-- commandsstop -->
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"template.js","sourceRoot":"","sources":["../../../../src/commands/agent/generate/template.ts"],"names":[],"mappings":"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
|
|
1
|
+
{"version":3,"file":"template.js","sourceRoot":"","sources":["../../../../src/commands/agent/generate/template.ts"],"names":[],"mappings":"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"}
|
|
@@ -10,12 +10,15 @@ export type AgentData = {
|
|
|
10
10
|
};
|
|
11
11
|
};
|
|
12
12
|
export declare const UNSUPPORTED_AGENTS: string[];
|
|
13
|
-
export type AgentPreviewResult =
|
|
13
|
+
export type AgentPreviewResult = {
|
|
14
|
+
sessionId: string;
|
|
15
|
+
response: string;
|
|
16
|
+
};
|
|
14
17
|
export default class AgentPreview extends SfCommand<AgentPreviewResult> {
|
|
15
18
|
static readonly summary: string;
|
|
16
19
|
static readonly description: string;
|
|
17
20
|
static readonly examples: string[];
|
|
18
|
-
static readonly enableJsonFlag =
|
|
21
|
+
static readonly enableJsonFlag = true;
|
|
19
22
|
static readonly requiresProject = true;
|
|
20
23
|
static readonly flags: {
|
|
21
24
|
'target-org': import("@oclif/core/interfaces").OptionFlag<import("@salesforce/core").Org, import("@oclif/core/interfaces").CustomOptions>;
|
|
@@ -25,6 +28,8 @@ export default class AgentPreview extends SfCommand<AgentPreviewResult> {
|
|
|
25
28
|
'output-dir': import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
|
|
26
29
|
'apex-debug': import("@oclif/core/interfaces").BooleanFlag<boolean>;
|
|
27
30
|
'use-live-actions': import("@oclif/core/interfaces").BooleanFlag<boolean>;
|
|
31
|
+
utterance: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
|
|
32
|
+
'session-id': import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
|
|
28
33
|
};
|
|
29
34
|
run(): Promise<AgentPreviewResult>;
|
|
30
35
|
}
|
|
@@ -29,7 +29,7 @@ export default class AgentPreview extends SfCommand {
|
|
|
29
29
|
static summary = messages.getMessage('summary');
|
|
30
30
|
static description = messages.getMessage('description');
|
|
31
31
|
static examples = messages.getMessages('examples');
|
|
32
|
-
static enableJsonFlag =
|
|
32
|
+
static enableJsonFlag = true;
|
|
33
33
|
static requiresProject = true;
|
|
34
34
|
static flags = {
|
|
35
35
|
'target-org': Flags.requiredOrg(),
|
|
@@ -53,14 +53,27 @@ export default class AgentPreview extends SfCommand {
|
|
|
53
53
|
summary: messages.getMessage('flags.use-live-actions.summary'),
|
|
54
54
|
default: false,
|
|
55
55
|
}),
|
|
56
|
+
utterance: Flags.string({
|
|
57
|
+
summary: messages.getMessage('flags.utterance.summary'),
|
|
58
|
+
}),
|
|
59
|
+
'session-id': Flags.string({
|
|
60
|
+
summary: messages.getMessage('flags.session-id.summary'),
|
|
61
|
+
}),
|
|
56
62
|
};
|
|
63
|
+
// eslint-disable-next-line complexity
|
|
57
64
|
async run() {
|
|
58
65
|
// STAGES OF PREVIEW
|
|
59
66
|
// get user's agent selection either from flags, or interaction
|
|
60
67
|
// if .agent selected, use the AgentSimulate class to preview
|
|
61
68
|
// if published agent, use AgentPreview for preview
|
|
62
69
|
const { flags } = await this.parse(AgentPreview);
|
|
63
|
-
const { 'api-name': apiNameOrId, 'use-live-actions': useLiveActions, 'authoring-bundle': aabName } = flags;
|
|
70
|
+
const { 'api-name': apiNameOrId, 'use-live-actions': useLiveActions, 'authoring-bundle': aabName, utterance, 'session-id': sessionId, } = flags;
|
|
71
|
+
if (sessionId && !utterance) {
|
|
72
|
+
throw new SfError(messages.getMessage('error.sessionIdRequiresUtterance'), 'SessionIdRequiresUtterance');
|
|
73
|
+
}
|
|
74
|
+
if (utterance && !aabName && !apiNameOrId) {
|
|
75
|
+
throw new SfError(messages.getMessage('error.utteranceRequiresAgent'), 'UtteranceRequiresAgent');
|
|
76
|
+
}
|
|
64
77
|
const conn = flags['target-org'].getConnection(flags['api-version']);
|
|
65
78
|
let selectedAgent;
|
|
66
79
|
if (aabName) {
|
|
@@ -105,6 +118,28 @@ export default class AgentPreview extends SfCommand {
|
|
|
105
118
|
// Otherwise, let user decide when exiting
|
|
106
119
|
const outputDir = flags['output-dir'] ? resolve(flags['output-dir']) : undefined;
|
|
107
120
|
selectedAgent.preview.setApexDebugging(flags['apex-debug']);
|
|
121
|
+
if (utterance) {
|
|
122
|
+
// Non-interactive: send message and return response
|
|
123
|
+
if (sessionId) {
|
|
124
|
+
// @ts-expect-error - access protected member here
|
|
125
|
+
selectedAgent.sessionId = sessionId;
|
|
126
|
+
const response = await selectedAgent.preview.send(utterance);
|
|
127
|
+
const responseMessage = response.messages[0]?.message ?? '';
|
|
128
|
+
if (!this.jsonEnabled()) {
|
|
129
|
+
this.log(responseMessage);
|
|
130
|
+
}
|
|
131
|
+
return { sessionId, response: responseMessage };
|
|
132
|
+
}
|
|
133
|
+
// New session: start, send, end
|
|
134
|
+
const session = await selectedAgent.preview.start();
|
|
135
|
+
const response = await selectedAgent.preview.send(utterance);
|
|
136
|
+
const responseMessage = response.messages[0]?.message ?? '';
|
|
137
|
+
if (!this.jsonEnabled()) {
|
|
138
|
+
this.log(messages.getMessage('output.sessionId', [session.sessionId]));
|
|
139
|
+
this.log(responseMessage);
|
|
140
|
+
}
|
|
141
|
+
return { sessionId: session.sessionId, response: responseMessage };
|
|
142
|
+
}
|
|
108
143
|
const instance = render(React.createElement(AgentPreviewReact, {
|
|
109
144
|
agent: selectedAgent.preview,
|
|
110
145
|
name: selectedAgent.name ?? '',
|
|
@@ -112,6 +147,8 @@ export default class AgentPreview extends SfCommand {
|
|
|
112
147
|
isLocalAgent: selectedAgent instanceof ScriptAgent,
|
|
113
148
|
}), { exitOnCtrlC: false });
|
|
114
149
|
await instance.waitUntilExit();
|
|
150
|
+
// Interactive mode: return empty result for --json (non-interactive --utterance returns sessionId/response)
|
|
151
|
+
return { sessionId: '', response: '' };
|
|
115
152
|
}
|
|
116
153
|
}
|
|
117
154
|
export const agentIsUnsupported = (devName) => UNSUPPORTED_AGENTS.includes(devName);
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"preview.js","sourceRoot":"","sources":["../../../src/commands/agent/preview.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,KAAK,EAAE,SAAS,EAAE,MAAM,6BAA6B,CAAC;AAC/D,OAAO,KAAK,MAAM,OAAO,CAAC;AAC1B,OAAO,EAAE,MAAM,EAAE,MAAM,KAAK,CAAC;AAC7B,OAAO,EAAE,KAAK,EAAE,WAAW,EAAoB,eAAe,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AACxG,OAAO,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAC;AAC3C,OAAO,EAAE,SAAS,EAAE,QAAQ,EAAE,OAAO,EAAE,MAAM,kBAAkB,CAAC;AAChE,OAAO,EAAE,iBAAiB,EAAE,MAAM,yCAAyC,CAAC;AAE5E,QAAQ,CAAC,kCAAkC,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AAC7D,MAAM,QAAQ,GAAG,QAAQ,CAAC,YAAY,CAAC,0BAA0B,EAAE,eAAe,CAAC,CAAC;AAYpF,sGAAsG;AACtG,MAAM,CAAC,MAAM,kBAAkB,GAAG,CAAC,wBAAwB,CAAC,CAAC;
|
|
1
|
+
{"version":3,"file":"preview.js","sourceRoot":"","sources":["../../../src/commands/agent/preview.ts"],"names":[],"mappings":"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"}
|
|
@@ -39,6 +39,26 @@ Use real actions in the org; if not specified, preview uses AI to simulate (mock
|
|
|
39
39
|
|
|
40
40
|
Enable Apex debug logging during the agent preview conversation.
|
|
41
41
|
|
|
42
|
+
# flags.utterance.summary
|
|
43
|
+
|
|
44
|
+
Message to send to the agent; creates a new session, returns the response, and exits without starting the interactive preview.
|
|
45
|
+
|
|
46
|
+
# flags.session-id.summary
|
|
47
|
+
|
|
48
|
+
Session ID of an in-progress preview session; use with --utterance to send a message to that session and return the response without starting the interactive preview.
|
|
49
|
+
|
|
50
|
+
# error.sessionIdRequiresUtterance
|
|
51
|
+
|
|
52
|
+
When using --session-id, you must also specify --utterance.
|
|
53
|
+
|
|
54
|
+
# error.utteranceRequiresAgent
|
|
55
|
+
|
|
56
|
+
When using --utterance, specify the agent with --api-name or --authoring-bundle.
|
|
57
|
+
|
|
58
|
+
# output.sessionId
|
|
59
|
+
|
|
60
|
+
Session ID: %s
|
|
61
|
+
|
|
42
62
|
# examples
|
|
43
63
|
|
|
44
64
|
- Preview an agent by choosing from the list of available local Agent Script or published agents. If previewing a local Agent Script agent, use simulated mode. Use the org with alias "my-dev-org".
|
|
@@ -48,3 +68,11 @@ Enable Apex debug logging during the agent preview conversation.
|
|
|
48
68
|
- Preview an agent in live mode by choosing from a list of authoring bundles. Save the conversation transcripts to the "./transcripts/my-preview" directory, enable the Apex debug logs, and use your default org:
|
|
49
69
|
|
|
50
70
|
<%= config.bin %> <%= command.id %> --use-live-actions --apex-debug --output-dir transcripts/my-preview
|
|
71
|
+
|
|
72
|
+
- Send a message to the agent and print the response without starting the interactive preview (requires --api-name or --authoring-bundle):
|
|
73
|
+
|
|
74
|
+
<%= config.bin %> <%= command.id %> --authoring-bundle My_Agent_Bundle --utterance "What can you help me with?" --target-org my-dev-org
|
|
75
|
+
|
|
76
|
+
- Send a follow-up message to an existing preview session:
|
|
77
|
+
|
|
78
|
+
<%= config.bin %> <%= command.id %> --authoring-bundle My_Agent_Bundle --session-id <session-id> --utterance "Tell me more" --target-org my-dev-org
|
package/oclif.manifest.json
CHANGED
|
@@ -251,9 +251,18 @@
|
|
|
251
251
|
"description": "Use this command to have a natural language conversation with an agent, either while you code its local Agent Script file or when it's published to an org. Previewing an agent acts like an initial test to make sure it responds to your utterances as you expect. For example, you can test that the agent uses a particular topic when asked a question, and then whether it invokes the correct action associated with that topic. This command is the CLI-equivalent of the Preview panel in your org's Agentforce Builder UI.\n\nRun without flags, this command provides a list of agents to preview, divided into two categories: \"Agent Script\", which are agents that have a local authoring bundle in your DX project, or \"Published\", which are agents that are published and activated in your org. Authoring bundles contain an agent's Agent Script file. You then choose the agent you want to preview from the list. Or you can use the --authoring-bundle flag to specify a local authoring bundle's API name or --api-name to specify an activated published agent.\n\nWhen previewing an agent from its Agent Script file, you can use these two modes:\n\n- Simulated mode (Default): Uses only the Agent Script file to converse, and it simulates (mocks) all the actions. Use this mode if none of the Apex classes, flows, or prompt templates that implement your actions are available yet. The LLM uses the information about topics in the Agent Script file to simulate what the action does or how it responds.\n- Live mode: Uses the actual Apex classes, flows, and prompt templates in your development org in the agent preview. If you've changed the Apex classe, flows, or prompt templates in your local DX project, then you must deploy them to your development org if you want to use them in your live preview.\n\nYou can use the Apex Replay Debugger to debug your Apex classes when using live mode for Agent Script files and for activated published agents; specify the --apex-debug flag.\n\nOnce connected to your agent, the preview interface is simple: in the \"Start typing...\" prompt, enter a statement, question, or command; when you're done, enter Return. Your utterance is posted on the right along with a timestamp. The agent then responds on the left. To exit the conversation, hit ESC or Control+C.\n\nWhen the session concludes, the command asks if you want to save the API responses and chat transcripts. By default, the files are saved to the \"./temp/agent-preview\" directory. Specify a new default directory with the --output-dir flag.",
|
|
252
252
|
"examples": [
|
|
253
253
|
"Preview an agent by choosing from the list of available local Agent Script or published agents. If previewing a local Agent Script agent, use simulated mode. Use the org with alias \"my-dev-org\".\n<%= config.bin %> <%= command.id %> --target-org my-dev-org",
|
|
254
|
-
"Preview an agent in live mode by choosing from a list of authoring bundles. Save the conversation transcripts to the \"./transcripts/my-preview\" directory, enable the Apex debug logs, and use your default org:\n<%= config.bin %> <%= command.id %> --use-live-actions --apex-debug --output-dir transcripts/my-preview"
|
|
254
|
+
"Preview an agent in live mode by choosing from a list of authoring bundles. Save the conversation transcripts to the \"./transcripts/my-preview\" directory, enable the Apex debug logs, and use your default org:\n<%= config.bin %> <%= command.id %> --use-live-actions --apex-debug --output-dir transcripts/my-preview",
|
|
255
|
+
"Send a message to the agent and print the response without starting the interactive preview (requires --api-name or --authoring-bundle):\n<%= config.bin %> <%= command.id %> --authoring-bundle My_Agent_Bundle --utterance \"What can you help me with?\" --target-org my-dev-org",
|
|
256
|
+
"Send a follow-up message to an existing preview session:\n<%= config.bin %> <%= command.id %> --authoring-bundle My_Agent_Bundle --session-id <session-id> --utterance \"Tell me more\" --target-org my-dev-org"
|
|
255
257
|
],
|
|
256
258
|
"flags": {
|
|
259
|
+
"json": {
|
|
260
|
+
"description": "Format output as json.",
|
|
261
|
+
"helpGroup": "GLOBAL",
|
|
262
|
+
"name": "json",
|
|
263
|
+
"allowNo": false,
|
|
264
|
+
"type": "boolean"
|
|
265
|
+
},
|
|
257
266
|
"flags-dir": {
|
|
258
267
|
"helpGroup": "GLOBAL",
|
|
259
268
|
"name": "flags-dir",
|
|
@@ -314,6 +323,20 @@
|
|
|
314
323
|
"summary": "Use real actions in the org; if not specified, preview uses AI to simulate (mock) actions.",
|
|
315
324
|
"allowNo": false,
|
|
316
325
|
"type": "boolean"
|
|
326
|
+
},
|
|
327
|
+
"utterance": {
|
|
328
|
+
"name": "utterance",
|
|
329
|
+
"summary": "Message to send to the agent; creates a new session, returns the response, and exits without starting the interactive preview.",
|
|
330
|
+
"hasDynamicHelp": false,
|
|
331
|
+
"multiple": false,
|
|
332
|
+
"type": "option"
|
|
333
|
+
},
|
|
334
|
+
"session-id": {
|
|
335
|
+
"name": "session-id",
|
|
336
|
+
"summary": "Session ID of an in-progress preview session; use with --utterance to send a message to that session and return the response without starting the interactive preview.",
|
|
337
|
+
"hasDynamicHelp": false,
|
|
338
|
+
"multiple": false,
|
|
339
|
+
"type": "option"
|
|
317
340
|
}
|
|
318
341
|
},
|
|
319
342
|
"hasDynamicHelp": true,
|
|
@@ -324,7 +347,7 @@
|
|
|
324
347
|
"pluginType": "core",
|
|
325
348
|
"strict": true,
|
|
326
349
|
"summary": "Interact with an agent to preview how it responds to your statements, questions, and commands (utterances).",
|
|
327
|
-
"enableJsonFlag":
|
|
350
|
+
"enableJsonFlag": true,
|
|
328
351
|
"requiresProject": true,
|
|
329
352
|
"isESM": true,
|
|
330
353
|
"relativePath": [
|
|
@@ -794,96 +817,6 @@
|
|
|
794
817
|
"test-spec:generate:agent"
|
|
795
818
|
]
|
|
796
819
|
},
|
|
797
|
-
"agent:publish:authoring-bundle": {
|
|
798
|
-
"aliases": [],
|
|
799
|
-
"args": {},
|
|
800
|
-
"description": "An authoring bundle is a metadata type (named aiAuthoringBundle) that provides the blueprint for an agent. The metadata type contains two files: the standard metatada XML file and an Agent Script file (extension \".agent\") that fully describes the agent using the Agent Script language.\n\nWhen you publish an authoring bundle to your org, a number of things happen. First, this command validates that the Agent Script file successfully compiles. If there are compilation errors, the command exits and you must fix the Agent Script file to continue. Once the Agent Script file compiles, then it's published to the org, which in turn creates new associated metadata (Bot, BotVersion, GenAiX), or new versions of the metadata if the agent already exists. The new or updated metadata is retrieved back to your DX project; specify the --skip-retrieve flag to skip this step. Finally, the authoring bundle metadata (AiAuthoringBundle) is deployed to your org.\n\nThis command uses the API name of the authoring bundle.",
|
|
801
|
-
"examples": [
|
|
802
|
-
"Publish an authoring bundle by being prompted for its API name; use your default org:\n<%= config.bin %> <%= command.id %>",
|
|
803
|
-
"Publish an authoring bundle with API name MyAuthoringBundle to the org with alias \"my-dev-org\":\n<%= config.bin %> <%= command.id %> --api-name MyAuthoringbundle --target-org my-dev-org"
|
|
804
|
-
],
|
|
805
|
-
"flags": {
|
|
806
|
-
"json": {
|
|
807
|
-
"description": "Format output as json.",
|
|
808
|
-
"helpGroup": "GLOBAL",
|
|
809
|
-
"name": "json",
|
|
810
|
-
"allowNo": false,
|
|
811
|
-
"type": "boolean"
|
|
812
|
-
},
|
|
813
|
-
"flags-dir": {
|
|
814
|
-
"helpGroup": "GLOBAL",
|
|
815
|
-
"name": "flags-dir",
|
|
816
|
-
"summary": "Import flag values from a directory.",
|
|
817
|
-
"hasDynamicHelp": false,
|
|
818
|
-
"multiple": false,
|
|
819
|
-
"type": "option"
|
|
820
|
-
},
|
|
821
|
-
"target-org": {
|
|
822
|
-
"char": "o",
|
|
823
|
-
"name": "target-org",
|
|
824
|
-
"noCacheDefault": true,
|
|
825
|
-
"required": true,
|
|
826
|
-
"summary": "Username or alias of the target org. Not required if the `target-org` configuration variable is already set.",
|
|
827
|
-
"hasDynamicHelp": true,
|
|
828
|
-
"multiple": false,
|
|
829
|
-
"type": "option"
|
|
830
|
-
},
|
|
831
|
-
"api-version": {
|
|
832
|
-
"description": "Override the api version used for api requests made by this command",
|
|
833
|
-
"name": "api-version",
|
|
834
|
-
"hasDynamicHelp": false,
|
|
835
|
-
"multiple": false,
|
|
836
|
-
"type": "option"
|
|
837
|
-
},
|
|
838
|
-
"api-name": {
|
|
839
|
-
"char": "n",
|
|
840
|
-
"name": "api-name",
|
|
841
|
-
"summary": "API name of the authoring bundle you want to publish; if not specified, the command provides a list that you can choose from.",
|
|
842
|
-
"hasDynamicHelp": false,
|
|
843
|
-
"multiple": false,
|
|
844
|
-
"type": "option"
|
|
845
|
-
},
|
|
846
|
-
"skip-retrieve": {
|
|
847
|
-
"name": "skip-retrieve",
|
|
848
|
-
"summary": "Don't retrieve the metadata associated with the agent to your DX project.",
|
|
849
|
-
"allowNo": false,
|
|
850
|
-
"type": "boolean"
|
|
851
|
-
}
|
|
852
|
-
},
|
|
853
|
-
"hasDynamicHelp": true,
|
|
854
|
-
"hiddenAliases": [],
|
|
855
|
-
"id": "agent:publish:authoring-bundle",
|
|
856
|
-
"pluginAlias": "@salesforce/plugin-agent",
|
|
857
|
-
"pluginName": "@salesforce/plugin-agent",
|
|
858
|
-
"pluginType": "core",
|
|
859
|
-
"strict": true,
|
|
860
|
-
"summary": "Publish an authoring bundle to your org, which results in a new agent or a new version of an existing agent.",
|
|
861
|
-
"enableJsonFlag": true,
|
|
862
|
-
"requiresProject": true,
|
|
863
|
-
"FLAGGABLE_PROMPTS": {
|
|
864
|
-
"api-name": {
|
|
865
|
-
"message": "API name of the authoring bundle you want to publish; if not specified, the command provides a list that you can choose from.",
|
|
866
|
-
"promptMessage": "API name of the authoring bundle to publish"
|
|
867
|
-
}
|
|
868
|
-
},
|
|
869
|
-
"isESM": true,
|
|
870
|
-
"relativePath": [
|
|
871
|
-
"lib",
|
|
872
|
-
"commands",
|
|
873
|
-
"agent",
|
|
874
|
-
"publish",
|
|
875
|
-
"authoring-bundle.js"
|
|
876
|
-
],
|
|
877
|
-
"aliasPermutations": [],
|
|
878
|
-
"permutations": [
|
|
879
|
-
"agent:publish:authoring-bundle",
|
|
880
|
-
"publish:agent:authoring-bundle",
|
|
881
|
-
"publish:authoring-bundle:agent",
|
|
882
|
-
"agent:authoring-bundle:publish",
|
|
883
|
-
"authoring-bundle:agent:publish",
|
|
884
|
-
"authoring-bundle:publish:agent"
|
|
885
|
-
]
|
|
886
|
-
},
|
|
887
820
|
"agent:test:create": {
|
|
888
821
|
"aliases": [],
|
|
889
822
|
"args": {},
|
|
@@ -1481,7 +1414,97 @@
|
|
|
1481
1414
|
"authoring-bundle:agent:validate",
|
|
1482
1415
|
"authoring-bundle:validate:agent"
|
|
1483
1416
|
]
|
|
1417
|
+
},
|
|
1418
|
+
"agent:publish:authoring-bundle": {
|
|
1419
|
+
"aliases": [],
|
|
1420
|
+
"args": {},
|
|
1421
|
+
"description": "An authoring bundle is a metadata type (named aiAuthoringBundle) that provides the blueprint for an agent. The metadata type contains two files: the standard metatada XML file and an Agent Script file (extension \".agent\") that fully describes the agent using the Agent Script language.\n\nWhen you publish an authoring bundle to your org, a number of things happen. First, this command validates that the Agent Script file successfully compiles. If there are compilation errors, the command exits and you must fix the Agent Script file to continue. Once the Agent Script file compiles, then it's published to the org, which in turn creates new associated metadata (Bot, BotVersion, GenAiX), or new versions of the metadata if the agent already exists. The new or updated metadata is retrieved back to your DX project; specify the --skip-retrieve flag to skip this step. Finally, the authoring bundle metadata (AiAuthoringBundle) is deployed to your org.\n\nThis command uses the API name of the authoring bundle.",
|
|
1422
|
+
"examples": [
|
|
1423
|
+
"Publish an authoring bundle by being prompted for its API name; use your default org:\n<%= config.bin %> <%= command.id %>",
|
|
1424
|
+
"Publish an authoring bundle with API name MyAuthoringBundle to the org with alias \"my-dev-org\":\n<%= config.bin %> <%= command.id %> --api-name MyAuthoringbundle --target-org my-dev-org"
|
|
1425
|
+
],
|
|
1426
|
+
"flags": {
|
|
1427
|
+
"json": {
|
|
1428
|
+
"description": "Format output as json.",
|
|
1429
|
+
"helpGroup": "GLOBAL",
|
|
1430
|
+
"name": "json",
|
|
1431
|
+
"allowNo": false,
|
|
1432
|
+
"type": "boolean"
|
|
1433
|
+
},
|
|
1434
|
+
"flags-dir": {
|
|
1435
|
+
"helpGroup": "GLOBAL",
|
|
1436
|
+
"name": "flags-dir",
|
|
1437
|
+
"summary": "Import flag values from a directory.",
|
|
1438
|
+
"hasDynamicHelp": false,
|
|
1439
|
+
"multiple": false,
|
|
1440
|
+
"type": "option"
|
|
1441
|
+
},
|
|
1442
|
+
"target-org": {
|
|
1443
|
+
"char": "o",
|
|
1444
|
+
"name": "target-org",
|
|
1445
|
+
"noCacheDefault": true,
|
|
1446
|
+
"required": true,
|
|
1447
|
+
"summary": "Username or alias of the target org. Not required if the `target-org` configuration variable is already set.",
|
|
1448
|
+
"hasDynamicHelp": true,
|
|
1449
|
+
"multiple": false,
|
|
1450
|
+
"type": "option"
|
|
1451
|
+
},
|
|
1452
|
+
"api-version": {
|
|
1453
|
+
"description": "Override the api version used for api requests made by this command",
|
|
1454
|
+
"name": "api-version",
|
|
1455
|
+
"hasDynamicHelp": false,
|
|
1456
|
+
"multiple": false,
|
|
1457
|
+
"type": "option"
|
|
1458
|
+
},
|
|
1459
|
+
"api-name": {
|
|
1460
|
+
"char": "n",
|
|
1461
|
+
"name": "api-name",
|
|
1462
|
+
"summary": "API name of the authoring bundle you want to publish; if not specified, the command provides a list that you can choose from.",
|
|
1463
|
+
"hasDynamicHelp": false,
|
|
1464
|
+
"multiple": false,
|
|
1465
|
+
"type": "option"
|
|
1466
|
+
},
|
|
1467
|
+
"skip-retrieve": {
|
|
1468
|
+
"name": "skip-retrieve",
|
|
1469
|
+
"summary": "Don't retrieve the metadata associated with the agent to your DX project.",
|
|
1470
|
+
"allowNo": false,
|
|
1471
|
+
"type": "boolean"
|
|
1472
|
+
}
|
|
1473
|
+
},
|
|
1474
|
+
"hasDynamicHelp": true,
|
|
1475
|
+
"hiddenAliases": [],
|
|
1476
|
+
"id": "agent:publish:authoring-bundle",
|
|
1477
|
+
"pluginAlias": "@salesforce/plugin-agent",
|
|
1478
|
+
"pluginName": "@salesforce/plugin-agent",
|
|
1479
|
+
"pluginType": "core",
|
|
1480
|
+
"strict": true,
|
|
1481
|
+
"summary": "Publish an authoring bundle to your org, which results in a new agent or a new version of an existing agent.",
|
|
1482
|
+
"enableJsonFlag": true,
|
|
1483
|
+
"requiresProject": true,
|
|
1484
|
+
"FLAGGABLE_PROMPTS": {
|
|
1485
|
+
"api-name": {
|
|
1486
|
+
"message": "API name of the authoring bundle you want to publish; if not specified, the command provides a list that you can choose from.",
|
|
1487
|
+
"promptMessage": "API name of the authoring bundle to publish"
|
|
1488
|
+
}
|
|
1489
|
+
},
|
|
1490
|
+
"isESM": true,
|
|
1491
|
+
"relativePath": [
|
|
1492
|
+
"lib",
|
|
1493
|
+
"commands",
|
|
1494
|
+
"agent",
|
|
1495
|
+
"publish",
|
|
1496
|
+
"authoring-bundle.js"
|
|
1497
|
+
],
|
|
1498
|
+
"aliasPermutations": [],
|
|
1499
|
+
"permutations": [
|
|
1500
|
+
"agent:publish:authoring-bundle",
|
|
1501
|
+
"publish:agent:authoring-bundle",
|
|
1502
|
+
"publish:authoring-bundle:agent",
|
|
1503
|
+
"agent:authoring-bundle:publish",
|
|
1504
|
+
"authoring-bundle:agent:publish",
|
|
1505
|
+
"authoring-bundle:publish:agent"
|
|
1506
|
+
]
|
|
1484
1507
|
}
|
|
1485
1508
|
},
|
|
1486
|
-
"version": "1.27.
|
|
1509
|
+
"version": "1.27.4-preview.0"
|
|
1487
1510
|
}
|
package/package.json
CHANGED
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@salesforce/plugin-agent",
|
|
3
3
|
"description": "Commands to interact with Salesforce agents",
|
|
4
|
-
"version": "1.27.
|
|
4
|
+
"version": "1.27.4-preview.0",
|
|
5
5
|
"author": "Salesforce",
|
|
6
6
|
"bugs": "https://github.com/forcedotcom/cli/issues",
|
|
7
7
|
"dependencies": {
|
|
@@ -9,20 +9,20 @@
|
|
|
9
9
|
"@inquirer/prompts": "^7.10.1",
|
|
10
10
|
"@oclif/core": "^4",
|
|
11
11
|
"@oclif/multi-stage-output": "^0.8.29",
|
|
12
|
-
"@salesforce/agents": "^0.22.
|
|
12
|
+
"@salesforce/agents": "^0.22.2",
|
|
13
13
|
"@salesforce/core": "^8.24.3",
|
|
14
|
-
"@salesforce/kit": "^3.2.
|
|
14
|
+
"@salesforce/kit": "^3.2.4",
|
|
15
15
|
"@salesforce/sf-plugins-core": "^12.2.6",
|
|
16
16
|
"@salesforce/source-deploy-retrieve": "^12.31.10",
|
|
17
17
|
"@salesforce/types": "^1.5.0",
|
|
18
18
|
"ansis": "^3.3.2",
|
|
19
|
-
"fast-xml-parser": "^
|
|
19
|
+
"fast-xml-parser": "^5.3.4",
|
|
20
20
|
"glob": "^11.0.3",
|
|
21
21
|
"ink": "5.0.1",
|
|
22
22
|
"ink-text-input": "^6.0.0",
|
|
23
23
|
"inquirer-autocomplete-standalone": "^0.8.1",
|
|
24
24
|
"react": "^18.3.1",
|
|
25
|
-
"yaml": "^2.8.
|
|
25
|
+
"yaml": "^2.8.2"
|
|
26
26
|
},
|
|
27
27
|
"devDependencies": {
|
|
28
28
|
"@oclif/plugin-command-snapshot": "^5.3.8",
|
|
@@ -237,7 +237,7 @@
|
|
|
237
237
|
"exports": "./lib/index.js",
|
|
238
238
|
"type": "module",
|
|
239
239
|
"sfdx": {
|
|
240
|
-
"publicKeyUrl": "https://developer.salesforce.com/media/salesforce-cli/security/@salesforce/plugin-agent/1.27.
|
|
241
|
-
"signatureUrl": "https://developer.salesforce.com/media/salesforce-cli/security/@salesforce/plugin-agent/1.27.
|
|
240
|
+
"publicKeyUrl": "https://developer.salesforce.com/media/salesforce-cli/security/@salesforce/plugin-agent/1.27.4-preview.0.crt",
|
|
241
|
+
"signatureUrl": "https://developer.salesforce.com/media/salesforce-cli/security/@salesforce/plugin-agent/1.27.4-preview.0.sig"
|
|
242
242
|
}
|
|
243
243
|
}
|
|
@@ -3,7 +3,17 @@
|
|
|
3
3
|
"$ref": "#/definitions/AgentPreviewResult",
|
|
4
4
|
"definitions": {
|
|
5
5
|
"AgentPreviewResult": {
|
|
6
|
-
"type": "
|
|
6
|
+
"type": "object",
|
|
7
|
+
"properties": {
|
|
8
|
+
"sessionId": {
|
|
9
|
+
"type": "string"
|
|
10
|
+
},
|
|
11
|
+
"response": {
|
|
12
|
+
"type": "string"
|
|
13
|
+
}
|
|
14
|
+
},
|
|
15
|
+
"required": ["sessionId", "response"],
|
|
16
|
+
"additionalProperties": false
|
|
7
17
|
}
|
|
8
18
|
}
|
|
9
19
|
}
|