@salesforce/plugin-agent 1.32.14 → 1.32.16
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 +47 -39
- package/lib/commands/agent/activate.d.ts +2 -0
- package/lib/commands/agent/activate.js +33 -4
- package/lib/commands/agent/activate.js.map +1 -1
- package/lib/commands/agent/deactivate.d.ts +2 -0
- package/lib/commands/agent/deactivate.js +33 -4
- package/lib/commands/agent/deactivate.js.map +1 -1
- package/lib/commands/agent/preview/end.d.ts +2 -0
- package/lib/commands/agent/preview/end.js +49 -12
- package/lib/commands/agent/preview/end.js.map +1 -1
- package/lib/commands/agent/preview/send.d.ts +2 -0
- package/lib/commands/agent/preview/send.js +47 -9
- package/lib/commands/agent/preview/send.js.map +1 -1
- package/lib/commands/agent/preview/sessions.d.ts +1 -0
- package/lib/commands/agent/preview/sessions.js +4 -1
- package/lib/commands/agent/preview/sessions.js.map +1 -1
- package/lib/commands/agent/preview/start.d.ts +3 -0
- package/lib/commands/agent/preview/start.js +72 -10
- package/lib/commands/agent/preview/start.js.map +1 -1
- package/lib/commands/agent/test/create.d.ts +2 -0
- package/lib/commands/agent/test/create.js +34 -6
- package/lib/commands/agent/test/create.js.map +1 -1
- package/lib/commands/agent/test/list.d.ts +2 -0
- package/lib/commands/agent/test/list.js +15 -3
- package/lib/commands/agent/test/list.js.map +1 -1
- package/lib/commands/agent/test/results.d.ts +2 -0
- package/lib/commands/agent/test/results.js +23 -3
- package/lib/commands/agent/test/results.js.map +1 -1
- package/lib/commands/agent/test/resume.d.ts +6 -0
- package/lib/commands/agent/test/resume.js +55 -7
- package/lib/commands/agent/test/resume.js.map +1 -1
- package/lib/commands/agent/test/run-eval.d.ts +2 -0
- package/lib/commands/agent/test/run-eval.js +38 -7
- package/lib/commands/agent/test/run-eval.js.map +1 -1
- package/lib/commands/agent/test/run.d.ts +2 -0
- package/lib/commands/agent/test/run.js +32 -8
- package/lib/commands/agent/test/run.js.map +1 -1
- package/lib/commands/agent/validate/authoring-bundle.d.ts +2 -0
- package/lib/commands/agent/validate/authoring-bundle.js +9 -2
- package/lib/commands/agent/validate/authoring-bundle.js.map +1 -1
- package/lib/previewSessionStore.js +0 -6
- package/lib/previewSessionStore.js.map +1 -1
- package/messages/agent.activate.md +8 -0
- package/messages/agent.deactivate.md +8 -0
- package/messages/agent.preview.end.md +18 -6
- package/messages/agent.preview.send.md +16 -4
- package/messages/agent.preview.start.md +31 -10
- package/oclif.manifest.json +372 -7
- package/package.json +3 -3
|
@@ -1,14 +1,19 @@
|
|
|
1
1
|
# summary
|
|
2
2
|
|
|
3
|
-
Start a programmatic agent preview session.
|
|
3
|
+
Start a programmatic agent preview session.
|
|
4
4
|
|
|
5
5
|
# description
|
|
6
6
|
|
|
7
|
-
This command outputs a session ID that you then use with the "agent preview send" command to send an utterance to the agent.
|
|
7
|
+
This command outputs a session ID that you then use with the "agent preview send" command to send an utterance to the agent. Use the "agent preview sessions" command to list all active sessions and the "agent preview end" command to end a specific session.
|
|
8
8
|
|
|
9
|
-
Identify the agent you want to start previewing with either the --authoring-bundle flag to specify a local authoring bundle's API name or --api-name to specify an activated published agent's API name.
|
|
9
|
+
Identify the agent you want to start previewing with either the --authoring-bundle flag to specify a local authoring bundle's API name or --api-name to specify an activated published agent's API name. To find either API name, navigate to your package directory in your DX project. The API name of an authoring bundle is the same as its directory name under the "aiAuthoringBundles" metadata directory. Similarly, the published agent's API name is the same as its directory name under the "Bots" metadata directory.
|
|
10
10
|
|
|
11
|
-
When starting a preview session
|
|
11
|
+
When starting a preview session with --authoring-bundle, you must explicitly specify the execution mode using one of these flags:
|
|
12
|
+
|
|
13
|
+
- --use-live-actions: Executes real Apex classes, flows, and other actions in the org. This surfaces compile and validation errors during preview.
|
|
14
|
+
- --simulate-actions: Uses AI to simulate action execution without calling real implementations.
|
|
15
|
+
|
|
16
|
+
Published agents (--api-name) always use live actions. The mode flags are optional and have no effect for published agents.
|
|
12
17
|
|
|
13
18
|
# flags.api-name.summary
|
|
14
19
|
|
|
@@ -20,22 +25,38 @@ API name of the authoring bundle metadata component that contains the agent's Ag
|
|
|
20
25
|
|
|
21
26
|
# flags.use-live-actions.summary
|
|
22
27
|
|
|
23
|
-
|
|
28
|
+
Execute real actions in the org (Apex classes, flows, etc.). Required with --authoring-bundle.
|
|
29
|
+
|
|
30
|
+
# flags.simulate-actions.summary
|
|
31
|
+
|
|
32
|
+
Use AI to simulate action execution instead of calling real actions. Required with --authoring-bundle.
|
|
24
33
|
|
|
25
34
|
# output.sessionId
|
|
26
35
|
|
|
27
36
|
Session ID: %s
|
|
28
37
|
|
|
38
|
+
# error.agentNotFound
|
|
39
|
+
|
|
40
|
+
Agent '%s' not found. Check that the API name is correct and that the agent exists in your org or project.
|
|
41
|
+
|
|
42
|
+
# error.compilationFailed
|
|
43
|
+
|
|
44
|
+
Agent Script compilation failed. See errors above for details.
|
|
45
|
+
|
|
46
|
+
# error.previewStartFailed
|
|
47
|
+
|
|
48
|
+
Failed to start preview session: %s
|
|
49
|
+
|
|
29
50
|
# examples
|
|
30
51
|
|
|
31
|
-
- Start a programmatic agent preview session by specifying an authoring bundle;
|
|
52
|
+
- Start a programmatic agent preview session by specifying an authoring bundle; use simulated actions. Use the org with alias "my-dev-org":
|
|
32
53
|
|
|
33
|
-
|
|
54
|
+
<%= config.bin %> <%= command.id %> --authoring-bundle My_Agent_Bundle --target-org my-dev-org --simulate-actions
|
|
34
55
|
|
|
35
56
|
- Similar to previous example but use live actions and the default org:
|
|
36
57
|
|
|
37
|
-
|
|
58
|
+
<%= config.bin %> <%= command.id %> --authoring-bundle My_Agent_Bundle --use-live-actions
|
|
38
59
|
|
|
39
|
-
- Start a preview session with an activated published agent:
|
|
60
|
+
- Start a preview session with an activated published agent (always uses live actions):
|
|
40
61
|
|
|
41
|
-
|
|
62
|
+
<%= config.bin %> <%= command.id %> --api-name My_Published_Agent
|
package/oclif.manifest.json
CHANGED
|
@@ -66,6 +66,32 @@
|
|
|
66
66
|
"strict": true,
|
|
67
67
|
"summary": "Activate an agent in an org.",
|
|
68
68
|
"enableJsonFlag": true,
|
|
69
|
+
"envVariablesSection": {
|
|
70
|
+
"header": "ENVIRONMENT VARIABLES",
|
|
71
|
+
"body": [
|
|
72
|
+
{
|
|
73
|
+
"name": "SF_TARGET_ORG",
|
|
74
|
+
"description": "Username or alias of your default org. Overrides the target-org configuration variable."
|
|
75
|
+
}
|
|
76
|
+
]
|
|
77
|
+
},
|
|
78
|
+
"errorCodes": {
|
|
79
|
+
"header": "ERROR CODES",
|
|
80
|
+
"body": [
|
|
81
|
+
{
|
|
82
|
+
"name": "Succeeded (0)",
|
|
83
|
+
"description": "Agent activated successfully."
|
|
84
|
+
},
|
|
85
|
+
{
|
|
86
|
+
"name": "NotFound (2)",
|
|
87
|
+
"description": "Agent not found in the org."
|
|
88
|
+
},
|
|
89
|
+
{
|
|
90
|
+
"name": "ActivationFailed (4)",
|
|
91
|
+
"description": "Failed to activate the agent due to API or network errors."
|
|
92
|
+
}
|
|
93
|
+
]
|
|
94
|
+
},
|
|
69
95
|
"isESM": true,
|
|
70
96
|
"relativePath": [
|
|
71
97
|
"lib",
|
|
@@ -239,6 +265,32 @@
|
|
|
239
265
|
"strict": true,
|
|
240
266
|
"summary": "Deactivate an agent in an org.",
|
|
241
267
|
"enableJsonFlag": true,
|
|
268
|
+
"envVariablesSection": {
|
|
269
|
+
"header": "ENVIRONMENT VARIABLES",
|
|
270
|
+
"body": [
|
|
271
|
+
{
|
|
272
|
+
"name": "SF_TARGET_ORG",
|
|
273
|
+
"description": "Username or alias of your default org. Overrides the target-org configuration variable."
|
|
274
|
+
}
|
|
275
|
+
]
|
|
276
|
+
},
|
|
277
|
+
"errorCodes": {
|
|
278
|
+
"header": "ERROR CODES",
|
|
279
|
+
"body": [
|
|
280
|
+
{
|
|
281
|
+
"name": "Succeeded (0)",
|
|
282
|
+
"description": "Agent deactivated successfully."
|
|
283
|
+
},
|
|
284
|
+
{
|
|
285
|
+
"name": "NotFound (2)",
|
|
286
|
+
"description": "Agent not found in the org."
|
|
287
|
+
},
|
|
288
|
+
{
|
|
289
|
+
"name": "DeactivationFailed (4)",
|
|
290
|
+
"description": "Failed to deactivate the agent due to API or network errors."
|
|
291
|
+
}
|
|
292
|
+
]
|
|
293
|
+
},
|
|
242
294
|
"isESM": true,
|
|
243
295
|
"relativePath": [
|
|
244
296
|
"lib",
|
|
@@ -819,7 +871,7 @@
|
|
|
819
871
|
"agent:preview:end": {
|
|
820
872
|
"aliases": [],
|
|
821
873
|
"args": {},
|
|
822
|
-
"description": "You must have previously started a programmatic agent preview session with the \"agent preview start\" command to then use this command to end it. This command also displays the local directory where the session trace files are stored
|
|
874
|
+
"description": "You must have previously started a programmatic agent preview session with the \"agent preview start\" command to then use this command to end it. This command also displays the local directory where the session trace files are stored.\n\nThe original \"agent preview start\" command outputs a session ID which you then use with the --session-id flag of this command to end the session. You don't have to specify the --session-id flag if an agent has only one active preview session. You must also use either the --authoring-bundle or --api-name flag to specify the API name of the authoring bundle or the published agent, respecitvely. To find either API name, navigate to your package directory in your DX project. The API name of an authoring bundle is the same as its directory name under the \"aiAuthoringBundles\" metadata directory. Similarly, the published agent's API name is the same as its directory name under the \"Bots\" metadata directory.",
|
|
823
875
|
"examples": [
|
|
824
876
|
"End a preview session of a published agent by specifying its session ID and API name ; use the default org:\n<%= config.bin %> <%= command.id %> --session-id <SESSION_ID> --api-name My_Published_Agent",
|
|
825
877
|
"Similar to previous example, but don't specify a session ID; you get an error if the published agent has more than one active session. Use the org with alias \"my-dev-org\":\n<%= config.bin %> <%= command.id %> --api-name My_Published_Agent --target-org my-dev-org",
|
|
@@ -892,6 +944,36 @@
|
|
|
892
944
|
"summary": "End an existing programmatic agent preview session and get trace location.",
|
|
893
945
|
"enableJsonFlag": true,
|
|
894
946
|
"requiresProject": true,
|
|
947
|
+
"envVariablesSection": {
|
|
948
|
+
"header": "ENVIRONMENT VARIABLES",
|
|
949
|
+
"body": [
|
|
950
|
+
{
|
|
951
|
+
"name": "SF_TARGET_ORG",
|
|
952
|
+
"description": "Username or alias of your default org. Overrides the target-org configuration variable."
|
|
953
|
+
}
|
|
954
|
+
]
|
|
955
|
+
},
|
|
956
|
+
"errorCodes": {
|
|
957
|
+
"header": "ERROR CODES",
|
|
958
|
+
"body": [
|
|
959
|
+
{
|
|
960
|
+
"name": "Succeeded (0)",
|
|
961
|
+
"description": "Preview session ended successfully and traces saved."
|
|
962
|
+
},
|
|
963
|
+
{
|
|
964
|
+
"name": "NotFound (2)",
|
|
965
|
+
"description": "Agent not found, or no preview session exists for this agent."
|
|
966
|
+
},
|
|
967
|
+
{
|
|
968
|
+
"name": "PreviewEndFailed (4)",
|
|
969
|
+
"description": "Failed to end the preview session."
|
|
970
|
+
},
|
|
971
|
+
{
|
|
972
|
+
"name": "SessionAmbiguous (5)",
|
|
973
|
+
"description": "Multiple preview sessions found; specify --session-id to choose one."
|
|
974
|
+
}
|
|
975
|
+
]
|
|
976
|
+
},
|
|
895
977
|
"isESM": true,
|
|
896
978
|
"relativePath": [
|
|
897
979
|
"lib",
|
|
@@ -913,7 +995,7 @@
|
|
|
913
995
|
"agent:preview:send": {
|
|
914
996
|
"aliases": [],
|
|
915
997
|
"args": {},
|
|
916
|
-
"description": "You must have previously started a programmatic agent preview session with the \"agent preview start\" command to then use this command to send the agent a message (utterance). This command then displays the agent's response.\n\nThe original \"agent preview start\" command outputs a session ID which you then use with the --session-id flag of this command to send a message.
|
|
998
|
+
"description": "You must have previously started a programmatic agent preview session with the \"agent preview start\" command to then use this command to send the agent a message (utterance). This command then displays the agent's response.\n\nThe original \"agent preview start\" command outputs a session ID which you then use with the --session-id flag of this command to send a message. You don't have to specify the --session-id flag if an agent has only one active preview session. You must also use either the --authoring-bundle or --api-name flag to specify the API name of the authoring bundle or the published agent, respecitvely. To find either API name, navigate to your package directory in your DX project. The API name of an authoring bundle is the same as its directory name under the \"aiAuthoringBundles\" metadata directory. Similarly, the published agent's API name is the same as its directory name under the \"Bots\" metadata directory.",
|
|
917
999
|
"examples": [
|
|
918
1000
|
"Send a message to an activated published agent using its API name and session ID; use the default org:\n<%= config.bin %> <%= command.id %> --utterance \"What can you help me with?\" --api-name My_Published_Agent --session-id <SESSION_ID>",
|
|
919
1001
|
"Similar to previous example, but don't specify a session ID; you get an error if the agent has more than one active session. Use the org with alias \"my-dev-org\":\n<%= config.bin %> <%= command.id %> --utterance \"What can you help me with?\" --api-name My_Published_Agent --target-org my-dev-org",
|
|
@@ -995,6 +1077,36 @@
|
|
|
995
1077
|
"summary": "Send a message to an existing agent preview session.",
|
|
996
1078
|
"enableJsonFlag": true,
|
|
997
1079
|
"requiresProject": true,
|
|
1080
|
+
"envVariablesSection": {
|
|
1081
|
+
"header": "ENVIRONMENT VARIABLES",
|
|
1082
|
+
"body": [
|
|
1083
|
+
{
|
|
1084
|
+
"name": "SF_TARGET_ORG",
|
|
1085
|
+
"description": "Username or alias of your default org. Overrides the target-org configuration variable."
|
|
1086
|
+
}
|
|
1087
|
+
]
|
|
1088
|
+
},
|
|
1089
|
+
"errorCodes": {
|
|
1090
|
+
"header": "ERROR CODES",
|
|
1091
|
+
"body": [
|
|
1092
|
+
{
|
|
1093
|
+
"name": "Succeeded (0)",
|
|
1094
|
+
"description": "Message sent successfully and agent response received."
|
|
1095
|
+
},
|
|
1096
|
+
{
|
|
1097
|
+
"name": "NotFound (2)",
|
|
1098
|
+
"description": "Agent not found, or no preview session exists for this agent."
|
|
1099
|
+
},
|
|
1100
|
+
{
|
|
1101
|
+
"name": "PreviewSendFailed (4)",
|
|
1102
|
+
"description": "Failed to send message or receive response from the preview session."
|
|
1103
|
+
},
|
|
1104
|
+
{
|
|
1105
|
+
"name": "SessionAmbiguous (5)",
|
|
1106
|
+
"description": "Multiple preview sessions found; specify --session-id to choose one."
|
|
1107
|
+
}
|
|
1108
|
+
]
|
|
1109
|
+
},
|
|
998
1110
|
"isESM": true,
|
|
999
1111
|
"relativePath": [
|
|
1000
1112
|
"lib",
|
|
@@ -1047,6 +1159,15 @@
|
|
|
1047
1159
|
"summary": "List all known programmatic agent preview sessions.",
|
|
1048
1160
|
"enableJsonFlag": true,
|
|
1049
1161
|
"requiresProject": true,
|
|
1162
|
+
"errorCodes": {
|
|
1163
|
+
"header": "ERROR CODES",
|
|
1164
|
+
"body": [
|
|
1165
|
+
{
|
|
1166
|
+
"name": "Succeeded (0)",
|
|
1167
|
+
"description": "Sessions listed successfully (or empty list if no active sessions)."
|
|
1168
|
+
}
|
|
1169
|
+
]
|
|
1170
|
+
},
|
|
1050
1171
|
"isESM": true,
|
|
1051
1172
|
"relativePath": [
|
|
1052
1173
|
"lib",
|
|
@@ -1068,11 +1189,11 @@
|
|
|
1068
1189
|
"agent:preview:start": {
|
|
1069
1190
|
"aliases": [],
|
|
1070
1191
|
"args": {},
|
|
1071
|
-
"description": "This command outputs a session ID that you then use with the \"agent preview send\" command to send an utterance to the agent.
|
|
1192
|
+
"description": "This command outputs a session ID that you then use with the \"agent preview send\" command to send an utterance to the agent. Use the \"agent preview sessions\" command to list all active sessions and the \"agent preview end\" command to end a specific session.\n\nIdentify the agent you want to start previewing with either the --authoring-bundle flag to specify a local authoring bundle's API name or --api-name to specify an activated published agent's API name. To find either API name, navigate to your package directory in your DX project. The API name of an authoring bundle is the same as its directory name under the \"aiAuthoringBundles\" metadata directory. Similarly, the published agent's API name is the same as its directory name under the \"Bots\" metadata directory.\n\nWhen starting a preview session with --authoring-bundle, you must explicitly specify the execution mode using one of these flags:\n\n- --use-live-actions: Executes real Apex classes, flows, and other actions in the org. This surfaces compile and validation errors during preview.\n- --simulate-actions: Uses AI to simulate action execution without calling real implementations.\n\nPublished agents (--api-name) always use live actions. The mode flags are optional and have no effect for published agents.",
|
|
1072
1193
|
"examples": [
|
|
1073
|
-
"Start a programmatic agent preview session by specifying an authoring bundle;
|
|
1194
|
+
"Start a programmatic agent preview session by specifying an authoring bundle; use simulated actions. Use the org with alias \"my-dev-org\":\n<%= config.bin %> <%= command.id %> --authoring-bundle My_Agent_Bundle --target-org my-dev-org --simulate-actions",
|
|
1074
1195
|
"Similar to previous example but use live actions and the default org:\n<%= config.bin %> <%= command.id %> --authoring-bundle My_Agent_Bundle --use-live-actions",
|
|
1075
|
-
"Start a preview session with an activated published agent:\n<%= config.bin %> <%= command.id %> --api-name My_Published_Agent"
|
|
1196
|
+
"Start a preview session with an activated published agent (always uses live actions):\n<%= config.bin %> <%= command.id %> --api-name My_Published_Agent"
|
|
1076
1197
|
],
|
|
1077
1198
|
"flags": {
|
|
1078
1199
|
"json": {
|
|
@@ -1123,8 +1244,20 @@
|
|
|
1123
1244
|
"type": "option"
|
|
1124
1245
|
},
|
|
1125
1246
|
"use-live-actions": {
|
|
1247
|
+
"exclusive": [
|
|
1248
|
+
"simulate-actions"
|
|
1249
|
+
],
|
|
1126
1250
|
"name": "use-live-actions",
|
|
1127
|
-
"summary": "
|
|
1251
|
+
"summary": "Execute real actions in the org (Apex classes, flows, etc.). Required with --authoring-bundle.",
|
|
1252
|
+
"allowNo": false,
|
|
1253
|
+
"type": "boolean"
|
|
1254
|
+
},
|
|
1255
|
+
"simulate-actions": {
|
|
1256
|
+
"exclusive": [
|
|
1257
|
+
"use-live-actions"
|
|
1258
|
+
],
|
|
1259
|
+
"name": "simulate-actions",
|
|
1260
|
+
"summary": "Use AI to simulate action execution instead of calling real actions. Required with --authoring-bundle.",
|
|
1128
1261
|
"allowNo": false,
|
|
1129
1262
|
"type": "boolean"
|
|
1130
1263
|
}
|
|
@@ -1139,6 +1272,40 @@
|
|
|
1139
1272
|
"summary": "Start a programmatic agent preview session.",
|
|
1140
1273
|
"enableJsonFlag": true,
|
|
1141
1274
|
"requiresProject": true,
|
|
1275
|
+
"envVariablesSection": {
|
|
1276
|
+
"header": "ENVIRONMENT VARIABLES",
|
|
1277
|
+
"body": [
|
|
1278
|
+
{
|
|
1279
|
+
"name": "SF_TARGET_ORG",
|
|
1280
|
+
"description": "Username or alias of your default org. Overrides the target-org configuration variable."
|
|
1281
|
+
}
|
|
1282
|
+
]
|
|
1283
|
+
},
|
|
1284
|
+
"errorCodes": {
|
|
1285
|
+
"header": "ERROR CODES",
|
|
1286
|
+
"body": [
|
|
1287
|
+
{
|
|
1288
|
+
"name": "Succeeded (0)",
|
|
1289
|
+
"description": "Preview session started successfully."
|
|
1290
|
+
},
|
|
1291
|
+
{
|
|
1292
|
+
"name": "Failed (1)",
|
|
1293
|
+
"description": "Agent Script compilation failed (syntax errors in the script)."
|
|
1294
|
+
},
|
|
1295
|
+
{
|
|
1296
|
+
"name": "NotFound (2)",
|
|
1297
|
+
"description": "Agent not found, or compilation API returned HTTP 404 (endpoint may not be available in your org or region)."
|
|
1298
|
+
},
|
|
1299
|
+
{
|
|
1300
|
+
"name": "ServerError (3)",
|
|
1301
|
+
"description": "Compilation API returned HTTP 500 (server error during compilation)."
|
|
1302
|
+
},
|
|
1303
|
+
{
|
|
1304
|
+
"name": "PreviewStartFailed (4)",
|
|
1305
|
+
"description": "Preview session failed to start due to API or network errors."
|
|
1306
|
+
}
|
|
1307
|
+
]
|
|
1308
|
+
},
|
|
1142
1309
|
"isESM": true,
|
|
1143
1310
|
"relativePath": [
|
|
1144
1311
|
"lib",
|
|
@@ -1325,6 +1492,36 @@
|
|
|
1325
1492
|
"strict": true,
|
|
1326
1493
|
"summary": "Create an agent test in your org using a local test spec YAML file.",
|
|
1327
1494
|
"enableJsonFlag": true,
|
|
1495
|
+
"envVariablesSection": {
|
|
1496
|
+
"header": "ENVIRONMENT VARIABLES",
|
|
1497
|
+
"body": [
|
|
1498
|
+
{
|
|
1499
|
+
"name": "SF_TARGET_ORG",
|
|
1500
|
+
"description": "Username or alias of your default org. Overrides the target-org configuration variable."
|
|
1501
|
+
}
|
|
1502
|
+
]
|
|
1503
|
+
},
|
|
1504
|
+
"errorCodes": {
|
|
1505
|
+
"header": "ERROR CODES",
|
|
1506
|
+
"body": [
|
|
1507
|
+
{
|
|
1508
|
+
"name": "Succeeded (0)",
|
|
1509
|
+
"description": "Test created and deployed successfully."
|
|
1510
|
+
},
|
|
1511
|
+
{
|
|
1512
|
+
"name": "Failed (1)",
|
|
1513
|
+
"description": "Test validation errors or metadata format issues."
|
|
1514
|
+
},
|
|
1515
|
+
{
|
|
1516
|
+
"name": "NotFound (2)",
|
|
1517
|
+
"description": "Test spec file not found or org connection failed."
|
|
1518
|
+
},
|
|
1519
|
+
{
|
|
1520
|
+
"name": "DeploymentFailed (4)",
|
|
1521
|
+
"description": "Deployment failed due to API or network errors."
|
|
1522
|
+
}
|
|
1523
|
+
]
|
|
1524
|
+
},
|
|
1328
1525
|
"isESM": true,
|
|
1329
1526
|
"relativePath": [
|
|
1330
1527
|
"lib",
|
|
@@ -1394,6 +1591,28 @@
|
|
|
1394
1591
|
"strict": true,
|
|
1395
1592
|
"summary": "List the available agent tests in your org.",
|
|
1396
1593
|
"enableJsonFlag": true,
|
|
1594
|
+
"envVariablesSection": {
|
|
1595
|
+
"header": "ENVIRONMENT VARIABLES",
|
|
1596
|
+
"body": [
|
|
1597
|
+
{
|
|
1598
|
+
"name": "SF_TARGET_ORG",
|
|
1599
|
+
"description": "Username or alias of your default org. Overrides the target-org configuration variable."
|
|
1600
|
+
}
|
|
1601
|
+
]
|
|
1602
|
+
},
|
|
1603
|
+
"errorCodes": {
|
|
1604
|
+
"header": "ERROR CODES",
|
|
1605
|
+
"body": [
|
|
1606
|
+
{
|
|
1607
|
+
"name": "Succeeded (0)",
|
|
1608
|
+
"description": "Agent tests listed successfully."
|
|
1609
|
+
},
|
|
1610
|
+
{
|
|
1611
|
+
"name": "Failed (4)",
|
|
1612
|
+
"description": "Failed to retrieve agent tests due to API or network errors."
|
|
1613
|
+
}
|
|
1614
|
+
]
|
|
1615
|
+
},
|
|
1397
1616
|
"isESM": true,
|
|
1398
1617
|
"relativePath": [
|
|
1399
1618
|
"lib",
|
|
@@ -1503,6 +1722,32 @@
|
|
|
1503
1722
|
"strict": true,
|
|
1504
1723
|
"summary": "Get the results of a completed agent test run.",
|
|
1505
1724
|
"enableJsonFlag": true,
|
|
1725
|
+
"envVariablesSection": {
|
|
1726
|
+
"header": "ENVIRONMENT VARIABLES",
|
|
1727
|
+
"body": [
|
|
1728
|
+
{
|
|
1729
|
+
"name": "SF_TARGET_ORG",
|
|
1730
|
+
"description": "Username or alias of your default org. Overrides the target-org configuration variable."
|
|
1731
|
+
}
|
|
1732
|
+
]
|
|
1733
|
+
},
|
|
1734
|
+
"errorCodes": {
|
|
1735
|
+
"header": "ERROR CODES",
|
|
1736
|
+
"body": [
|
|
1737
|
+
{
|
|
1738
|
+
"name": "Succeeded (0)",
|
|
1739
|
+
"description": "Results retrieved successfully. Test results (passed/failed) are in the output."
|
|
1740
|
+
},
|
|
1741
|
+
{
|
|
1742
|
+
"name": "NotFound (2)",
|
|
1743
|
+
"description": "Job ID not found or invalid."
|
|
1744
|
+
},
|
|
1745
|
+
{
|
|
1746
|
+
"name": "Failed (4)",
|
|
1747
|
+
"description": "Failed to retrieve results due to API or network errors."
|
|
1748
|
+
}
|
|
1749
|
+
]
|
|
1750
|
+
},
|
|
1506
1751
|
"isESM": true,
|
|
1507
1752
|
"relativePath": [
|
|
1508
1753
|
"lib",
|
|
@@ -1627,6 +1872,36 @@
|
|
|
1627
1872
|
"strict": true,
|
|
1628
1873
|
"summary": "Resume an agent test that you previously started in your org so you can view the test results.",
|
|
1629
1874
|
"enableJsonFlag": true,
|
|
1875
|
+
"envVariablesSection": {
|
|
1876
|
+
"header": "ENVIRONMENT VARIABLES",
|
|
1877
|
+
"body": [
|
|
1878
|
+
{
|
|
1879
|
+
"name": "SF_TARGET_ORG",
|
|
1880
|
+
"description": "Username or alias of your default org. Overrides the target-org configuration variable."
|
|
1881
|
+
}
|
|
1882
|
+
]
|
|
1883
|
+
},
|
|
1884
|
+
"errorCodes": {
|
|
1885
|
+
"header": "ERROR CODES",
|
|
1886
|
+
"body": [
|
|
1887
|
+
{
|
|
1888
|
+
"name": "Succeeded (0)",
|
|
1889
|
+
"description": "Test completed successfully (with test results in the output)."
|
|
1890
|
+
},
|
|
1891
|
+
{
|
|
1892
|
+
"name": "Failed (1)",
|
|
1893
|
+
"description": "Tests encountered execution errors (test cases with ERROR status)."
|
|
1894
|
+
},
|
|
1895
|
+
{
|
|
1896
|
+
"name": "NotFound (2)",
|
|
1897
|
+
"description": "Job ID not found or invalid."
|
|
1898
|
+
},
|
|
1899
|
+
{
|
|
1900
|
+
"name": "OperationFailed (4)",
|
|
1901
|
+
"description": "Failed to poll test due to API or network errors."
|
|
1902
|
+
}
|
|
1903
|
+
]
|
|
1904
|
+
},
|
|
1630
1905
|
"isESM": true,
|
|
1631
1906
|
"relativePath": [
|
|
1632
1907
|
"lib",
|
|
@@ -1756,6 +2031,36 @@
|
|
|
1756
2031
|
"strict": true,
|
|
1757
2032
|
"summary": "Run evaluation tests against an Agentforce agent.",
|
|
1758
2033
|
"enableJsonFlag": true,
|
|
2034
|
+
"envVariablesSection": {
|
|
2035
|
+
"header": "ENVIRONMENT VARIABLES",
|
|
2036
|
+
"body": [
|
|
2037
|
+
{
|
|
2038
|
+
"name": "SF_TARGET_ORG",
|
|
2039
|
+
"description": "Username or alias of your default org. Overrides the target-org configuration variable."
|
|
2040
|
+
}
|
|
2041
|
+
]
|
|
2042
|
+
},
|
|
2043
|
+
"errorCodes": {
|
|
2044
|
+
"header": "ERROR CODES",
|
|
2045
|
+
"body": [
|
|
2046
|
+
{
|
|
2047
|
+
"name": "Succeeded (0)",
|
|
2048
|
+
"description": "Tests completed successfully. Test results (passed/failed) are in the JSON output."
|
|
2049
|
+
},
|
|
2050
|
+
{
|
|
2051
|
+
"name": "Failed (1)",
|
|
2052
|
+
"description": "Tests encountered execution errors (tests couldn't run properly)."
|
|
2053
|
+
},
|
|
2054
|
+
{
|
|
2055
|
+
"name": "NotFound (2)",
|
|
2056
|
+
"description": "Agent not found, spec file not found, or invalid agent name."
|
|
2057
|
+
},
|
|
2058
|
+
{
|
|
2059
|
+
"name": "OperationFailed (4)",
|
|
2060
|
+
"description": "Failed to execute tests due to API or network errors."
|
|
2061
|
+
}
|
|
2062
|
+
]
|
|
2063
|
+
},
|
|
1759
2064
|
"isESM": true,
|
|
1760
2065
|
"relativePath": [
|
|
1761
2066
|
"lib",
|
|
@@ -1872,6 +2177,36 @@
|
|
|
1872
2177
|
"strict": true,
|
|
1873
2178
|
"summary": "Start an agent test in your org.",
|
|
1874
2179
|
"enableJsonFlag": true,
|
|
2180
|
+
"envVariablesSection": {
|
|
2181
|
+
"header": "ENVIRONMENT VARIABLES",
|
|
2182
|
+
"body": [
|
|
2183
|
+
{
|
|
2184
|
+
"name": "SF_TARGET_ORG",
|
|
2185
|
+
"description": "Username or alias of your default org. Overrides the target-org configuration variable."
|
|
2186
|
+
}
|
|
2187
|
+
]
|
|
2188
|
+
},
|
|
2189
|
+
"errorCodes": {
|
|
2190
|
+
"header": "ERROR CODES",
|
|
2191
|
+
"body": [
|
|
2192
|
+
{
|
|
2193
|
+
"name": "Succeeded (0)",
|
|
2194
|
+
"description": "Test started successfully (without --wait), or test completed successfully (with --wait)."
|
|
2195
|
+
},
|
|
2196
|
+
{
|
|
2197
|
+
"name": "Failed (1)",
|
|
2198
|
+
"description": "Tests encountered execution errors (test cases with ERROR status when using --wait)."
|
|
2199
|
+
},
|
|
2200
|
+
{
|
|
2201
|
+
"name": "NotFound (2)",
|
|
2202
|
+
"description": "Test definition not found or invalid test name."
|
|
2203
|
+
},
|
|
2204
|
+
{
|
|
2205
|
+
"name": "OperationFailed (4)",
|
|
2206
|
+
"description": "Failed to start or poll test due to API or network errors."
|
|
2207
|
+
}
|
|
2208
|
+
]
|
|
2209
|
+
},
|
|
1875
2210
|
"isESM": true,
|
|
1876
2211
|
"relativePath": [
|
|
1877
2212
|
"lib",
|
|
@@ -1950,6 +2285,36 @@
|
|
|
1950
2285
|
"summary": "Validate an authoring bundle to ensure its Agent Script file compiles successfully and can be used to publish an agent.",
|
|
1951
2286
|
"enableJsonFlag": true,
|
|
1952
2287
|
"requiresProject": true,
|
|
2288
|
+
"envVariablesSection": {
|
|
2289
|
+
"header": "ENVIRONMENT VARIABLES",
|
|
2290
|
+
"body": [
|
|
2291
|
+
{
|
|
2292
|
+
"name": "SF_TARGET_ORG",
|
|
2293
|
+
"description": "Username or alias of your default org. Overrides the target-org configuration variable."
|
|
2294
|
+
}
|
|
2295
|
+
]
|
|
2296
|
+
},
|
|
2297
|
+
"errorCodes": {
|
|
2298
|
+
"header": "ERROR CODES",
|
|
2299
|
+
"body": [
|
|
2300
|
+
{
|
|
2301
|
+
"name": "Succeeded (0)",
|
|
2302
|
+
"description": "Agent Script file compiled successfully without errors."
|
|
2303
|
+
},
|
|
2304
|
+
{
|
|
2305
|
+
"name": "Failed (1)",
|
|
2306
|
+
"description": "Compilation errors found in the Agent Script file."
|
|
2307
|
+
},
|
|
2308
|
+
{
|
|
2309
|
+
"name": "NotFound (2)",
|
|
2310
|
+
"description": "Validation/compilation API returned HTTP 404. The API endpoint may not be available in your org or region."
|
|
2311
|
+
},
|
|
2312
|
+
{
|
|
2313
|
+
"name": "ServerError (3)",
|
|
2314
|
+
"description": "Validation/compilation API returned HTTP 500. A server error occurred during compilation."
|
|
2315
|
+
}
|
|
2316
|
+
]
|
|
2317
|
+
},
|
|
1953
2318
|
"FLAGGABLE_PROMPTS": {
|
|
1954
2319
|
"api-name": {
|
|
1955
2320
|
"message": "API name of the authoring bundle you want to validate; if not specified, the command provides a list that you can choose from.",
|
|
@@ -1975,5 +2340,5 @@
|
|
|
1975
2340
|
]
|
|
1976
2341
|
}
|
|
1977
2342
|
},
|
|
1978
|
-
"version": "1.32.
|
|
2343
|
+
"version": "1.32.16"
|
|
1979
2344
|
}
|
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.32.
|
|
4
|
+
"version": "1.32.16",
|
|
5
5
|
"author": "Salesforce",
|
|
6
6
|
"bugs": "https://github.com/forcedotcom/cli/issues",
|
|
7
7
|
"enableO11y": true,
|
|
@@ -240,7 +240,7 @@
|
|
|
240
240
|
"exports": "./lib/index.js",
|
|
241
241
|
"type": "module",
|
|
242
242
|
"sfdx": {
|
|
243
|
-
"publicKeyUrl": "https://developer.salesforce.com/media/salesforce-cli/security/@salesforce/plugin-agent/1.32.
|
|
244
|
-
"signatureUrl": "https://developer.salesforce.com/media/salesforce-cli/security/@salesforce/plugin-agent/1.32.
|
|
243
|
+
"publicKeyUrl": "https://developer.salesforce.com/media/salesforce-cli/security/@salesforce/plugin-agent/1.32.16.crt",
|
|
244
|
+
"signatureUrl": "https://developer.salesforce.com/media/salesforce-cli/security/@salesforce/plugin-agent/1.32.16.sig"
|
|
245
245
|
}
|
|
246
246
|
}
|