@salesforce/plugin-agent 1.44.5 → 2.0.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 +41 -41
- package/lib/commands/agent/mcp/asset/list.js +4 -0
- package/lib/commands/agent/mcp/asset/list.js.map +1 -1
- package/lib/commands/agent/mcp/asset/replace.js +6 -0
- package/lib/commands/agent/mcp/asset/replace.js.map +1 -1
- package/lib/commands/agent/mcp/create.js +22 -0
- package/lib/commands/agent/mcp/create.js.map +1 -1
- package/lib/commands/agent/mcp/fetch.js +6 -0
- package/lib/commands/agent/mcp/fetch.js.map +1 -1
- package/lib/commands/agent/mcp/get.js +8 -6
- package/lib/commands/agent/mcp/get.js.map +1 -1
- package/lib/commands/agent/mcp/list.js +12 -1
- package/lib/commands/agent/mcp/list.js.map +1 -1
- package/oclif.manifest.json +1007 -1007
- package/package.json +9 -9
- package/schemas/agent-mcp-create.json +3 -0
- package/schemas/agent-mcp-fetch.json +3 -0
package/oclif.manifest.json
CHANGED
|
@@ -1120,16 +1120,13 @@
|
|
|
1120
1120
|
"upload:adl:agent"
|
|
1121
1121
|
]
|
|
1122
1122
|
},
|
|
1123
|
-
"agent:
|
|
1123
|
+
"agent:mcp:create": {
|
|
1124
1124
|
"aliases": [],
|
|
1125
1125
|
"args": {},
|
|
1126
|
-
"description": "
|
|
1126
|
+
"description": "Registers an external Model Context Protocol (MCP) server with the API Catalog and discovers its assets (tools, prompts, and resources). Provide the server URL and, when the server requires it, OAuth authorization details. When the authorization type is OAUTH you must supply the identity provider, client ID, client secret, and scope.",
|
|
1127
1127
|
"examples": [
|
|
1128
|
-
"
|
|
1129
|
-
"
|
|
1130
|
-
"Be prompted for all required and optional agent properties; use your default org:\n<%= config.bin %> <%= command.id %> --full-interview",
|
|
1131
|
-
"Specify an existing agent spec file called \"specs/resortManagerAgent.yaml\", and then overwrite it with a new version that contains newly AI-generated topics based on the updated role information passed in with the --role flag:\n<%= config.bin %> <%= command.id %> --spec specs/resortManagerAgent.yaml --output-file specs/resortManagerAgent.yaml --role \"Field customer complaints, manage employee schedules, and ensure all resort operations are running smoothly\"",
|
|
1132
|
-
"Specify that the conversational tone of the agent is formal and to attach the \"resortmanager@myorg.com\" username to it; be prompted for the required properties and use your default org:\n<%= config.bin %> <%= command.id %> --tone formal --agent-user resortmanager@myorg.com"
|
|
1128
|
+
"Create an MCP server with no authentication:\n<%= config.bin %> <%= command.id %> --name myServer --server-url https://mcp.example.com --target-org myOrg",
|
|
1129
|
+
"Create an MCP server that uses OAuth authentication, piping the client secret from stdin to keep it out of shell history:\ncat secret.txt | <%= config.bin %> <%= command.id %> --name myServer --server-url https://mcp.example.com --auth-type OAUTH --identity-provider myIdp --client-id abc123 --client-secret - --scope \"read write\" --target-org myOrg"
|
|
1133
1130
|
],
|
|
1134
1131
|
"flags": {
|
|
1135
1132
|
"json": {
|
|
@@ -1164,164 +1161,113 @@
|
|
|
1164
1161
|
"multiple": false,
|
|
1165
1162
|
"type": "option"
|
|
1166
1163
|
},
|
|
1167
|
-
"
|
|
1168
|
-
"
|
|
1169
|
-
"
|
|
1170
|
-
"
|
|
1171
|
-
"
|
|
1172
|
-
"options": [
|
|
1173
|
-
"customer",
|
|
1174
|
-
"internal"
|
|
1175
|
-
],
|
|
1176
|
-
"type": "option"
|
|
1177
|
-
},
|
|
1178
|
-
"role": {
|
|
1179
|
-
"name": "role",
|
|
1180
|
-
"summary": "Role of the agent.",
|
|
1181
|
-
"hasDynamicHelp": false,
|
|
1182
|
-
"multiple": false,
|
|
1183
|
-
"type": "option"
|
|
1184
|
-
},
|
|
1185
|
-
"company-name": {
|
|
1186
|
-
"name": "company-name",
|
|
1187
|
-
"summary": "Name of your company.",
|
|
1188
|
-
"hasDynamicHelp": false,
|
|
1189
|
-
"multiple": false,
|
|
1190
|
-
"type": "option"
|
|
1191
|
-
},
|
|
1192
|
-
"company-description": {
|
|
1193
|
-
"name": "company-description",
|
|
1194
|
-
"summary": "Description of your company.",
|
|
1195
|
-
"hasDynamicHelp": false,
|
|
1196
|
-
"multiple": false,
|
|
1197
|
-
"type": "option"
|
|
1198
|
-
},
|
|
1199
|
-
"company-website": {
|
|
1200
|
-
"name": "company-website",
|
|
1201
|
-
"summary": "Website URL of your company.",
|
|
1164
|
+
"name": {
|
|
1165
|
+
"char": "n",
|
|
1166
|
+
"name": "name",
|
|
1167
|
+
"required": true,
|
|
1168
|
+
"summary": "Unique name of the MCP server.",
|
|
1202
1169
|
"hasDynamicHelp": false,
|
|
1203
1170
|
"multiple": false,
|
|
1204
1171
|
"type": "option"
|
|
1205
1172
|
},
|
|
1206
|
-
"
|
|
1207
|
-
"name": "
|
|
1208
|
-
"summary": "
|
|
1173
|
+
"label": {
|
|
1174
|
+
"name": "label",
|
|
1175
|
+
"summary": "Human-readable label for the MCP server.",
|
|
1209
1176
|
"hasDynamicHelp": false,
|
|
1210
1177
|
"multiple": false,
|
|
1211
1178
|
"type": "option"
|
|
1212
1179
|
},
|
|
1213
|
-
"
|
|
1214
|
-
"name": "
|
|
1215
|
-
"summary": "
|
|
1180
|
+
"description": {
|
|
1181
|
+
"name": "description",
|
|
1182
|
+
"summary": "Description of the MCP server.",
|
|
1216
1183
|
"hasDynamicHelp": false,
|
|
1217
1184
|
"multiple": false,
|
|
1218
1185
|
"type": "option"
|
|
1219
1186
|
},
|
|
1220
|
-
"
|
|
1221
|
-
"name": "
|
|
1222
|
-
"
|
|
1187
|
+
"server-url": {
|
|
1188
|
+
"name": "server-url",
|
|
1189
|
+
"required": true,
|
|
1190
|
+
"summary": "URL of the external MCP server.",
|
|
1223
1191
|
"hasDynamicHelp": false,
|
|
1224
1192
|
"multiple": false,
|
|
1225
|
-
"options": [
|
|
1226
|
-
"true",
|
|
1227
|
-
"false"
|
|
1228
|
-
],
|
|
1229
1193
|
"type": "option"
|
|
1230
1194
|
},
|
|
1231
|
-
"
|
|
1232
|
-
"name": "
|
|
1233
|
-
"summary": "
|
|
1195
|
+
"auth-type": {
|
|
1196
|
+
"name": "auth-type",
|
|
1197
|
+
"summary": "Authorization type to use when connecting to the MCP server.",
|
|
1198
|
+
"default": "NO_AUTH",
|
|
1234
1199
|
"hasDynamicHelp": false,
|
|
1235
1200
|
"multiple": false,
|
|
1236
1201
|
"options": [
|
|
1237
|
-
"
|
|
1238
|
-
"
|
|
1239
|
-
"neutral"
|
|
1202
|
+
"OAUTH",
|
|
1203
|
+
"NO_AUTH"
|
|
1240
1204
|
],
|
|
1241
1205
|
"type": "option"
|
|
1242
1206
|
},
|
|
1243
|
-
"
|
|
1244
|
-
"name": "
|
|
1245
|
-
"summary": "
|
|
1207
|
+
"identity-provider": {
|
|
1208
|
+
"name": "identity-provider",
|
|
1209
|
+
"summary": "Identity provider to use for OAuth authorization. Required when auth-type is OAUTH.",
|
|
1246
1210
|
"hasDynamicHelp": false,
|
|
1247
1211
|
"multiple": false,
|
|
1248
1212
|
"type": "option"
|
|
1249
1213
|
},
|
|
1250
|
-
"
|
|
1251
|
-
"name": "
|
|
1252
|
-
"summary": "
|
|
1253
|
-
"default": "specs/agentSpec.yaml",
|
|
1214
|
+
"client-id": {
|
|
1215
|
+
"name": "client-id",
|
|
1216
|
+
"summary": "OAuth client ID. Required when auth-type is OAUTH.",
|
|
1254
1217
|
"hasDynamicHelp": false,
|
|
1255
1218
|
"multiple": false,
|
|
1256
1219
|
"type": "option"
|
|
1257
1220
|
},
|
|
1258
|
-
"
|
|
1259
|
-
"name": "
|
|
1260
|
-
"summary": "
|
|
1261
|
-
"allowNo": false,
|
|
1262
|
-
"type": "boolean"
|
|
1263
|
-
},
|
|
1264
|
-
"prompt-template": {
|
|
1265
|
-
"name": "prompt-template",
|
|
1266
|
-
"summary": "API name of a customized prompt template to use instead of the default prompt template.",
|
|
1221
|
+
"client-secret": {
|
|
1222
|
+
"name": "client-secret",
|
|
1223
|
+
"summary": "OAuth client secret. Required when auth-type is OAUTH. Pass \"-\" to read it from stdin (piped) and keep it out of shell history.",
|
|
1267
1224
|
"hasDynamicHelp": false,
|
|
1268
1225
|
"multiple": false,
|
|
1269
1226
|
"type": "option"
|
|
1270
1227
|
},
|
|
1271
|
-
"
|
|
1272
|
-
"
|
|
1273
|
-
|
|
1274
|
-
],
|
|
1275
|
-
"name": "grounding-context",
|
|
1276
|
-
"summary": "Context information and personalization that's added to your prompts when using a custom prompt template.",
|
|
1228
|
+
"scope": {
|
|
1229
|
+
"name": "scope",
|
|
1230
|
+
"summary": "OAuth scope to request. Required when auth-type is OAUTH.",
|
|
1277
1231
|
"hasDynamicHelp": false,
|
|
1278
1232
|
"multiple": false,
|
|
1279
1233
|
"type": "option"
|
|
1280
|
-
},
|
|
1281
|
-
"force-overwrite": {
|
|
1282
|
-
"name": "force-overwrite",
|
|
1283
|
-
"summary": "Don't prompt the user to confirm that an existing spec file will be overwritten.",
|
|
1284
|
-
"allowNo": false,
|
|
1285
|
-
"type": "boolean"
|
|
1286
1234
|
}
|
|
1287
1235
|
},
|
|
1288
1236
|
"hasDynamicHelp": true,
|
|
1289
1237
|
"hiddenAliases": [],
|
|
1290
|
-
"id": "agent:
|
|
1238
|
+
"id": "agent:mcp:create",
|
|
1291
1239
|
"pluginAlias": "@salesforce/plugin-agent",
|
|
1292
1240
|
"pluginName": "@salesforce/plugin-agent",
|
|
1293
1241
|
"pluginType": "core",
|
|
1242
|
+
"state": "preview",
|
|
1294
1243
|
"strict": true,
|
|
1295
|
-
"summary": "
|
|
1244
|
+
"summary": "Create an MCP server in the API Catalog.",
|
|
1296
1245
|
"enableJsonFlag": true,
|
|
1297
|
-
"requiresProject": true,
|
|
1298
1246
|
"isESM": true,
|
|
1299
1247
|
"relativePath": [
|
|
1300
1248
|
"lib",
|
|
1301
1249
|
"commands",
|
|
1302
1250
|
"agent",
|
|
1303
|
-
"
|
|
1304
|
-
"
|
|
1251
|
+
"mcp",
|
|
1252
|
+
"create.js"
|
|
1305
1253
|
],
|
|
1306
1254
|
"aliasPermutations": [],
|
|
1307
1255
|
"permutations": [
|
|
1308
|
-
"agent:
|
|
1309
|
-
"
|
|
1310
|
-
"
|
|
1311
|
-
"agent:
|
|
1312
|
-
"
|
|
1313
|
-
"
|
|
1256
|
+
"agent:mcp:create",
|
|
1257
|
+
"mcp:agent:create",
|
|
1258
|
+
"mcp:create:agent",
|
|
1259
|
+
"agent:create:mcp",
|
|
1260
|
+
"create:agent:mcp",
|
|
1261
|
+
"create:mcp:agent"
|
|
1314
1262
|
]
|
|
1315
1263
|
},
|
|
1316
|
-
"agent:
|
|
1264
|
+
"agent:mcp:delete": {
|
|
1317
1265
|
"aliases": [],
|
|
1318
1266
|
"args": {},
|
|
1319
|
-
"description": "
|
|
1267
|
+
"description": "Permanently removes an MCP (Model Context Protocol) server registration from the API Catalog, identified by its ID. By default you are prompted to confirm the deletion; pass --no-prompt to skip the confirmation (for example in scripts and CI).",
|
|
1320
1268
|
"examples": [
|
|
1321
|
-
"
|
|
1322
|
-
"
|
|
1323
|
-
"Generate an authoring bundle from the \"specs/agentSpec.yaml\" agent spec YAML file and give it the label \"My Authoring Bundle\"; use your default org:\n<%= config.bin %> <%= command.id %> --spec specs/agentSpec.yaml --name \"My Authoring Bundle\"",
|
|
1324
|
-
"Similar to previous example, but generate the authoring bundle files in the \"other-package-dir/main/default\" package directory; use the org with alias \"my-dev-org\":\n<%= config.bin %> <%= command.id %> --spec specs/agentSpec.yaml --name \"My Authoring Bundle\" --output-dir other-package-dir/main/default --target-org my-dev-org"
|
|
1269
|
+
"Delete an MCP server, confirming interactively:\n<%= config.bin %> <%= command.id %> --mcp-server-id 0XSxx0000000001 --target-org myOrg",
|
|
1270
|
+
"Delete an MCP server without a confirmation prompt:\n<%= config.bin %> <%= command.id %> --mcp-server-id 0XSxx0000000001 --target-org myOrg --no-prompt"
|
|
1325
1271
|
],
|
|
1326
1272
|
"flags": {
|
|
1327
1273
|
"json": {
|
|
@@ -1349,13 +1295,6 @@
|
|
|
1349
1295
|
"multiple": false,
|
|
1350
1296
|
"type": "option"
|
|
1351
1297
|
},
|
|
1352
|
-
"api-name": {
|
|
1353
|
-
"name": "api-name",
|
|
1354
|
-
"summary": "API name of the new authoring bundle; if not specified, the API name is derived from the authoring bundle name (label); the API name can't exist in the org.",
|
|
1355
|
-
"hasDynamicHelp": false,
|
|
1356
|
-
"multiple": false,
|
|
1357
|
-
"type": "option"
|
|
1358
|
-
},
|
|
1359
1298
|
"api-version": {
|
|
1360
1299
|
"description": "Override the api version used for api requests made by this command",
|
|
1361
1300
|
"name": "api-version",
|
|
@@ -1363,77 +1302,57 @@
|
|
|
1363
1302
|
"multiple": false,
|
|
1364
1303
|
"type": "option"
|
|
1365
1304
|
},
|
|
1366
|
-
"
|
|
1367
|
-
"char": "
|
|
1368
|
-
"name": "
|
|
1369
|
-
"
|
|
1370
|
-
"
|
|
1371
|
-
"multiple": false,
|
|
1372
|
-
"type": "option"
|
|
1373
|
-
},
|
|
1374
|
-
"no-spec": {
|
|
1375
|
-
"name": "no-spec",
|
|
1376
|
-
"summary": "Skip prompting for an agent spec and use the default Agent Script boilerplate in the generated authoring bundle.",
|
|
1377
|
-
"allowNo": false,
|
|
1378
|
-
"type": "boolean"
|
|
1379
|
-
},
|
|
1380
|
-
"output-dir": {
|
|
1381
|
-
"char": "d",
|
|
1382
|
-
"name": "output-dir",
|
|
1383
|
-
"summary": "Directory where the authoring bundle files are generated.",
|
|
1384
|
-
"hasDynamicHelp": false,
|
|
1385
|
-
"multiple": false,
|
|
1386
|
-
"type": "option"
|
|
1387
|
-
},
|
|
1388
|
-
"name": {
|
|
1389
|
-
"char": "n",
|
|
1390
|
-
"name": "name",
|
|
1391
|
-
"summary": "Name (label) of the authoring bundle; if not specified, you're prompted for the name.",
|
|
1305
|
+
"mcp-server-id": {
|
|
1306
|
+
"char": "i",
|
|
1307
|
+
"name": "mcp-server-id",
|
|
1308
|
+
"required": true,
|
|
1309
|
+
"summary": "ID of the MCP server to delete.",
|
|
1392
1310
|
"hasDynamicHelp": false,
|
|
1393
1311
|
"multiple": false,
|
|
1394
1312
|
"type": "option"
|
|
1395
1313
|
},
|
|
1396
|
-
"
|
|
1397
|
-
"name": "
|
|
1398
|
-
"summary": "
|
|
1314
|
+
"no-prompt": {
|
|
1315
|
+
"name": "no-prompt",
|
|
1316
|
+
"summary": "Skip the confirmation prompt and delete the MCP server immediately.",
|
|
1399
1317
|
"allowNo": false,
|
|
1400
1318
|
"type": "boolean"
|
|
1401
1319
|
}
|
|
1402
1320
|
},
|
|
1403
1321
|
"hasDynamicHelp": true,
|
|
1404
1322
|
"hiddenAliases": [],
|
|
1405
|
-
"id": "agent:
|
|
1323
|
+
"id": "agent:mcp:delete",
|
|
1406
1324
|
"pluginAlias": "@salesforce/plugin-agent",
|
|
1407
1325
|
"pluginName": "@salesforce/plugin-agent",
|
|
1408
1326
|
"pluginType": "core",
|
|
1327
|
+
"state": "preview",
|
|
1409
1328
|
"strict": true,
|
|
1410
|
-
"summary": "
|
|
1329
|
+
"summary": "Delete an MCP server from the API Catalog.",
|
|
1411
1330
|
"enableJsonFlag": true,
|
|
1412
|
-
"requiresProject": true,
|
|
1413
1331
|
"isESM": true,
|
|
1414
1332
|
"relativePath": [
|
|
1415
1333
|
"lib",
|
|
1416
1334
|
"commands",
|
|
1417
1335
|
"agent",
|
|
1418
|
-
"
|
|
1419
|
-
"
|
|
1336
|
+
"mcp",
|
|
1337
|
+
"delete.js"
|
|
1420
1338
|
],
|
|
1421
1339
|
"aliasPermutations": [],
|
|
1422
1340
|
"permutations": [
|
|
1423
|
-
"agent:
|
|
1424
|
-
"
|
|
1425
|
-
"
|
|
1426
|
-
"agent:
|
|
1427
|
-
"
|
|
1428
|
-
"
|
|
1341
|
+
"agent:mcp:delete",
|
|
1342
|
+
"mcp:agent:delete",
|
|
1343
|
+
"mcp:delete:agent",
|
|
1344
|
+
"agent:delete:mcp",
|
|
1345
|
+
"delete:agent:mcp",
|
|
1346
|
+
"delete:mcp:agent"
|
|
1429
1347
|
]
|
|
1430
1348
|
},
|
|
1431
|
-
"agent:
|
|
1349
|
+
"agent:mcp:fetch": {
|
|
1432
1350
|
"aliases": [],
|
|
1433
1351
|
"args": {},
|
|
1434
|
-
"description": "
|
|
1352
|
+
"description": "Performs a live fetch against the configured MCP server identified by its ID, returning the assets (MCP tools, prompts, and resources) it currently advertises along with their status and activation state. Use this to refresh the view of what an MCP server exposes before activating its assets as agent actions.",
|
|
1435
1353
|
"examples": [
|
|
1436
|
-
"
|
|
1354
|
+
"Fetch the assets advertised by an MCP server in the default target org:\n<%= config.bin %> <%= command.id %> --target-org myOrg --mcp-server-id 0XSxx0000000001",
|
|
1355
|
+
"Fetch MCP server assets and output as JSON:\n<%= config.bin %> <%= command.id %> --target-org myOrg --mcp-server-id 0XSxx0000000001 --json"
|
|
1437
1356
|
],
|
|
1438
1357
|
"flags": {
|
|
1439
1358
|
"json": {
|
|
@@ -1451,44 +1370,107 @@
|
|
|
1451
1370
|
"multiple": false,
|
|
1452
1371
|
"type": "option"
|
|
1453
1372
|
},
|
|
1454
|
-
"
|
|
1455
|
-
"
|
|
1456
|
-
"name": "
|
|
1457
|
-
"hasDynamicHelp": false,
|
|
1458
|
-
"multiple": false,
|
|
1459
|
-
"type": "option"
|
|
1460
|
-
},
|
|
1461
|
-
"source-org": {
|
|
1462
|
-
"char": "s",
|
|
1463
|
-
"name": "source-org",
|
|
1373
|
+
"target-org": {
|
|
1374
|
+
"char": "o",
|
|
1375
|
+
"name": "target-org",
|
|
1464
1376
|
"noCacheDefault": true,
|
|
1465
1377
|
"required": true,
|
|
1466
|
-
"summary": "Username or alias of the
|
|
1378
|
+
"summary": "Username or alias of the target org. Not required if the `target-org` configuration variable is already set.",
|
|
1467
1379
|
"hasDynamicHelp": true,
|
|
1468
1380
|
"multiple": false,
|
|
1469
1381
|
"type": "option"
|
|
1470
1382
|
},
|
|
1471
|
-
"
|
|
1472
|
-
"
|
|
1473
|
-
"
|
|
1474
|
-
"summary": "Version of the agent (BotVersion).",
|
|
1383
|
+
"api-version": {
|
|
1384
|
+
"description": "Override the api version used for api requests made by this command",
|
|
1385
|
+
"name": "api-version",
|
|
1475
1386
|
"hasDynamicHelp": false,
|
|
1476
1387
|
"multiple": false,
|
|
1477
1388
|
"type": "option"
|
|
1478
1389
|
},
|
|
1479
|
-
"
|
|
1480
|
-
"char": "
|
|
1481
|
-
"name": "
|
|
1390
|
+
"mcp-server-id": {
|
|
1391
|
+
"char": "i",
|
|
1392
|
+
"name": "mcp-server-id",
|
|
1482
1393
|
"required": true,
|
|
1483
|
-
"summary": "
|
|
1394
|
+
"summary": "ID of the MCP server to fetch assets from.",
|
|
1395
|
+
"hasDynamicHelp": false,
|
|
1396
|
+
"multiple": false,
|
|
1397
|
+
"type": "option"
|
|
1398
|
+
}
|
|
1399
|
+
},
|
|
1400
|
+
"hasDynamicHelp": true,
|
|
1401
|
+
"hiddenAliases": [],
|
|
1402
|
+
"id": "agent:mcp:fetch",
|
|
1403
|
+
"pluginAlias": "@salesforce/plugin-agent",
|
|
1404
|
+
"pluginName": "@salesforce/plugin-agent",
|
|
1405
|
+
"pluginType": "core",
|
|
1406
|
+
"state": "preview",
|
|
1407
|
+
"strict": true,
|
|
1408
|
+
"summary": "Fetch the live assets (tools, prompts, resources) advertised by an MCP server.",
|
|
1409
|
+
"enableJsonFlag": true,
|
|
1410
|
+
"isESM": true,
|
|
1411
|
+
"relativePath": [
|
|
1412
|
+
"lib",
|
|
1413
|
+
"commands",
|
|
1414
|
+
"agent",
|
|
1415
|
+
"mcp",
|
|
1416
|
+
"fetch.js"
|
|
1417
|
+
],
|
|
1418
|
+
"aliasPermutations": [],
|
|
1419
|
+
"permutations": [
|
|
1420
|
+
"agent:mcp:fetch",
|
|
1421
|
+
"mcp:agent:fetch",
|
|
1422
|
+
"mcp:fetch:agent",
|
|
1423
|
+
"agent:fetch:mcp",
|
|
1424
|
+
"fetch:agent:mcp",
|
|
1425
|
+
"fetch:mcp:agent"
|
|
1426
|
+
]
|
|
1427
|
+
},
|
|
1428
|
+
"agent:mcp:get": {
|
|
1429
|
+
"aliases": [],
|
|
1430
|
+
"args": {},
|
|
1431
|
+
"description": "Retrieves the details of an MCP (Model Context Protocol) server by its identifier, including its name, label, type, status, and server URL.",
|
|
1432
|
+
"examples": [
|
|
1433
|
+
"Get an MCP server by id in the default target org:\n<%= config.bin %> <%= command.id %> --target-org myOrg --mcp-server-id 0Mx000000000001",
|
|
1434
|
+
"Get an MCP server and output as JSON:\n<%= config.bin %> <%= command.id %> --target-org myOrg --mcp-server-id 0Mx000000000001 --json"
|
|
1435
|
+
],
|
|
1436
|
+
"flags": {
|
|
1437
|
+
"json": {
|
|
1438
|
+
"description": "Format output as json.",
|
|
1439
|
+
"helpGroup": "GLOBAL",
|
|
1440
|
+
"name": "json",
|
|
1441
|
+
"allowNo": false,
|
|
1442
|
+
"type": "boolean"
|
|
1443
|
+
},
|
|
1444
|
+
"flags-dir": {
|
|
1445
|
+
"helpGroup": "GLOBAL",
|
|
1446
|
+
"name": "flags-dir",
|
|
1447
|
+
"summary": "Import flag values from a directory.",
|
|
1484
1448
|
"hasDynamicHelp": false,
|
|
1485
1449
|
"multiple": false,
|
|
1486
1450
|
"type": "option"
|
|
1487
1451
|
},
|
|
1488
|
-
"
|
|
1489
|
-
"char": "
|
|
1490
|
-
"name": "
|
|
1491
|
-
"
|
|
1452
|
+
"target-org": {
|
|
1453
|
+
"char": "o",
|
|
1454
|
+
"name": "target-org",
|
|
1455
|
+
"noCacheDefault": true,
|
|
1456
|
+
"required": true,
|
|
1457
|
+
"summary": "Username or alias of the target org. Not required if the `target-org` configuration variable is already set.",
|
|
1458
|
+
"hasDynamicHelp": true,
|
|
1459
|
+
"multiple": false,
|
|
1460
|
+
"type": "option"
|
|
1461
|
+
},
|
|
1462
|
+
"api-version": {
|
|
1463
|
+
"description": "Override the api version used for api requests made by this command",
|
|
1464
|
+
"name": "api-version",
|
|
1465
|
+
"hasDynamicHelp": false,
|
|
1466
|
+
"multiple": false,
|
|
1467
|
+
"type": "option"
|
|
1468
|
+
},
|
|
1469
|
+
"mcp-server-id": {
|
|
1470
|
+
"char": "i",
|
|
1471
|
+
"name": "mcp-server-id",
|
|
1472
|
+
"required": true,
|
|
1473
|
+
"summary": "The identifier of the MCP server to retrieve.",
|
|
1492
1474
|
"hasDynamicHelp": false,
|
|
1493
1475
|
"multiple": false,
|
|
1494
1476
|
"type": "option"
|
|
@@ -1496,44 +1478,48 @@
|
|
|
1496
1478
|
},
|
|
1497
1479
|
"hasDynamicHelp": true,
|
|
1498
1480
|
"hiddenAliases": [],
|
|
1499
|
-
"id": "agent:
|
|
1481
|
+
"id": "agent:mcp:get",
|
|
1500
1482
|
"pluginAlias": "@salesforce/plugin-agent",
|
|
1501
1483
|
"pluginName": "@salesforce/plugin-agent",
|
|
1502
1484
|
"pluginType": "core",
|
|
1485
|
+
"state": "preview",
|
|
1503
1486
|
"strict": true,
|
|
1504
|
-
"summary": "
|
|
1487
|
+
"summary": "Get a single MCP server registered in the API Catalog.",
|
|
1505
1488
|
"enableJsonFlag": true,
|
|
1506
|
-
"requiresProject": true,
|
|
1507
1489
|
"isESM": true,
|
|
1508
1490
|
"relativePath": [
|
|
1509
1491
|
"lib",
|
|
1510
1492
|
"commands",
|
|
1511
1493
|
"agent",
|
|
1512
|
-
"
|
|
1513
|
-
"
|
|
1494
|
+
"mcp",
|
|
1495
|
+
"get.js"
|
|
1514
1496
|
],
|
|
1515
1497
|
"aliasPermutations": [],
|
|
1516
1498
|
"permutations": [
|
|
1517
|
-
"agent:
|
|
1518
|
-
"
|
|
1519
|
-
"
|
|
1520
|
-
"agent:
|
|
1521
|
-
"
|
|
1522
|
-
"
|
|
1499
|
+
"agent:mcp:get",
|
|
1500
|
+
"mcp:agent:get",
|
|
1501
|
+
"mcp:get:agent",
|
|
1502
|
+
"agent:get:mcp",
|
|
1503
|
+
"get:agent:mcp",
|
|
1504
|
+
"get:mcp:agent"
|
|
1523
1505
|
]
|
|
1524
1506
|
},
|
|
1525
|
-
"agent:
|
|
1507
|
+
"agent:mcp:list": {
|
|
1526
1508
|
"aliases": [],
|
|
1527
1509
|
"args": {},
|
|
1528
|
-
"description": "
|
|
1510
|
+
"description": "Returns the Model Context Protocol (MCP) servers registered in the API Catalog, optionally filtered by label, type, or status. Use this to discover which MCP servers are available and inspect their server URLs and current status.",
|
|
1529
1511
|
"examples": [
|
|
1530
|
-
"
|
|
1531
|
-
"
|
|
1532
|
-
"Generate an agent test spec YAML file and specify a name for the new file; if the file exists, overwrite it without confirmation:\n<%= config.bin %> <%= command.id %> --output-file specs/Resort_Manager-new-version-testSpec.yaml --force-overwrite",
|
|
1533
|
-
"Generate an agent test spec YAML file from an existing AiEvaluationDefinition metadata XML file in your DX project:\n<%= config.bin %> <%= command.id %> --from-definition force-app/main/default/aiEvaluationDefinitions/Resort_Manager_Tests.aiEvaluationDefinition-meta.xml",
|
|
1534
|
-
"Generate an Agentforce Studio (NGT) test spec YAML file from an existing AiTestingDefinition metadata XML file:\n<%= config.bin %> <%= command.id %> --from-definition force-app/main/default/aiTestingDefinitions/Returns_Checkout_Tests.aiTestingDefinition-meta.xml"
|
|
1512
|
+
"List all MCP servers in the default target org:\n<%= config.bin %> <%= command.id %> --target-org myOrg",
|
|
1513
|
+
"List external MCP servers filtered by status and output as JSON:\n<%= config.bin %> <%= command.id %> --target-org myOrg --type EXTERNAL --status ACTIVE --json"
|
|
1535
1514
|
],
|
|
1536
1515
|
"flags": {
|
|
1516
|
+
"json": {
|
|
1517
|
+
"description": "Format output as json.",
|
|
1518
|
+
"helpGroup": "GLOBAL",
|
|
1519
|
+
"name": "json",
|
|
1520
|
+
"allowNo": false,
|
|
1521
|
+
"type": "boolean"
|
|
1522
|
+
},
|
|
1537
1523
|
"flags-dir": {
|
|
1538
1524
|
"helpGroup": "GLOBAL",
|
|
1539
1525
|
"name": "flags-dir",
|
|
@@ -1542,75 +1528,87 @@
|
|
|
1542
1528
|
"multiple": false,
|
|
1543
1529
|
"type": "option"
|
|
1544
1530
|
},
|
|
1545
|
-
"
|
|
1546
|
-
"char": "
|
|
1547
|
-
"name": "
|
|
1548
|
-
"
|
|
1531
|
+
"target-org": {
|
|
1532
|
+
"char": "o",
|
|
1533
|
+
"name": "target-org",
|
|
1534
|
+
"noCacheDefault": true,
|
|
1535
|
+
"required": true,
|
|
1536
|
+
"summary": "Username or alias of the target org. Not required if the `target-org` configuration variable is already set.",
|
|
1537
|
+
"hasDynamicHelp": true,
|
|
1538
|
+
"multiple": false,
|
|
1539
|
+
"type": "option"
|
|
1540
|
+
},
|
|
1541
|
+
"api-version": {
|
|
1542
|
+
"description": "Override the api version used for api requests made by this command",
|
|
1543
|
+
"name": "api-version",
|
|
1549
1544
|
"hasDynamicHelp": false,
|
|
1550
1545
|
"multiple": false,
|
|
1551
1546
|
"type": "option"
|
|
1552
1547
|
},
|
|
1553
|
-
"
|
|
1554
|
-
"name": "
|
|
1555
|
-
"summary": "
|
|
1556
|
-
"
|
|
1557
|
-
"
|
|
1548
|
+
"label": {
|
|
1549
|
+
"name": "label",
|
|
1550
|
+
"summary": "Filter the MCP servers by label.",
|
|
1551
|
+
"hasDynamicHelp": false,
|
|
1552
|
+
"multiple": false,
|
|
1553
|
+
"type": "option"
|
|
1558
1554
|
},
|
|
1559
|
-
"
|
|
1560
|
-
"
|
|
1561
|
-
"
|
|
1562
|
-
"summary": "Name of the generated test spec YAML file. Default value is \"specs/<AGENT_API_NAME>-testSpec.yaml\" (legacy) or \"specs/<AGENT_API_NAME>-ngtTestSpec.yaml\" (Agentforce Studio).",
|
|
1555
|
+
"type": {
|
|
1556
|
+
"name": "type",
|
|
1557
|
+
"summary": "Filter the MCP servers by type.",
|
|
1563
1558
|
"hasDynamicHelp": false,
|
|
1564
1559
|
"multiple": false,
|
|
1560
|
+
"options": [
|
|
1561
|
+
"EXTERNAL"
|
|
1562
|
+
],
|
|
1565
1563
|
"type": "option"
|
|
1566
1564
|
},
|
|
1567
|
-
"
|
|
1568
|
-
"
|
|
1569
|
-
"
|
|
1570
|
-
"summary": "Explicitly specify which test runner to use (agentforce-studio or testing-center).",
|
|
1565
|
+
"status": {
|
|
1566
|
+
"name": "status",
|
|
1567
|
+
"summary": "Filter the MCP servers by connection status. Only ACTIVE and DISCONNECTED are supported as filters.",
|
|
1571
1568
|
"hasDynamicHelp": false,
|
|
1572
1569
|
"multiple": false,
|
|
1573
1570
|
"options": [
|
|
1574
|
-
"
|
|
1575
|
-
"
|
|
1571
|
+
"ACTIVE",
|
|
1572
|
+
"DISCONNECTED"
|
|
1576
1573
|
],
|
|
1577
1574
|
"type": "option"
|
|
1578
1575
|
}
|
|
1579
1576
|
},
|
|
1580
|
-
"hasDynamicHelp":
|
|
1577
|
+
"hasDynamicHelp": true,
|
|
1581
1578
|
"hiddenAliases": [],
|
|
1582
|
-
"id": "agent:
|
|
1579
|
+
"id": "agent:mcp:list",
|
|
1583
1580
|
"pluginAlias": "@salesforce/plugin-agent",
|
|
1584
1581
|
"pluginName": "@salesforce/plugin-agent",
|
|
1585
1582
|
"pluginType": "core",
|
|
1583
|
+
"state": "preview",
|
|
1586
1584
|
"strict": true,
|
|
1587
|
-
"summary": "
|
|
1588
|
-
"enableJsonFlag":
|
|
1585
|
+
"summary": "List the MCP servers registered in the API Catalog.",
|
|
1586
|
+
"enableJsonFlag": true,
|
|
1589
1587
|
"isESM": true,
|
|
1590
1588
|
"relativePath": [
|
|
1591
1589
|
"lib",
|
|
1592
1590
|
"commands",
|
|
1593
1591
|
"agent",
|
|
1594
|
-
"
|
|
1595
|
-
"
|
|
1592
|
+
"mcp",
|
|
1593
|
+
"list.js"
|
|
1596
1594
|
],
|
|
1597
1595
|
"aliasPermutations": [],
|
|
1598
1596
|
"permutations": [
|
|
1599
|
-
"agent:
|
|
1600
|
-
"
|
|
1601
|
-
"
|
|
1602
|
-
"agent:
|
|
1603
|
-
"
|
|
1604
|
-
"
|
|
1597
|
+
"agent:mcp:list",
|
|
1598
|
+
"mcp:agent:list",
|
|
1599
|
+
"mcp:list:agent",
|
|
1600
|
+
"agent:list:mcp",
|
|
1601
|
+
"list:agent:mcp",
|
|
1602
|
+
"list:mcp:agent"
|
|
1605
1603
|
]
|
|
1606
1604
|
},
|
|
1607
|
-
"agent:mcp:
|
|
1605
|
+
"agent:mcp:update": {
|
|
1608
1606
|
"aliases": [],
|
|
1609
1607
|
"args": {},
|
|
1610
|
-
"description": "
|
|
1608
|
+
"description": "Updates an existing MCP server in the API Catalog. Only the fields you provide are changed; omitted fields are left untouched. You can update the label, description, and server URL, and replace the authorization configuration. When setting `--auth-type OAUTH`, you must also provide `--identity-provider`, `--client-id`, `--client-secret`, and `--scope`. When setting `--auth-type NO_AUTH`, no authorization credentials are required. At least one updatable field must be supplied.",
|
|
1611
1609
|
"examples": [
|
|
1612
|
-
"
|
|
1613
|
-
"
|
|
1610
|
+
"Update the label and description of an MCP server in the default target org:\n<%= config.bin %> <%= command.id %> --mcp-server-id 0XSxx0000000001 --label \"Orders MCP\" --description \"Order tooling\" --target-org myOrg",
|
|
1611
|
+
"Update the server URL and switch the authorization to OAuth, piping the client secret from stdin and outputting as JSON:\ncat secret.txt | <%= config.bin %> <%= command.id %> --mcp-server-id 0XSxx0000000001 --server-url https://mcp.example.com --auth-type OAUTH --identity-provider MyIdp --client-id abc --client-secret - --scope \"read write\" --target-org myOrg --json"
|
|
1614
1612
|
],
|
|
1615
1613
|
"flags": {
|
|
1616
1614
|
"json": {
|
|
@@ -1645,41 +1643,39 @@
|
|
|
1645
1643
|
"multiple": false,
|
|
1646
1644
|
"type": "option"
|
|
1647
1645
|
},
|
|
1648
|
-
"
|
|
1649
|
-
"char": "
|
|
1650
|
-
"name": "
|
|
1646
|
+
"mcp-server-id": {
|
|
1647
|
+
"char": "i",
|
|
1648
|
+
"name": "mcp-server-id",
|
|
1651
1649
|
"required": true,
|
|
1652
|
-
"summary": "
|
|
1650
|
+
"summary": "ID of the MCP server to update.",
|
|
1653
1651
|
"hasDynamicHelp": false,
|
|
1654
1652
|
"multiple": false,
|
|
1655
1653
|
"type": "option"
|
|
1656
1654
|
},
|
|
1657
1655
|
"label": {
|
|
1658
1656
|
"name": "label",
|
|
1659
|
-
"summary": "
|
|
1657
|
+
"summary": "New display label for the MCP server.",
|
|
1660
1658
|
"hasDynamicHelp": false,
|
|
1661
1659
|
"multiple": false,
|
|
1662
1660
|
"type": "option"
|
|
1663
1661
|
},
|
|
1664
1662
|
"description": {
|
|
1665
1663
|
"name": "description",
|
|
1666
|
-
"summary": "
|
|
1664
|
+
"summary": "New description for the MCP server.",
|
|
1667
1665
|
"hasDynamicHelp": false,
|
|
1668
1666
|
"multiple": false,
|
|
1669
1667
|
"type": "option"
|
|
1670
1668
|
},
|
|
1671
1669
|
"server-url": {
|
|
1672
1670
|
"name": "server-url",
|
|
1673
|
-
"
|
|
1674
|
-
"summary": "URL of the external MCP server.",
|
|
1671
|
+
"summary": "New endpoint URL of the MCP server.",
|
|
1675
1672
|
"hasDynamicHelp": false,
|
|
1676
1673
|
"multiple": false,
|
|
1677
1674
|
"type": "option"
|
|
1678
1675
|
},
|
|
1679
1676
|
"auth-type": {
|
|
1680
1677
|
"name": "auth-type",
|
|
1681
|
-
"summary": "Authorization type to
|
|
1682
|
-
"default": "NO_AUTH",
|
|
1678
|
+
"summary": "Authorization type to apply to the MCP server (OAUTH or NO_AUTH).",
|
|
1683
1679
|
"hasDynamicHelp": false,
|
|
1684
1680
|
"multiple": false,
|
|
1685
1681
|
"options": [
|
|
@@ -1690,28 +1686,28 @@
|
|
|
1690
1686
|
},
|
|
1691
1687
|
"identity-provider": {
|
|
1692
1688
|
"name": "identity-provider",
|
|
1693
|
-
"summary": "Identity provider
|
|
1689
|
+
"summary": "Identity provider name for OAuth authorization (required when --auth-type is OAUTH).",
|
|
1694
1690
|
"hasDynamicHelp": false,
|
|
1695
1691
|
"multiple": false,
|
|
1696
1692
|
"type": "option"
|
|
1697
1693
|
},
|
|
1698
1694
|
"client-id": {
|
|
1699
1695
|
"name": "client-id",
|
|
1700
|
-
"summary": "OAuth client ID
|
|
1696
|
+
"summary": "OAuth client ID (required when --auth-type is OAUTH).",
|
|
1701
1697
|
"hasDynamicHelp": false,
|
|
1702
1698
|
"multiple": false,
|
|
1703
1699
|
"type": "option"
|
|
1704
1700
|
},
|
|
1705
1701
|
"client-secret": {
|
|
1706
1702
|
"name": "client-secret",
|
|
1707
|
-
"summary": "OAuth client secret
|
|
1703
|
+
"summary": "OAuth client secret (required when --auth-type is OAUTH). Pass \"-\" to read it from stdin (piped) and keep it out of shell history.",
|
|
1708
1704
|
"hasDynamicHelp": false,
|
|
1709
1705
|
"multiple": false,
|
|
1710
1706
|
"type": "option"
|
|
1711
1707
|
},
|
|
1712
1708
|
"scope": {
|
|
1713
1709
|
"name": "scope",
|
|
1714
|
-
"summary": "OAuth scope
|
|
1710
|
+
"summary": "OAuth scope (required when --auth-type is OAUTH).",
|
|
1715
1711
|
"hasDynamicHelp": false,
|
|
1716
1712
|
"multiple": false,
|
|
1717
1713
|
"type": "option"
|
|
@@ -1719,13 +1715,13 @@
|
|
|
1719
1715
|
},
|
|
1720
1716
|
"hasDynamicHelp": true,
|
|
1721
1717
|
"hiddenAliases": [],
|
|
1722
|
-
"id": "agent:mcp:
|
|
1718
|
+
"id": "agent:mcp:update",
|
|
1723
1719
|
"pluginAlias": "@salesforce/plugin-agent",
|
|
1724
1720
|
"pluginName": "@salesforce/plugin-agent",
|
|
1725
1721
|
"pluginType": "core",
|
|
1726
1722
|
"state": "preview",
|
|
1727
1723
|
"strict": true,
|
|
1728
|
-
"summary": "
|
|
1724
|
+
"summary": "Update an MCP server registered in the API Catalog.",
|
|
1729
1725
|
"enableJsonFlag": true,
|
|
1730
1726
|
"isESM": true,
|
|
1731
1727
|
"relativePath": [
|
|
@@ -1733,25 +1729,28 @@
|
|
|
1733
1729
|
"commands",
|
|
1734
1730
|
"agent",
|
|
1735
1731
|
"mcp",
|
|
1736
|
-
"
|
|
1732
|
+
"update.js"
|
|
1737
1733
|
],
|
|
1738
1734
|
"aliasPermutations": [],
|
|
1739
1735
|
"permutations": [
|
|
1740
|
-
"agent:mcp:
|
|
1741
|
-
"mcp:agent:
|
|
1742
|
-
"mcp:
|
|
1743
|
-
"agent:
|
|
1744
|
-
"
|
|
1745
|
-
"
|
|
1736
|
+
"agent:mcp:update",
|
|
1737
|
+
"mcp:agent:update",
|
|
1738
|
+
"mcp:update:agent",
|
|
1739
|
+
"agent:update:mcp",
|
|
1740
|
+
"update:agent:mcp",
|
|
1741
|
+
"update:mcp:agent"
|
|
1746
1742
|
]
|
|
1747
1743
|
},
|
|
1748
|
-
"agent:
|
|
1744
|
+
"agent:generate:agent-spec": {
|
|
1749
1745
|
"aliases": [],
|
|
1750
1746
|
"args": {},
|
|
1751
|
-
"description": "
|
|
1747
|
+
"description": "An agent spec is a YAML-formatted file that contains basic information about the agent, such as its role, company description, and an AI-generated list of topics based on this information. Topics define the range of jobs your agent can handle.\n\nUse flags, such as --role and --company-description, to provide details about your company and the role that the agent plays in your company. If you prefer, you can also be prompted for the basic information; use --full-interview to be prompted for all required and optional properties. Upon command execution, the large language model (LLM) associated with your org uses the provided information to generate a list of topics for the agent. Because the LLM uses the company and role information to generate the topics, we recommend that you provide accurate, complete, and specific details so the LLM generates the best and most relevant topics. Once generated, you can edit the spec file; for example, you can remove topics that don't apply or change a topic's description.\n\nYou can also iterate the spec generation process by using the --spec flag to pass an existing agent spec file to this command, and then using the --role, --company-description, etc, flags to refine your agent properties. Iteratively improving the description of your agent allows the LLM to generate progressively better topics.\n\nYou can also specify other agent properties, such as a custom prompt template, how to ground the prompt template to add context to the agent's prompts, the tone of the prompts, and the username of a user in the org to assign to the agent.\n\nWhen your agent spec is ready, generate an authoring bundle from it by passing the spec file to the --spec flag of the \"agent generate authoring-bundle\" CLI command. An authoring bundle is a metadata type that contains an Agent Script file, which is the blueprint for an agent. (While not recommended, you can also use the agent spec file to immediately create an agent with the \"agent create\" command. We don't recommend this workflow because these types of agents don't use Agent Script, and are thus less flexible and more difficult to maintain.)",
|
|
1752
1748
|
"examples": [
|
|
1753
|
-
"
|
|
1754
|
-
"
|
|
1749
|
+
"Generate an agent spec in the default location and use flags to specify the agent properties, such as its role and your company details; use your default org:\n<%= config.bin %> <%= command.id %> --type customer --role \"Field customer complaints and manage employee schedules.\" --company-name \"Coral Cloud Resorts\" --company-description \"Provide customers with exceptional destination activities, unforgettable experiences, and reservation services.\"",
|
|
1750
|
+
"Generate an agent spec by being prompted for the required agent properties and generate a maxiumum of 5 topics; write the generated file to the \"specs/resortManagerSpec.yaml\" file and use the org with alias \"my-org\":\n<%= config.bin %> <%= command.id %> --max-topics 5 --output-file specs/resortManagerAgent.yaml --target-org my-org",
|
|
1751
|
+
"Be prompted for all required and optional agent properties; use your default org:\n<%= config.bin %> <%= command.id %> --full-interview",
|
|
1752
|
+
"Specify an existing agent spec file called \"specs/resortManagerAgent.yaml\", and then overwrite it with a new version that contains newly AI-generated topics based on the updated role information passed in with the --role flag:\n<%= config.bin %> <%= command.id %> --spec specs/resortManagerAgent.yaml --output-file specs/resortManagerAgent.yaml --role \"Field customer complaints, manage employee schedules, and ensure all resort operations are running smoothly\"",
|
|
1753
|
+
"Specify that the conversational tone of the agent is formal and to attach the \"resortmanager@myorg.com\" username to it; be prompted for the required properties and use your default org:\n<%= config.bin %> <%= command.id %> --tone formal --agent-user resortmanager@myorg.com"
|
|
1755
1754
|
],
|
|
1756
1755
|
"flags": {
|
|
1757
1756
|
"json": {
|
|
@@ -1786,57 +1785,164 @@
|
|
|
1786
1785
|
"multiple": false,
|
|
1787
1786
|
"type": "option"
|
|
1788
1787
|
},
|
|
1789
|
-
"
|
|
1790
|
-
"
|
|
1791
|
-
"
|
|
1792
|
-
"
|
|
1793
|
-
"
|
|
1788
|
+
"type": {
|
|
1789
|
+
"name": "type",
|
|
1790
|
+
"summary": "Type of agent to create. Internal types are copilots used internally by your company and customer types are the agents you create for your customers.",
|
|
1791
|
+
"hasDynamicHelp": false,
|
|
1792
|
+
"multiple": false,
|
|
1793
|
+
"options": [
|
|
1794
|
+
"customer",
|
|
1795
|
+
"internal"
|
|
1796
|
+
],
|
|
1797
|
+
"type": "option"
|
|
1798
|
+
},
|
|
1799
|
+
"role": {
|
|
1800
|
+
"name": "role",
|
|
1801
|
+
"summary": "Role of the agent.",
|
|
1794
1802
|
"hasDynamicHelp": false,
|
|
1795
1803
|
"multiple": false,
|
|
1796
1804
|
"type": "option"
|
|
1797
1805
|
},
|
|
1798
|
-
"
|
|
1799
|
-
"name": "
|
|
1800
|
-
"summary": "
|
|
1806
|
+
"company-name": {
|
|
1807
|
+
"name": "company-name",
|
|
1808
|
+
"summary": "Name of your company.",
|
|
1809
|
+
"hasDynamicHelp": false,
|
|
1810
|
+
"multiple": false,
|
|
1811
|
+
"type": "option"
|
|
1812
|
+
},
|
|
1813
|
+
"company-description": {
|
|
1814
|
+
"name": "company-description",
|
|
1815
|
+
"summary": "Description of your company.",
|
|
1816
|
+
"hasDynamicHelp": false,
|
|
1817
|
+
"multiple": false,
|
|
1818
|
+
"type": "option"
|
|
1819
|
+
},
|
|
1820
|
+
"company-website": {
|
|
1821
|
+
"name": "company-website",
|
|
1822
|
+
"summary": "Website URL of your company.",
|
|
1823
|
+
"hasDynamicHelp": false,
|
|
1824
|
+
"multiple": false,
|
|
1825
|
+
"type": "option"
|
|
1826
|
+
},
|
|
1827
|
+
"max-topics": {
|
|
1828
|
+
"name": "max-topics",
|
|
1829
|
+
"summary": "Maximum number of topics to generate in the agent spec; default is 5.",
|
|
1830
|
+
"hasDynamicHelp": false,
|
|
1831
|
+
"multiple": false,
|
|
1832
|
+
"type": "option"
|
|
1833
|
+
},
|
|
1834
|
+
"agent-user": {
|
|
1835
|
+
"name": "agent-user",
|
|
1836
|
+
"summary": "Username of a user in your org to assign to your agent; determines what your agent can access and do.",
|
|
1837
|
+
"hasDynamicHelp": false,
|
|
1838
|
+
"multiple": false,
|
|
1839
|
+
"type": "option"
|
|
1840
|
+
},
|
|
1841
|
+
"enrich-logs": {
|
|
1842
|
+
"name": "enrich-logs",
|
|
1843
|
+
"summary": "Adds agent conversation data to event logs so you can view all agent session activity in one place.",
|
|
1844
|
+
"hasDynamicHelp": false,
|
|
1845
|
+
"multiple": false,
|
|
1846
|
+
"options": [
|
|
1847
|
+
"true",
|
|
1848
|
+
"false"
|
|
1849
|
+
],
|
|
1850
|
+
"type": "option"
|
|
1851
|
+
},
|
|
1852
|
+
"tone": {
|
|
1853
|
+
"name": "tone",
|
|
1854
|
+
"summary": "Conversational style of the agent, such as how it expresses your brand personality in its messages through word choice, punctuation, and sentence structure.",
|
|
1855
|
+
"hasDynamicHelp": false,
|
|
1856
|
+
"multiple": false,
|
|
1857
|
+
"options": [
|
|
1858
|
+
"formal",
|
|
1859
|
+
"casual",
|
|
1860
|
+
"neutral"
|
|
1861
|
+
],
|
|
1862
|
+
"type": "option"
|
|
1863
|
+
},
|
|
1864
|
+
"spec": {
|
|
1865
|
+
"name": "spec",
|
|
1866
|
+
"summary": "Agent spec file, in YAML format, to use as input to the command.",
|
|
1867
|
+
"hasDynamicHelp": false,
|
|
1868
|
+
"multiple": false,
|
|
1869
|
+
"type": "option"
|
|
1870
|
+
},
|
|
1871
|
+
"output-file": {
|
|
1872
|
+
"name": "output-file",
|
|
1873
|
+
"summary": "Path for the generated YAML agent spec file; can be an absolute or relative path.",
|
|
1874
|
+
"default": "specs/agentSpec.yaml",
|
|
1875
|
+
"hasDynamicHelp": false,
|
|
1876
|
+
"multiple": false,
|
|
1877
|
+
"type": "option"
|
|
1878
|
+
},
|
|
1879
|
+
"full-interview": {
|
|
1880
|
+
"name": "full-interview",
|
|
1881
|
+
"summary": "Prompt for both required and optional flags.",
|
|
1882
|
+
"allowNo": false,
|
|
1883
|
+
"type": "boolean"
|
|
1884
|
+
},
|
|
1885
|
+
"prompt-template": {
|
|
1886
|
+
"name": "prompt-template",
|
|
1887
|
+
"summary": "API name of a customized prompt template to use instead of the default prompt template.",
|
|
1888
|
+
"hasDynamicHelp": false,
|
|
1889
|
+
"multiple": false,
|
|
1890
|
+
"type": "option"
|
|
1891
|
+
},
|
|
1892
|
+
"grounding-context": {
|
|
1893
|
+
"dependsOn": [
|
|
1894
|
+
"prompt-template"
|
|
1895
|
+
],
|
|
1896
|
+
"name": "grounding-context",
|
|
1897
|
+
"summary": "Context information and personalization that's added to your prompts when using a custom prompt template.",
|
|
1898
|
+
"hasDynamicHelp": false,
|
|
1899
|
+
"multiple": false,
|
|
1900
|
+
"type": "option"
|
|
1901
|
+
},
|
|
1902
|
+
"force-overwrite": {
|
|
1903
|
+
"name": "force-overwrite",
|
|
1904
|
+
"summary": "Don't prompt the user to confirm that an existing spec file will be overwritten.",
|
|
1801
1905
|
"allowNo": false,
|
|
1802
1906
|
"type": "boolean"
|
|
1803
1907
|
}
|
|
1804
1908
|
},
|
|
1805
1909
|
"hasDynamicHelp": true,
|
|
1806
1910
|
"hiddenAliases": [],
|
|
1807
|
-
"id": "agent:
|
|
1911
|
+
"id": "agent:generate:agent-spec",
|
|
1808
1912
|
"pluginAlias": "@salesforce/plugin-agent",
|
|
1809
1913
|
"pluginName": "@salesforce/plugin-agent",
|
|
1810
1914
|
"pluginType": "core",
|
|
1811
|
-
"state": "preview",
|
|
1812
1915
|
"strict": true,
|
|
1813
|
-
"summary": "
|
|
1916
|
+
"summary": "Generate an agent spec, which is a YAML file that captures what an agent can do.",
|
|
1814
1917
|
"enableJsonFlag": true,
|
|
1918
|
+
"requiresProject": true,
|
|
1815
1919
|
"isESM": true,
|
|
1816
1920
|
"relativePath": [
|
|
1817
1921
|
"lib",
|
|
1818
1922
|
"commands",
|
|
1819
1923
|
"agent",
|
|
1820
|
-
"
|
|
1821
|
-
"
|
|
1924
|
+
"generate",
|
|
1925
|
+
"agent-spec.js"
|
|
1822
1926
|
],
|
|
1823
1927
|
"aliasPermutations": [],
|
|
1824
1928
|
"permutations": [
|
|
1825
|
-
"agent:
|
|
1826
|
-
"
|
|
1827
|
-
"
|
|
1828
|
-
"agent:
|
|
1829
|
-
"
|
|
1830
|
-
"
|
|
1929
|
+
"agent:generate:agent-spec",
|
|
1930
|
+
"generate:agent:agent-spec",
|
|
1931
|
+
"generate:agent-spec:agent",
|
|
1932
|
+
"agent:agent-spec:generate",
|
|
1933
|
+
"agent-spec:agent:generate",
|
|
1934
|
+
"agent-spec:generate:agent"
|
|
1831
1935
|
]
|
|
1832
1936
|
},
|
|
1833
|
-
"agent:
|
|
1937
|
+
"agent:generate:authoring-bundle": {
|
|
1834
1938
|
"aliases": [],
|
|
1835
1939
|
"args": {},
|
|
1836
|
-
"description": "
|
|
1940
|
+
"description": "Authoring bundles are metadata components that contain an agent's Agent Script file. The Agent Script file is the agent's blueprint; it fully describes what the agent can do using the Agent Script language.\n\nUse this command to generate a new authoring bundle based on an agent spec YAML file, which you create with the \"agent generate agent-spec\" command. The agent spec YAML file is a high-level description of the agent; it describes its essence rather than exactly what it can do. The resulting Agent Script file is customized to reflect what's in the agent spec file. You can also create an authoring bundle without an agent spec file by specifying the \"--no-spec\" flag; in this case, the resulting Agent Script file is just the default boilerplate.\n\nThe metadata type for authoring bundles is aiAuthoringBundle, which consist of a standard \"<bundle-api-name>.bundle-meta.xml\" metadata file and the Agent Script file (with extension \".agent\"). When you run this command, the new authoring bundle is generated in the force-app/main/default/aiAuthoringBundles/<bundle-api-name> directory. Use the --output-dir flag to generate them elsewhere.\n\nAfter you generate the initial authoring bundle, code the Agent Script file so your agent behaves exactly as you want. The Agent Script file generated by this command is just a first draft of your agent! Interactively test the agent by conversing with it using the \"agent preview\" command. Then publish the agent to your org with the \"agent publish authoring-bundle\" command.\n\nThis command requires an org because it uses it to access an LLM for generating the Agent Script file.",
|
|
1837
1941
|
"examples": [
|
|
1838
|
-
"
|
|
1839
|
-
"
|
|
1942
|
+
"Generate an authoring bundle by being prompted for all required values, such as the agent spec YAML file, the bundle name, and the API name; use your default org:\n<%= config.bin %> <%= command.id %>",
|
|
1943
|
+
"Generate an authoring bundle without using an agent spec file; give the bundle the label \"My Authoring Bundle\" and use your default org:\n<%= config.bin %> <%= command.id %> --no-spec --name \"My Authoring Bundle\"",
|
|
1944
|
+
"Generate an authoring bundle from the \"specs/agentSpec.yaml\" agent spec YAML file and give it the label \"My Authoring Bundle\"; use your default org:\n<%= config.bin %> <%= command.id %> --spec specs/agentSpec.yaml --name \"My Authoring Bundle\"",
|
|
1945
|
+
"Similar to previous example, but generate the authoring bundle files in the \"other-package-dir/main/default\" package directory; use the org with alias \"my-dev-org\":\n<%= config.bin %> <%= command.id %> --spec specs/agentSpec.yaml --name \"My Authoring Bundle\" --output-dir other-package-dir/main/default --target-org my-dev-org"
|
|
1840
1946
|
],
|
|
1841
1947
|
"flags": {
|
|
1842
1948
|
"json": {
|
|
@@ -1864,6 +1970,13 @@
|
|
|
1864
1970
|
"multiple": false,
|
|
1865
1971
|
"type": "option"
|
|
1866
1972
|
},
|
|
1973
|
+
"api-name": {
|
|
1974
|
+
"name": "api-name",
|
|
1975
|
+
"summary": "API name of the new authoring bundle; if not specified, the API name is derived from the authoring bundle name (label); the API name can't exist in the org.",
|
|
1976
|
+
"hasDynamicHelp": false,
|
|
1977
|
+
"multiple": false,
|
|
1978
|
+
"type": "option"
|
|
1979
|
+
},
|
|
1867
1980
|
"api-version": {
|
|
1868
1981
|
"description": "Override the api version used for api requests made by this command",
|
|
1869
1982
|
"name": "api-version",
|
|
@@ -1871,51 +1984,77 @@
|
|
|
1871
1984
|
"multiple": false,
|
|
1872
1985
|
"type": "option"
|
|
1873
1986
|
},
|
|
1874
|
-
"
|
|
1875
|
-
"char": "
|
|
1876
|
-
"name": "
|
|
1877
|
-
"
|
|
1878
|
-
"
|
|
1987
|
+
"spec": {
|
|
1988
|
+
"char": "f",
|
|
1989
|
+
"name": "spec",
|
|
1990
|
+
"summary": "Path to the agent spec YAML file. If you don't specify the flag, the command provides a list that you can choose from. Use the --no-spec flag to skip using an agent spec entirely.",
|
|
1991
|
+
"hasDynamicHelp": false,
|
|
1992
|
+
"multiple": false,
|
|
1993
|
+
"type": "option"
|
|
1994
|
+
},
|
|
1995
|
+
"no-spec": {
|
|
1996
|
+
"name": "no-spec",
|
|
1997
|
+
"summary": "Skip prompting for an agent spec and use the default Agent Script boilerplate in the generated authoring bundle.",
|
|
1998
|
+
"allowNo": false,
|
|
1999
|
+
"type": "boolean"
|
|
2000
|
+
},
|
|
2001
|
+
"output-dir": {
|
|
2002
|
+
"char": "d",
|
|
2003
|
+
"name": "output-dir",
|
|
2004
|
+
"summary": "Directory where the authoring bundle files are generated.",
|
|
2005
|
+
"hasDynamicHelp": false,
|
|
2006
|
+
"multiple": false,
|
|
2007
|
+
"type": "option"
|
|
2008
|
+
},
|
|
2009
|
+
"name": {
|
|
2010
|
+
"char": "n",
|
|
2011
|
+
"name": "name",
|
|
2012
|
+
"summary": "Name (label) of the authoring bundle; if not specified, you're prompted for the name.",
|
|
1879
2013
|
"hasDynamicHelp": false,
|
|
1880
2014
|
"multiple": false,
|
|
1881
2015
|
"type": "option"
|
|
2016
|
+
},
|
|
2017
|
+
"force-overwrite": {
|
|
2018
|
+
"name": "force-overwrite",
|
|
2019
|
+
"summary": "Overwrite the existing authoring bundle if one with the same API name already exists locally.",
|
|
2020
|
+
"allowNo": false,
|
|
2021
|
+
"type": "boolean"
|
|
1882
2022
|
}
|
|
1883
2023
|
},
|
|
1884
2024
|
"hasDynamicHelp": true,
|
|
1885
2025
|
"hiddenAliases": [],
|
|
1886
|
-
"id": "agent:
|
|
2026
|
+
"id": "agent:generate:authoring-bundle",
|
|
1887
2027
|
"pluginAlias": "@salesforce/plugin-agent",
|
|
1888
2028
|
"pluginName": "@salesforce/plugin-agent",
|
|
1889
2029
|
"pluginType": "core",
|
|
1890
|
-
"state": "preview",
|
|
1891
2030
|
"strict": true,
|
|
1892
|
-
"summary": "
|
|
2031
|
+
"summary": "Generate an authoring bundle from an existing agent spec YAML file.",
|
|
1893
2032
|
"enableJsonFlag": true,
|
|
2033
|
+
"requiresProject": true,
|
|
1894
2034
|
"isESM": true,
|
|
1895
2035
|
"relativePath": [
|
|
1896
2036
|
"lib",
|
|
1897
2037
|
"commands",
|
|
1898
2038
|
"agent",
|
|
1899
|
-
"
|
|
1900
|
-
"
|
|
2039
|
+
"generate",
|
|
2040
|
+
"authoring-bundle.js"
|
|
1901
2041
|
],
|
|
1902
2042
|
"aliasPermutations": [],
|
|
1903
2043
|
"permutations": [
|
|
1904
|
-
"agent:
|
|
1905
|
-
"
|
|
1906
|
-
"
|
|
1907
|
-
"agent:
|
|
1908
|
-
"
|
|
1909
|
-
"
|
|
2044
|
+
"agent:generate:authoring-bundle",
|
|
2045
|
+
"generate:agent:authoring-bundle",
|
|
2046
|
+
"generate:authoring-bundle:agent",
|
|
2047
|
+
"agent:authoring-bundle:generate",
|
|
2048
|
+
"authoring-bundle:agent:generate",
|
|
2049
|
+
"authoring-bundle:generate:agent"
|
|
1910
2050
|
]
|
|
1911
2051
|
},
|
|
1912
|
-
"agent:
|
|
2052
|
+
"agent:generate:template": {
|
|
1913
2053
|
"aliases": [],
|
|
1914
2054
|
"args": {},
|
|
1915
|
-
"description": "
|
|
2055
|
+
"description": "WARNING: This command doesn't work for agents that were created from an Agent Script file. In other words, you can't currently package an agent template for agents that use Agent Script.\n\nAt a high-level, agents are defined by the Bot, BotVersion, and GenAiPlannerBundle metadata types. The GenAiPlannerBundle type in turn defines the agent's topics and actions. This command uses the metadata files for these three types, located in your local DX project, to generate a BotTemplate metadata file for a specific agent (Bot). You then use the BotTemplate metadata file, along with the GenAiPlannerBundle metadata file that references the BotTemplate, to package the template in a managed package that you can share between orgs or on AppExchange.\n\nUse the --agent-file flag to specify the relative or full pathname of the Bot metadata file, such as force-app/main/default/bots/My_Awesome_Agent/My_Awesome_Agent.bot-meta.xml. A single Bot can have multiple BotVersions, so use the --agent-version flag to specify the version. The corresponding BotVersion metadata file must exist locally. For example, if you specify \"--agent-version 4\", then the file force-app/main/default/bots/My_Awesome_Agent/v4.botVersion-meta.xml must exist.\n\nThe new BotTemplate metadata file is generated in the \"botTemplates\" directory in the output directory specified with the --output-dir flag, and has the name <Agent_API_name>\\_v<Version>\\_Template.botTemplate-meta.xml, such as my-package/botTemplates/My_Awesome_Agent_v4_Template.botTemplate-meta.xml. The command displays the full pathname of the generated files when it completes.\n\nSee \"Develop and Package Agent Templates Using Scratch Orgs\" (https://developer.salesforce.com/docs/atlas.en-us.pkg2_dev.meta/pkg2_dev/dev2gp_package_agent_templates.htm) for details about the complete process, which includes using a scratch org to create and test the agent, retrieving the agent metadata to your DX project, running this command to create the agent template, and then packaging the template.",
|
|
1916
2056
|
"examples": [
|
|
1917
|
-
"
|
|
1918
|
-
"Get an MCP server and output as JSON:\n<%= config.bin %> <%= command.id %> --target-org myOrg --mcp-server-id 0Mx000000000001 --json"
|
|
2057
|
+
"Generate an agent template from the My_Awesome_Agent Bot metadata file in your DX project and save the BotTemplate and GenAiPlannerBundle to the specified directory; use version 1 of the agent. The agent that the template is based on is in the org with alias \"my-scratch-org\":\n<%= config.bin %> <%= command.id %> --agent-file force-app/main/default/bots/My_Awesome_Agent/My_Awesome_Agent.bot-meta.xml --agent-version 1 --output-dir my-package --source-org my-scratch-org"
|
|
1919
2058
|
],
|
|
1920
2059
|
"flags": {
|
|
1921
2060
|
"json": {
|
|
@@ -1933,16 +2072,6 @@
|
|
|
1933
2072
|
"multiple": false,
|
|
1934
2073
|
"type": "option"
|
|
1935
2074
|
},
|
|
1936
|
-
"target-org": {
|
|
1937
|
-
"char": "o",
|
|
1938
|
-
"name": "target-org",
|
|
1939
|
-
"noCacheDefault": true,
|
|
1940
|
-
"required": true,
|
|
1941
|
-
"summary": "Username or alias of the target org. Not required if the `target-org` configuration variable is already set.",
|
|
1942
|
-
"hasDynamicHelp": true,
|
|
1943
|
-
"multiple": false,
|
|
1944
|
-
"type": "option"
|
|
1945
|
-
},
|
|
1946
2075
|
"api-version": {
|
|
1947
2076
|
"description": "Override the api version used for api requests made by this command",
|
|
1948
2077
|
"name": "api-version",
|
|
@@ -1950,158 +2079,82 @@
|
|
|
1950
2079
|
"multiple": false,
|
|
1951
2080
|
"type": "option"
|
|
1952
2081
|
},
|
|
1953
|
-
"
|
|
1954
|
-
"char": "
|
|
1955
|
-
"name": "
|
|
2082
|
+
"source-org": {
|
|
2083
|
+
"char": "s",
|
|
2084
|
+
"name": "source-org",
|
|
2085
|
+
"noCacheDefault": true,
|
|
1956
2086
|
"required": true,
|
|
1957
|
-
"summary": "
|
|
1958
|
-
"hasDynamicHelp":
|
|
1959
|
-
"multiple": false,
|
|
1960
|
-
"type": "option"
|
|
1961
|
-
}
|
|
1962
|
-
},
|
|
1963
|
-
"hasDynamicHelp": true,
|
|
1964
|
-
"hiddenAliases": [],
|
|
1965
|
-
"id": "agent:mcp:get",
|
|
1966
|
-
"pluginAlias": "@salesforce/plugin-agent",
|
|
1967
|
-
"pluginName": "@salesforce/plugin-agent",
|
|
1968
|
-
"pluginType": "core",
|
|
1969
|
-
"state": "preview",
|
|
1970
|
-
"strict": true,
|
|
1971
|
-
"summary": "Get a single MCP server registered in the API Catalog.",
|
|
1972
|
-
"enableJsonFlag": true,
|
|
1973
|
-
"isESM": true,
|
|
1974
|
-
"relativePath": [
|
|
1975
|
-
"lib",
|
|
1976
|
-
"commands",
|
|
1977
|
-
"agent",
|
|
1978
|
-
"mcp",
|
|
1979
|
-
"get.js"
|
|
1980
|
-
],
|
|
1981
|
-
"aliasPermutations": [],
|
|
1982
|
-
"permutations": [
|
|
1983
|
-
"agent:mcp:get",
|
|
1984
|
-
"mcp:agent:get",
|
|
1985
|
-
"mcp:get:agent",
|
|
1986
|
-
"agent:get:mcp",
|
|
1987
|
-
"get:agent:mcp",
|
|
1988
|
-
"get:mcp:agent"
|
|
1989
|
-
]
|
|
1990
|
-
},
|
|
1991
|
-
"agent:mcp:list": {
|
|
1992
|
-
"aliases": [],
|
|
1993
|
-
"args": {},
|
|
1994
|
-
"description": "Returns the Model Context Protocol (MCP) servers registered in the API Catalog, optionally filtered by label, type, or status. Use this to discover which MCP servers are available and inspect their server URLs and current status.",
|
|
1995
|
-
"examples": [
|
|
1996
|
-
"List all MCP servers in the default target org:\n<%= config.bin %> <%= command.id %> --target-org myOrg",
|
|
1997
|
-
"List external MCP servers filtered by status and output as JSON:\n<%= config.bin %> <%= command.id %> --target-org myOrg --type EXTERNAL --status ACTIVE --json"
|
|
1998
|
-
],
|
|
1999
|
-
"flags": {
|
|
2000
|
-
"json": {
|
|
2001
|
-
"description": "Format output as json.",
|
|
2002
|
-
"helpGroup": "GLOBAL",
|
|
2003
|
-
"name": "json",
|
|
2004
|
-
"allowNo": false,
|
|
2005
|
-
"type": "boolean"
|
|
2006
|
-
},
|
|
2007
|
-
"flags-dir": {
|
|
2008
|
-
"helpGroup": "GLOBAL",
|
|
2009
|
-
"name": "flags-dir",
|
|
2010
|
-
"summary": "Import flag values from a directory.",
|
|
2011
|
-
"hasDynamicHelp": false,
|
|
2087
|
+
"summary": "Username or alias of the namespaced scratch org that contains the agent which this template is based on.",
|
|
2088
|
+
"hasDynamicHelp": true,
|
|
2012
2089
|
"multiple": false,
|
|
2013
2090
|
"type": "option"
|
|
2014
2091
|
},
|
|
2015
|
-
"
|
|
2016
|
-
"
|
|
2017
|
-
"name": "target-org",
|
|
2018
|
-
"noCacheDefault": true,
|
|
2092
|
+
"agent-version": {
|
|
2093
|
+
"name": "agent-version",
|
|
2019
2094
|
"required": true,
|
|
2020
|
-
"summary": "
|
|
2021
|
-
"hasDynamicHelp": true,
|
|
2022
|
-
"multiple": false,
|
|
2023
|
-
"type": "option"
|
|
2024
|
-
},
|
|
2025
|
-
"api-version": {
|
|
2026
|
-
"description": "Override the api version used for api requests made by this command",
|
|
2027
|
-
"name": "api-version",
|
|
2028
|
-
"hasDynamicHelp": false,
|
|
2029
|
-
"multiple": false,
|
|
2030
|
-
"type": "option"
|
|
2031
|
-
},
|
|
2032
|
-
"label": {
|
|
2033
|
-
"name": "label",
|
|
2034
|
-
"summary": "Filter the MCP servers by label.",
|
|
2095
|
+
"summary": "Version of the agent (BotVersion).",
|
|
2035
2096
|
"hasDynamicHelp": false,
|
|
2036
2097
|
"multiple": false,
|
|
2037
2098
|
"type": "option"
|
|
2038
2099
|
},
|
|
2039
|
-
"
|
|
2040
|
-
"
|
|
2041
|
-
"
|
|
2100
|
+
"agent-file": {
|
|
2101
|
+
"char": "f",
|
|
2102
|
+
"name": "agent-file",
|
|
2103
|
+
"required": true,
|
|
2104
|
+
"summary": "Path to an agent (Bot) metadata file.",
|
|
2042
2105
|
"hasDynamicHelp": false,
|
|
2043
2106
|
"multiple": false,
|
|
2044
|
-
"options": [
|
|
2045
|
-
"EXTERNAL"
|
|
2046
|
-
],
|
|
2047
2107
|
"type": "option"
|
|
2048
2108
|
},
|
|
2049
|
-
"
|
|
2050
|
-
"
|
|
2051
|
-
"
|
|
2109
|
+
"output-dir": {
|
|
2110
|
+
"char": "r",
|
|
2111
|
+
"name": "output-dir",
|
|
2112
|
+
"summary": "Directory where the generated BotTemplate and GenAiPlannerBundle files are saved.",
|
|
2052
2113
|
"hasDynamicHelp": false,
|
|
2053
2114
|
"multiple": false,
|
|
2054
|
-
"options": [
|
|
2055
|
-
"ACTIVE",
|
|
2056
|
-
"DISCONNECTED"
|
|
2057
|
-
],
|
|
2058
2115
|
"type": "option"
|
|
2059
2116
|
}
|
|
2060
2117
|
},
|
|
2061
2118
|
"hasDynamicHelp": true,
|
|
2062
2119
|
"hiddenAliases": [],
|
|
2063
|
-
"id": "agent:
|
|
2120
|
+
"id": "agent:generate:template",
|
|
2064
2121
|
"pluginAlias": "@salesforce/plugin-agent",
|
|
2065
2122
|
"pluginName": "@salesforce/plugin-agent",
|
|
2066
2123
|
"pluginType": "core",
|
|
2067
|
-
"state": "preview",
|
|
2068
2124
|
"strict": true,
|
|
2069
|
-
"summary": "
|
|
2125
|
+
"summary": "Generate an agent template from an existing agent in your DX project so you can then package the template in a second-generation managed package.",
|
|
2070
2126
|
"enableJsonFlag": true,
|
|
2127
|
+
"requiresProject": true,
|
|
2071
2128
|
"isESM": true,
|
|
2072
2129
|
"relativePath": [
|
|
2073
2130
|
"lib",
|
|
2074
2131
|
"commands",
|
|
2075
2132
|
"agent",
|
|
2076
|
-
"
|
|
2077
|
-
"
|
|
2133
|
+
"generate",
|
|
2134
|
+
"template.js"
|
|
2078
2135
|
],
|
|
2079
2136
|
"aliasPermutations": [],
|
|
2080
2137
|
"permutations": [
|
|
2081
|
-
"agent:
|
|
2082
|
-
"
|
|
2083
|
-
"
|
|
2084
|
-
"agent:
|
|
2085
|
-
"
|
|
2086
|
-
"
|
|
2138
|
+
"agent:generate:template",
|
|
2139
|
+
"generate:agent:template",
|
|
2140
|
+
"generate:template:agent",
|
|
2141
|
+
"agent:template:generate",
|
|
2142
|
+
"template:agent:generate",
|
|
2143
|
+
"template:generate:agent"
|
|
2087
2144
|
]
|
|
2088
2145
|
},
|
|
2089
|
-
"agent:
|
|
2146
|
+
"agent:generate:test-spec": {
|
|
2090
2147
|
"aliases": [],
|
|
2091
2148
|
"args": {},
|
|
2092
|
-
"description": "
|
|
2149
|
+
"description": "The first step when using Salesforce CLI to create an agent test in your org is to use this interactive command to generate a local YAML-formatted test spec file. The test spec YAML file contains information about the agent being tested, such as its API name, and then one or more test cases. This command uses the metadata components in your DX project when prompting for information, such as the agent API name; it doesn't look in your org.\n\nTo generate a specific agent test case, this command prompts you for this information; when possible, the command provides a list of options for you to choose from:\n\n- Utterance: Natural language statement, question, or command used to test the agent.\n- Expected topic: API name of the topic you expect the agent to use when responding to the utterance.\n- Expected actions: One or more API names of the expection actions the agent takes.\n- Expected outcome: Natural language description of the outcome you expect.\n- (Optional) Custom evaluation: Test an agent's response for specific strings or numbers.\n- (Optional) Conversation history: Boilerplate for additional context you can add to the test in the form of a conversation history.\n\nYou can manually add contextVariables to test cases in the generated YAML file to inject contextual data (such as CaseId or RoutableId) into agent sessions. This is useful for testing agent behavior with different contextual information.\n\nWhen your test spec is ready, you then run the \"agent test create\" command to actually create the test in your org and synchronize the metadata with your DX project. The metadata type for an agent test is `AiEvaluationDefinition` (legacy testing-center) or `AiTestingDefinition` (Agentforce Studio / NGT), selected via --test-runner.\n\nIf you have an existing AiEvaluationDefinition or AiTestingDefinition metadata XML file in your DX project, you can generate its equivalent YAML test spec file with the --from-definition flag. The runner is inferred from the file extension; pass --test-runner to override.",
|
|
2093
2150
|
"examples": [
|
|
2094
|
-
"
|
|
2095
|
-
"
|
|
2151
|
+
"Generate an agent test spec YAML file interactively:\n<%= config.bin %> <%= command.id %>",
|
|
2152
|
+
"Generate an Agentforce Studio (NGT) test spec YAML file interactively:\n<%= config.bin %> <%= command.id %> --test-runner agentforce-studio",
|
|
2153
|
+
"Generate an agent test spec YAML file and specify a name for the new file; if the file exists, overwrite it without confirmation:\n<%= config.bin %> <%= command.id %> --output-file specs/Resort_Manager-new-version-testSpec.yaml --force-overwrite",
|
|
2154
|
+
"Generate an agent test spec YAML file from an existing AiEvaluationDefinition metadata XML file in your DX project:\n<%= config.bin %> <%= command.id %> --from-definition force-app/main/default/aiEvaluationDefinitions/Resort_Manager_Tests.aiEvaluationDefinition-meta.xml",
|
|
2155
|
+
"Generate an Agentforce Studio (NGT) test spec YAML file from an existing AiTestingDefinition metadata XML file:\n<%= config.bin %> <%= command.id %> --from-definition force-app/main/default/aiTestingDefinitions/Returns_Checkout_Tests.aiTestingDefinition-meta.xml"
|
|
2096
2156
|
],
|
|
2097
2157
|
"flags": {
|
|
2098
|
-
"json": {
|
|
2099
|
-
"description": "Format output as json.",
|
|
2100
|
-
"helpGroup": "GLOBAL",
|
|
2101
|
-
"name": "json",
|
|
2102
|
-
"allowNo": false,
|
|
2103
|
-
"type": "boolean"
|
|
2104
|
-
},
|
|
2105
2158
|
"flags-dir": {
|
|
2106
2159
|
"helpGroup": "GLOBAL",
|
|
2107
2160
|
"name": "flags-dir",
|
|
@@ -2110,119 +2163,66 @@
|
|
|
2110
2163
|
"multiple": false,
|
|
2111
2164
|
"type": "option"
|
|
2112
2165
|
},
|
|
2113
|
-
"
|
|
2114
|
-
"char": "
|
|
2115
|
-
"name": "
|
|
2116
|
-
"
|
|
2117
|
-
"required": true,
|
|
2118
|
-
"summary": "Username or alias of the target org. Not required if the `target-org` configuration variable is already set.",
|
|
2119
|
-
"hasDynamicHelp": true,
|
|
2120
|
-
"multiple": false,
|
|
2121
|
-
"type": "option"
|
|
2122
|
-
},
|
|
2123
|
-
"api-version": {
|
|
2124
|
-
"description": "Override the api version used for api requests made by this command",
|
|
2125
|
-
"name": "api-version",
|
|
2126
|
-
"hasDynamicHelp": false,
|
|
2127
|
-
"multiple": false,
|
|
2128
|
-
"type": "option"
|
|
2129
|
-
},
|
|
2130
|
-
"mcp-server-id": {
|
|
2131
|
-
"char": "i",
|
|
2132
|
-
"name": "mcp-server-id",
|
|
2133
|
-
"required": true,
|
|
2134
|
-
"summary": "ID of the MCP server to update.",
|
|
2135
|
-
"hasDynamicHelp": false,
|
|
2136
|
-
"multiple": false,
|
|
2137
|
-
"type": "option"
|
|
2138
|
-
},
|
|
2139
|
-
"label": {
|
|
2140
|
-
"name": "label",
|
|
2141
|
-
"summary": "New display label for the MCP server.",
|
|
2166
|
+
"from-definition": {
|
|
2167
|
+
"char": "d",
|
|
2168
|
+
"name": "from-definition",
|
|
2169
|
+
"summary": "Filepath to an AiEvaluationDefinition or AiTestingDefinition metadata XML file in your DX project that you want to convert to a test spec YAML file.",
|
|
2142
2170
|
"hasDynamicHelp": false,
|
|
2143
2171
|
"multiple": false,
|
|
2144
2172
|
"type": "option"
|
|
2145
2173
|
},
|
|
2146
|
-
"
|
|
2147
|
-
"name": "
|
|
2148
|
-
"summary": "
|
|
2149
|
-
"
|
|
2150
|
-
"
|
|
2151
|
-
"type": "option"
|
|
2174
|
+
"force-overwrite": {
|
|
2175
|
+
"name": "force-overwrite",
|
|
2176
|
+
"summary": "Don't prompt for confirmation when overwriting an existing test spec YAML file.",
|
|
2177
|
+
"allowNo": false,
|
|
2178
|
+
"type": "boolean"
|
|
2152
2179
|
},
|
|
2153
|
-
"
|
|
2154
|
-
"
|
|
2155
|
-
"
|
|
2180
|
+
"output-file": {
|
|
2181
|
+
"char": "f",
|
|
2182
|
+
"name": "output-file",
|
|
2183
|
+
"summary": "Name of the generated test spec YAML file. Default value is \"specs/<AGENT_API_NAME>-testSpec.yaml\" (legacy) or \"specs/<AGENT_API_NAME>-ngtTestSpec.yaml\" (Agentforce Studio).",
|
|
2156
2184
|
"hasDynamicHelp": false,
|
|
2157
2185
|
"multiple": false,
|
|
2158
2186
|
"type": "option"
|
|
2159
2187
|
},
|
|
2160
|
-
"
|
|
2161
|
-
"
|
|
2162
|
-
"
|
|
2188
|
+
"test-runner": {
|
|
2189
|
+
"description": "By default, the command automatically detects which test runner to use based on the test definition metadata type in your org. Use this flag to explicitly specify the runner type. 'agentforce-studio' uses AiTestingDefinition metadata. 'testing-center' uses AiEvaluationDefinition metadata.",
|
|
2190
|
+
"name": "test-runner",
|
|
2191
|
+
"summary": "Explicitly specify which test runner to use (agentforce-studio or testing-center).",
|
|
2163
2192
|
"hasDynamicHelp": false,
|
|
2164
2193
|
"multiple": false,
|
|
2165
2194
|
"options": [
|
|
2166
|
-
"
|
|
2167
|
-
"
|
|
2195
|
+
"agentforce-studio",
|
|
2196
|
+
"testing-center"
|
|
2168
2197
|
],
|
|
2169
2198
|
"type": "option"
|
|
2170
|
-
},
|
|
2171
|
-
"identity-provider": {
|
|
2172
|
-
"name": "identity-provider",
|
|
2173
|
-
"summary": "Identity provider name for OAuth authorization (required when --auth-type is OAUTH).",
|
|
2174
|
-
"hasDynamicHelp": false,
|
|
2175
|
-
"multiple": false,
|
|
2176
|
-
"type": "option"
|
|
2177
|
-
},
|
|
2178
|
-
"client-id": {
|
|
2179
|
-
"name": "client-id",
|
|
2180
|
-
"summary": "OAuth client ID (required when --auth-type is OAUTH).",
|
|
2181
|
-
"hasDynamicHelp": false,
|
|
2182
|
-
"multiple": false,
|
|
2183
|
-
"type": "option"
|
|
2184
|
-
},
|
|
2185
|
-
"client-secret": {
|
|
2186
|
-
"name": "client-secret",
|
|
2187
|
-
"summary": "OAuth client secret (required when --auth-type is OAUTH). Pass \"-\" to read it from stdin (piped) and keep it out of shell history.",
|
|
2188
|
-
"hasDynamicHelp": false,
|
|
2189
|
-
"multiple": false,
|
|
2190
|
-
"type": "option"
|
|
2191
|
-
},
|
|
2192
|
-
"scope": {
|
|
2193
|
-
"name": "scope",
|
|
2194
|
-
"summary": "OAuth scope (required when --auth-type is OAUTH).",
|
|
2195
|
-
"hasDynamicHelp": false,
|
|
2196
|
-
"multiple": false,
|
|
2197
|
-
"type": "option"
|
|
2198
2199
|
}
|
|
2199
2200
|
},
|
|
2200
|
-
"hasDynamicHelp":
|
|
2201
|
+
"hasDynamicHelp": false,
|
|
2201
2202
|
"hiddenAliases": [],
|
|
2202
|
-
"id": "agent:
|
|
2203
|
+
"id": "agent:generate:test-spec",
|
|
2203
2204
|
"pluginAlias": "@salesforce/plugin-agent",
|
|
2204
2205
|
"pluginName": "@salesforce/plugin-agent",
|
|
2205
2206
|
"pluginType": "core",
|
|
2206
|
-
"state": "preview",
|
|
2207
2207
|
"strict": true,
|
|
2208
|
-
"summary": "
|
|
2209
|
-
"enableJsonFlag":
|
|
2208
|
+
"summary": "Generate an agent test spec, which is a YAML file that lists the test cases for testing a specific agent.",
|
|
2209
|
+
"enableJsonFlag": false,
|
|
2210
2210
|
"isESM": true,
|
|
2211
2211
|
"relativePath": [
|
|
2212
2212
|
"lib",
|
|
2213
2213
|
"commands",
|
|
2214
2214
|
"agent",
|
|
2215
|
-
"
|
|
2216
|
-
"
|
|
2215
|
+
"generate",
|
|
2216
|
+
"test-spec.js"
|
|
2217
2217
|
],
|
|
2218
2218
|
"aliasPermutations": [],
|
|
2219
2219
|
"permutations": [
|
|
2220
|
-
"agent:
|
|
2221
|
-
"
|
|
2222
|
-
"
|
|
2223
|
-
"agent:
|
|
2224
|
-
"
|
|
2225
|
-
"
|
|
2220
|
+
"agent:generate:test-spec",
|
|
2221
|
+
"generate:agent:test-spec",
|
|
2222
|
+
"generate:test-spec:agent",
|
|
2223
|
+
"agent:test-spec:generate",
|
|
2224
|
+
"test-spec:agent:generate",
|
|
2225
|
+
"test-spec:generate:agent"
|
|
2226
2226
|
]
|
|
2227
2227
|
},
|
|
2228
2228
|
"agent:preview:end": {
|
|
@@ -2860,15 +2860,17 @@
|
|
|
2860
2860
|
"authoring-bundle:publish:agent"
|
|
2861
2861
|
]
|
|
2862
2862
|
},
|
|
2863
|
-
"agent:
|
|
2863
|
+
"agent:trace:delete": {
|
|
2864
2864
|
"aliases": [],
|
|
2865
2865
|
"args": {},
|
|
2866
|
-
"description": "
|
|
2866
|
+
"description": "When you run an agent preview conversation (either interactive or programmatic), trace files are automatically recorded and saved in your local DX project. Use this command to delete some or all of the trace files.\n\nBy default, this command shows a preview of what will be deleted and prompts for confirmation. Use --no-prompt to skip confirmation.\n\nWithout filters, this comamnd deletes all trace files for all agents and sessions. Use flags to narrow the scope: filter by agent API name (--agent), by session (--session-id), or by age (--older-than).",
|
|
2867
2867
|
"examples": [
|
|
2868
|
-
"
|
|
2869
|
-
"
|
|
2870
|
-
"
|
|
2871
|
-
"
|
|
2868
|
+
"Delete all traces for all agents and sessions; prompt for confirmation:\n<%= config.bin %> <%= command.id %>",
|
|
2869
|
+
"Delete all traces for a specific agent:\n<%= config.bin %> <%= command.id %> --agent My_Agent",
|
|
2870
|
+
"Delete traces from a specific session:\n<%= config.bin %> <%= command.id %> --session-id <SESSION_ID>",
|
|
2871
|
+
"Delete traces older than 7 days:\n<%= config.bin %> <%= command.id %> --older-than 7d",
|
|
2872
|
+
"Delete traces older than 24 hours for a specific agent; don't prompt for confirmation:\n<%= config.bin %> <%= command.id %> --agent My_Agent --older-than 24h --no-prompt",
|
|
2873
|
+
"Delete all traces for all agents and sessions; don't prompt for confirmation:\n<%= config.bin %> <%= command.id %> --no-prompt"
|
|
2872
2874
|
],
|
|
2873
2875
|
"flags": {
|
|
2874
2876
|
"json": {
|
|
@@ -2886,98 +2888,51 @@
|
|
|
2886
2888
|
"multiple": false,
|
|
2887
2889
|
"type": "option"
|
|
2888
2890
|
},
|
|
2889
|
-
"
|
|
2890
|
-
"
|
|
2891
|
-
"
|
|
2891
|
+
"agent": {
|
|
2892
|
+
"char": "a",
|
|
2893
|
+
"name": "agent",
|
|
2894
|
+
"summary": "API name of the agent used to filter the list of trace files you want to delete. Matches against the API name used when starting the session, either an authoring bundle or a published agent API name.",
|
|
2892
2895
|
"hasDynamicHelp": false,
|
|
2893
2896
|
"multiple": false,
|
|
2894
2897
|
"type": "option"
|
|
2895
2898
|
},
|
|
2896
|
-
"
|
|
2897
|
-
"name": "
|
|
2898
|
-
"summary": "
|
|
2899
|
+
"session-id": {
|
|
2900
|
+
"name": "session-id",
|
|
2901
|
+
"summary": "Session ID used to filter the list of trace files you want to delete. Use the \"agent preview sessions\" CLI command to list all known agent preview sessions along with their session IDs.",
|
|
2899
2902
|
"hasDynamicHelp": false,
|
|
2900
2903
|
"multiple": false,
|
|
2901
2904
|
"type": "option"
|
|
2902
2905
|
},
|
|
2903
|
-
"
|
|
2904
|
-
"
|
|
2905
|
-
"
|
|
2906
|
-
"noCacheDefault": true,
|
|
2907
|
-
"required": true,
|
|
2908
|
-
"summary": "Username or alias of the target org. Not required if the `target-org` configuration variable is already set.",
|
|
2909
|
-
"hasDynamicHelp": true,
|
|
2910
|
-
"multiple": false,
|
|
2911
|
-
"type": "option"
|
|
2912
|
-
},
|
|
2913
|
-
"api-version": {
|
|
2914
|
-
"description": "Override the api version used for api requests made by this command",
|
|
2915
|
-
"name": "api-version",
|
|
2906
|
+
"older-than": {
|
|
2907
|
+
"name": "older-than",
|
|
2908
|
+
"summary": "Duration used to filter the list of trace files; only files older than the duration are deleted. Accepts a number followed by a unit: m/minutes, h/hours, d/days, w/weeks. Examples: 7d, 24h, 2w.",
|
|
2916
2909
|
"hasDynamicHelp": false,
|
|
2917
2910
|
"multiple": false,
|
|
2918
2911
|
"type": "option"
|
|
2919
2912
|
},
|
|
2920
|
-
"
|
|
2921
|
-
"name": "
|
|
2922
|
-
"summary": "
|
|
2923
|
-
"allowNo": false,
|
|
2924
|
-
"type": "boolean"
|
|
2925
|
-
},
|
|
2926
|
-
"force-overwrite": {
|
|
2927
|
-
"name": "force-overwrite",
|
|
2928
|
-
"summary": "Don't prompt for confirmation when overwriting an existing test (based on API name) in your org.",
|
|
2913
|
+
"no-prompt": {
|
|
2914
|
+
"name": "no-prompt",
|
|
2915
|
+
"summary": "Skip the confirmation prompt and delete immediately.",
|
|
2929
2916
|
"allowNo": false,
|
|
2930
2917
|
"type": "boolean"
|
|
2931
|
-
},
|
|
2932
|
-
"test-runner": {
|
|
2933
|
-
"description": "By default, the command automatically detects which test runner to use based on the test definition metadata type in your org. Use this flag to explicitly specify the runner type. 'agentforce-studio' uses AiTestingDefinition metadata. 'testing-center' uses AiEvaluationDefinition metadata.",
|
|
2934
|
-
"name": "test-runner",
|
|
2935
|
-
"summary": "Explicitly specify which test runner to use (agentforce-studio or testing-center).",
|
|
2936
|
-
"hasDynamicHelp": false,
|
|
2937
|
-
"multiple": false,
|
|
2938
|
-
"options": [
|
|
2939
|
-
"agentforce-studio",
|
|
2940
|
-
"testing-center"
|
|
2941
|
-
],
|
|
2942
|
-
"type": "option"
|
|
2943
2918
|
}
|
|
2944
2919
|
},
|
|
2945
|
-
"hasDynamicHelp":
|
|
2920
|
+
"hasDynamicHelp": false,
|
|
2946
2921
|
"hiddenAliases": [],
|
|
2947
|
-
"id": "agent:
|
|
2922
|
+
"id": "agent:trace:delete",
|
|
2948
2923
|
"pluginAlias": "@salesforce/plugin-agent",
|
|
2949
2924
|
"pluginName": "@salesforce/plugin-agent",
|
|
2950
2925
|
"pluginType": "core",
|
|
2951
2926
|
"strict": true,
|
|
2952
|
-
"summary": "
|
|
2927
|
+
"summary": "Delete trace files from an agent preview session.",
|
|
2953
2928
|
"enableJsonFlag": true,
|
|
2954
|
-
"
|
|
2955
|
-
"header": "ENVIRONMENT VARIABLES",
|
|
2956
|
-
"body": [
|
|
2957
|
-
{
|
|
2958
|
-
"name": "SF_TARGET_ORG",
|
|
2959
|
-
"description": "Username or alias of your default org. Overrides the target-org configuration variable."
|
|
2960
|
-
}
|
|
2961
|
-
]
|
|
2962
|
-
},
|
|
2929
|
+
"requiresProject": true,
|
|
2963
2930
|
"errorCodes": {
|
|
2964
2931
|
"header": "ERROR CODES",
|
|
2965
2932
|
"body": [
|
|
2966
2933
|
{
|
|
2967
2934
|
"name": "Succeeded (0)",
|
|
2968
|
-
"description": "
|
|
2969
|
-
},
|
|
2970
|
-
{
|
|
2971
|
-
"name": "Failed (1)",
|
|
2972
|
-
"description": "Test validation errors or metadata format issues."
|
|
2973
|
-
},
|
|
2974
|
-
{
|
|
2975
|
-
"name": "NotFound (2)",
|
|
2976
|
-
"description": "Test spec file not found or org connection failed."
|
|
2977
|
-
},
|
|
2978
|
-
{
|
|
2979
|
-
"name": "DeploymentFailed (4)",
|
|
2980
|
-
"description": "Deployment failed due to API or network errors."
|
|
2935
|
+
"description": "Traces deleted successfully (or no traces matched)."
|
|
2981
2936
|
}
|
|
2982
2937
|
]
|
|
2983
2938
|
},
|
|
@@ -2986,26 +2941,31 @@
|
|
|
2986
2941
|
"lib",
|
|
2987
2942
|
"commands",
|
|
2988
2943
|
"agent",
|
|
2989
|
-
"
|
|
2990
|
-
"
|
|
2944
|
+
"trace",
|
|
2945
|
+
"delete.js"
|
|
2991
2946
|
],
|
|
2992
2947
|
"aliasPermutations": [],
|
|
2993
2948
|
"permutations": [
|
|
2994
|
-
"agent:
|
|
2995
|
-
"
|
|
2996
|
-
"
|
|
2997
|
-
"agent:
|
|
2998
|
-
"
|
|
2999
|
-
"
|
|
2949
|
+
"agent:trace:delete",
|
|
2950
|
+
"trace:agent:delete",
|
|
2951
|
+
"trace:delete:agent",
|
|
2952
|
+
"agent:delete:trace",
|
|
2953
|
+
"delete:agent:trace",
|
|
2954
|
+
"delete:trace:agent"
|
|
3000
2955
|
]
|
|
3001
2956
|
},
|
|
3002
|
-
"agent:
|
|
2957
|
+
"agent:trace:list": {
|
|
3003
2958
|
"aliases": [],
|
|
3004
2959
|
"args": {},
|
|
3005
|
-
"description": "
|
|
2960
|
+
"description": "When you run an agent preview conversation (either interactive or programmatic), trace files are automatically recorded and saved in your local DX project. By default, this command lists all trace files for all agents and all of their sessions. Use flags to narrow results: filter by agent name (--agent), by session (--session-id), or by date (--since).\n\nEach row in the output corresponds to one trace file, which in turn corresponds to one agent session. The Agent column shows the authoring bundle or API name used when starting the session.",
|
|
3006
2961
|
"examples": [
|
|
3007
|
-
"List
|
|
3008
|
-
"List
|
|
2962
|
+
"List all trace files for all agents and sessions:\n<%= config.bin %> <%= command.id %>",
|
|
2963
|
+
"List all trace files for a specific agent:\n<%= config.bin %> <%= command.id %> --agent My_Agent",
|
|
2964
|
+
"List trace files for a specific session:\n<%= config.bin %> <%= command.id %> --session-id <SESSION_ID>",
|
|
2965
|
+
"List trace files recorded on or after April 20, 2026 (date-only, interpreted as UTC midnight):\n<%= config.bin %> <%= command.id %> --since 2026-04-20",
|
|
2966
|
+
"List trace files recorded on or after a specific UTC time:\n<%= config.bin %> <%= command.id %> --since 2026-04-20T14:00:00Z",
|
|
2967
|
+
"Filter by agent and date together:\n<%= config.bin %> <%= command.id %> --agent My_Agent --since 2026-04-20",
|
|
2968
|
+
"Return results as JSON:\n<%= config.bin %> <%= command.id %> --json"
|
|
3009
2969
|
],
|
|
3010
2970
|
"flags": {
|
|
3011
2971
|
"json": {
|
|
@@ -3023,52 +2983,46 @@
|
|
|
3023
2983
|
"multiple": false,
|
|
3024
2984
|
"type": "option"
|
|
3025
2985
|
},
|
|
3026
|
-
"
|
|
3027
|
-
"
|
|
3028
|
-
"
|
|
3029
|
-
"
|
|
3030
|
-
"required": true,
|
|
3031
|
-
"summary": "Username or alias of the target org. Not required if the `target-org` configuration variable is already set.",
|
|
3032
|
-
"hasDynamicHelp": true,
|
|
2986
|
+
"session-id": {
|
|
2987
|
+
"name": "session-id",
|
|
2988
|
+
"summary": "Session ID used to filter the list of trace files. Use the \"agent preview sessions\" CLI command to list all known agent preview sessions along with their session IDs.",
|
|
2989
|
+
"hasDynamicHelp": false,
|
|
3033
2990
|
"multiple": false,
|
|
3034
2991
|
"type": "option"
|
|
3035
2992
|
},
|
|
3036
|
-
"
|
|
3037
|
-
"
|
|
3038
|
-
"name": "
|
|
2993
|
+
"agent": {
|
|
2994
|
+
"char": "a",
|
|
2995
|
+
"name": "agent",
|
|
2996
|
+
"summary": "API name of the agent used to filter the list of available trace files. Matches against the API name used when starting the session, either an authoring bundle or a published agent API name.",
|
|
2997
|
+
"hasDynamicHelp": false,
|
|
2998
|
+
"multiple": false,
|
|
2999
|
+
"type": "option"
|
|
3000
|
+
},
|
|
3001
|
+
"since": {
|
|
3002
|
+
"description": "Accepts ISO 8601 format: date-only (2026-04-20), date-time (2026-04-20T14:00:00Z), or date-time with milliseconds (2026-04-20T14:00:00.000Z). The \"Recorded At\" values shown in the table output are valid inputs.",
|
|
3003
|
+
"name": "since",
|
|
3004
|
+
"summary": "Date used to filter the list of trace files; only those recorded on or after the date are listed.",
|
|
3039
3005
|
"hasDynamicHelp": false,
|
|
3040
3006
|
"multiple": false,
|
|
3041
3007
|
"type": "option"
|
|
3042
3008
|
}
|
|
3043
3009
|
},
|
|
3044
|
-
"hasDynamicHelp":
|
|
3010
|
+
"hasDynamicHelp": false,
|
|
3045
3011
|
"hiddenAliases": [],
|
|
3046
|
-
"id": "agent:
|
|
3012
|
+
"id": "agent:trace:list",
|
|
3047
3013
|
"pluginAlias": "@salesforce/plugin-agent",
|
|
3048
3014
|
"pluginName": "@salesforce/plugin-agent",
|
|
3049
3015
|
"pluginType": "core",
|
|
3050
3016
|
"strict": true,
|
|
3051
|
-
"summary": "List the available
|
|
3017
|
+
"summary": "List the available trace files that were recorded during all agent preview sessions.",
|
|
3052
3018
|
"enableJsonFlag": true,
|
|
3053
|
-
"
|
|
3054
|
-
"header": "ENVIRONMENT VARIABLES",
|
|
3055
|
-
"body": [
|
|
3056
|
-
{
|
|
3057
|
-
"name": "SF_TARGET_ORG",
|
|
3058
|
-
"description": "Username or alias of your default org. Overrides the target-org configuration variable."
|
|
3059
|
-
}
|
|
3060
|
-
]
|
|
3061
|
-
},
|
|
3019
|
+
"requiresProject": true,
|
|
3062
3020
|
"errorCodes": {
|
|
3063
3021
|
"header": "ERROR CODES",
|
|
3064
3022
|
"body": [
|
|
3065
3023
|
{
|
|
3066
3024
|
"name": "Succeeded (0)",
|
|
3067
|
-
"description": "
|
|
3068
|
-
},
|
|
3069
|
-
{
|
|
3070
|
-
"name": "Failed (4)",
|
|
3071
|
-
"description": "Failed to retrieve agent tests due to API or network errors."
|
|
3025
|
+
"description": "Trace files listed successfully (or empty list if none found)."
|
|
3072
3026
|
}
|
|
3073
3027
|
]
|
|
3074
3028
|
},
|
|
@@ -3077,27 +3031,31 @@
|
|
|
3077
3031
|
"lib",
|
|
3078
3032
|
"commands",
|
|
3079
3033
|
"agent",
|
|
3080
|
-
"
|
|
3034
|
+
"trace",
|
|
3081
3035
|
"list.js"
|
|
3082
3036
|
],
|
|
3083
3037
|
"aliasPermutations": [],
|
|
3084
3038
|
"permutations": [
|
|
3085
|
-
"agent:
|
|
3086
|
-
"
|
|
3087
|
-
"
|
|
3088
|
-
"agent:list:
|
|
3089
|
-
"list:agent:
|
|
3090
|
-
"list:
|
|
3039
|
+
"agent:trace:list",
|
|
3040
|
+
"trace:agent:list",
|
|
3041
|
+
"trace:list:agent",
|
|
3042
|
+
"agent:list:trace",
|
|
3043
|
+
"list:agent:trace",
|
|
3044
|
+
"list:trace:agent"
|
|
3091
3045
|
]
|
|
3092
3046
|
},
|
|
3093
|
-
"agent:
|
|
3047
|
+
"agent:trace:read": {
|
|
3094
3048
|
"aliases": [],
|
|
3095
3049
|
"args": {},
|
|
3096
|
-
"description": "
|
|
3050
|
+
"description": "When you run an agent preview conversation (either interactive or programmatic), trace files are automatically recorded and saved in your local DX project. Each turn (utterance or response) of a conversation creates trace data. Use this command to view trace data for a specific preview session, so you can then analyze the trace data to observe, monitor, investigate, and troubleshoot agent events and behavior.\n\nUse the --format flag to specify one of these formats of the outputted trace data:\n\n- summary (Default): A per-turn narrative showing topic routing, actions executed, and the agent's response. Use this to quickly understand what happened in a preview session.\n- detail: Diagnostic drill-down into a specific dimension. Filters output to only the trace steps relevant to that dimension, minimizing noise.\n- raw: Unprocessed trace JSON. Use this as a fallback when the trace schema has changed or you need to perform custom analysis.\n\nIf you specify \"--format detail\", you must also specify a dimension with the --dimension flag. Dimensions are a way to slice and analyze the agent execution trace from a specific angle or concern. Instead of looking at the raw sequence of everything that happened, each dimension filters and organizes the trace data to answer a specific type of question. These are the available dimensions and the information they provide:\n\n- actions: The actions the agent executed. Includes action name, input parameters, output, and latency. Use this dimension to understand what the agent actually did when answering an utterance in the preview session.\n- grounding: The reasoning steps used by the LLM. Use this dimension to see how the agent \"thought\" about the problem - the AI reasoning that determined which actions to take.\n- routing: How the agent navigated between subagents. Use this dimension to understand conversation flow - when and why the agent switched between different subagents or contexts during the conversation.\n- errors: Aggregates all errors during the session. Use this dimension to quickly identify and debug issues across all steps.",
|
|
3097
3051
|
"examples": [
|
|
3098
|
-
"
|
|
3099
|
-
"
|
|
3100
|
-
"
|
|
3052
|
+
"Show a session trace summary for all turns in the session with the specified ID:\n<%= config.bin %> <%= command.id %> --session-id <SESSION_ID>",
|
|
3053
|
+
"Show a trace summary for the second turn (utterance or response) of the conversation:\n<%= config.bin %> <%= command.id %> --session-id <SESSION_ID> --turn 2",
|
|
3054
|
+
"Drill into action execution across all turns:\n<%= config.bin %> <%= command.id %> --session-id <SESSION_ID> --format detail --dimension actions",
|
|
3055
|
+
"Drill into routing decisions for the first turn of the conversation:\n<%= config.bin %> <%= command.id %> --session-id <SESSION_ID> --format detail --dimension routing --turn 1",
|
|
3056
|
+
"Show all errors across the session:\n<%= config.bin %> <%= command.id %> --session-id <SESSION_ID> --format detail --dimension errors",
|
|
3057
|
+
"Output raw trace JSON for custom parsing:\n<%= config.bin %> <%= command.id %> --session-id <SESSION_ID> --format raw",
|
|
3058
|
+
"Return results as JSON:\n<%= config.bin %> <%= command.id %> --session-id <SESSION_ID> --json"
|
|
3101
3059
|
],
|
|
3102
3060
|
"flags": {
|
|
3103
3061
|
"json": {
|
|
@@ -3115,136 +3073,89 @@
|
|
|
3115
3073
|
"multiple": false,
|
|
3116
3074
|
"type": "option"
|
|
3117
3075
|
},
|
|
3118
|
-
"
|
|
3119
|
-
"char": "
|
|
3120
|
-
"name": "
|
|
3121
|
-
"noCacheDefault": true,
|
|
3122
|
-
"required": true,
|
|
3123
|
-
"summary": "Username or alias of the target org. Not required if the `target-org` configuration variable is already set.",
|
|
3124
|
-
"hasDynamicHelp": true,
|
|
3125
|
-
"multiple": false,
|
|
3126
|
-
"type": "option"
|
|
3127
|
-
},
|
|
3128
|
-
"api-version": {
|
|
3129
|
-
"description": "Override the api version used for api requests made by this command",
|
|
3130
|
-
"name": "api-version",
|
|
3131
|
-
"hasDynamicHelp": false,
|
|
3132
|
-
"multiple": false,
|
|
3133
|
-
"type": "option"
|
|
3134
|
-
},
|
|
3135
|
-
"job-id": {
|
|
3136
|
-
"char": "i",
|
|
3137
|
-
"name": "job-id",
|
|
3076
|
+
"session-id": {
|
|
3077
|
+
"char": "s",
|
|
3078
|
+
"name": "session-id",
|
|
3138
3079
|
"required": true,
|
|
3139
|
-
"summary": "
|
|
3080
|
+
"summary": "Session ID to read traces for. Use the \"agent preview sessions\" CLI command to list all known agent preview sessions along with their session IDs",
|
|
3140
3081
|
"hasDynamicHelp": false,
|
|
3141
3082
|
"multiple": false,
|
|
3142
3083
|
"type": "option"
|
|
3143
3084
|
},
|
|
3144
|
-
"
|
|
3145
|
-
"
|
|
3146
|
-
"
|
|
3147
|
-
"
|
|
3085
|
+
"format": {
|
|
3086
|
+
"char": "f",
|
|
3087
|
+
"name": "format",
|
|
3088
|
+
"summary": "Output format of the trace data; specifies the level of detail you want in the trace files.",
|
|
3089
|
+
"default": "summary",
|
|
3148
3090
|
"hasDynamicHelp": false,
|
|
3149
3091
|
"multiple": false,
|
|
3150
3092
|
"options": [
|
|
3151
|
-
"
|
|
3152
|
-
"
|
|
3153
|
-
"
|
|
3154
|
-
"tap"
|
|
3093
|
+
"summary",
|
|
3094
|
+
"detail",
|
|
3095
|
+
"raw"
|
|
3155
3096
|
],
|
|
3156
3097
|
"type": "option"
|
|
3157
3098
|
},
|
|
3158
|
-
"
|
|
3099
|
+
"dimension": {
|
|
3159
3100
|
"char": "d",
|
|
3160
|
-
"
|
|
3161
|
-
"
|
|
3162
|
-
"summary": "Directory to write the agent test results into.",
|
|
3163
|
-
"hasDynamicHelp": false,
|
|
3164
|
-
"multiple": false,
|
|
3165
|
-
"type": "option"
|
|
3166
|
-
},
|
|
3167
|
-
"test-runner": {
|
|
3168
|
-
"description": "By default, the command automatically detects which test runner to use based on the test definition metadata type in your org. Use this flag to explicitly specify the runner type. 'agentforce-studio' uses AiTestingDefinition metadata. 'testing-center' uses AiEvaluationDefinition metadata.",
|
|
3169
|
-
"name": "test-runner",
|
|
3170
|
-
"summary": "Explicitly specify which test runner to use (agentforce-studio or testing-center).",
|
|
3101
|
+
"name": "dimension",
|
|
3102
|
+
"summary": "Dimension to drill into when using \"--format detail\"; used to filter and organize the trace data to answer a specific type of question.",
|
|
3171
3103
|
"hasDynamicHelp": false,
|
|
3172
3104
|
"multiple": false,
|
|
3173
3105
|
"options": [
|
|
3174
|
-
"
|
|
3175
|
-
"
|
|
3106
|
+
"actions",
|
|
3107
|
+
"grounding",
|
|
3108
|
+
"routing",
|
|
3109
|
+
"errors"
|
|
3176
3110
|
],
|
|
3177
3111
|
"type": "option"
|
|
3178
3112
|
},
|
|
3179
|
-
"
|
|
3180
|
-
"
|
|
3181
|
-
"name": "
|
|
3182
|
-
"summary": "
|
|
3183
|
-
"
|
|
3184
|
-
"
|
|
3113
|
+
"turn": {
|
|
3114
|
+
"char": "t",
|
|
3115
|
+
"name": "turn",
|
|
3116
|
+
"summary": "Turn number for which you want trace data. A turn is a single utterance or response in a conversation, starting with 1.",
|
|
3117
|
+
"hasDynamicHelp": false,
|
|
3118
|
+
"multiple": false,
|
|
3119
|
+
"type": "option"
|
|
3185
3120
|
}
|
|
3186
3121
|
},
|
|
3187
|
-
"hasDynamicHelp":
|
|
3122
|
+
"hasDynamicHelp": false,
|
|
3188
3123
|
"hiddenAliases": [],
|
|
3189
|
-
"id": "agent:
|
|
3124
|
+
"id": "agent:trace:read",
|
|
3190
3125
|
"pluginAlias": "@salesforce/plugin-agent",
|
|
3191
3126
|
"pluginName": "@salesforce/plugin-agent",
|
|
3192
3127
|
"pluginType": "core",
|
|
3193
3128
|
"strict": true,
|
|
3194
|
-
"summary": "
|
|
3129
|
+
"summary": "Read trace files from an agent preview session.",
|
|
3195
3130
|
"enableJsonFlag": true,
|
|
3196
|
-
"
|
|
3197
|
-
"header": "ENVIRONMENT VARIABLES",
|
|
3198
|
-
"body": [
|
|
3199
|
-
{
|
|
3200
|
-
"name": "SF_TARGET_ORG",
|
|
3201
|
-
"description": "Username or alias of your default org. Overrides the target-org configuration variable."
|
|
3202
|
-
}
|
|
3203
|
-
]
|
|
3204
|
-
},
|
|
3205
|
-
"errorCodes": {
|
|
3206
|
-
"header": "ERROR CODES",
|
|
3207
|
-
"body": [
|
|
3208
|
-
{
|
|
3209
|
-
"name": "Succeeded (0)",
|
|
3210
|
-
"description": "Results retrieved successfully. Test results (passed/failed) are in the output."
|
|
3211
|
-
},
|
|
3212
|
-
{
|
|
3213
|
-
"name": "NotFound (2)",
|
|
3214
|
-
"description": "Job ID not found or invalid."
|
|
3215
|
-
},
|
|
3216
|
-
{
|
|
3217
|
-
"name": "Failed (4)",
|
|
3218
|
-
"description": "Failed to retrieve results due to API or network errors."
|
|
3219
|
-
}
|
|
3220
|
-
]
|
|
3221
|
-
},
|
|
3131
|
+
"requiresProject": true,
|
|
3222
3132
|
"isESM": true,
|
|
3223
3133
|
"relativePath": [
|
|
3224
3134
|
"lib",
|
|
3225
3135
|
"commands",
|
|
3226
3136
|
"agent",
|
|
3227
|
-
"
|
|
3228
|
-
"
|
|
3137
|
+
"trace",
|
|
3138
|
+
"read.js"
|
|
3229
3139
|
],
|
|
3230
3140
|
"aliasPermutations": [],
|
|
3231
3141
|
"permutations": [
|
|
3232
|
-
"agent:
|
|
3233
|
-
"
|
|
3234
|
-
"
|
|
3235
|
-
"agent:
|
|
3236
|
-
"
|
|
3237
|
-
"
|
|
3142
|
+
"agent:trace:read",
|
|
3143
|
+
"trace:agent:read",
|
|
3144
|
+
"trace:read:agent",
|
|
3145
|
+
"agent:read:trace",
|
|
3146
|
+
"read:agent:trace",
|
|
3147
|
+
"read:trace:agent"
|
|
3238
3148
|
]
|
|
3239
3149
|
},
|
|
3240
|
-
"agent:test:
|
|
3150
|
+
"agent:test:create": {
|
|
3241
3151
|
"aliases": [],
|
|
3242
3152
|
"args": {},
|
|
3243
|
-
"description": "
|
|
3153
|
+
"description": "To run this command, you must have an agent test spec file, which is a YAML file that lists the test cases for testing a specific agent. Use the \"agent generate test-spec\" CLI command to generate a test spec file. Then specify the file to this command with the --spec flag, or run this command with no flags to be prompted.\n\nWhen this command completes, your org contains the new agent test, which you can view and edit using the Testing Center UI (legacy) or Agentforce Studio (NGT). This command also retrieves the metadata component associated with the new test to your local Salesforce DX project and displays its filename. By default, the legacy AiEvaluationDefinition is created; use --test-runner agentforce-studio to author an AiTestingDefinition (NGT) instead.\n\nAfter you've created the test in the org, use the \"agent test run\" command to run it.",
|
|
3244
3154
|
"examples": [
|
|
3245
|
-
"
|
|
3246
|
-
"
|
|
3247
|
-
"
|
|
3155
|
+
"Create an agent test interactively and be prompted for the test spec and API name of the test in the org; use the default org:\n<%= config.bin %> <%= command.id %>",
|
|
3156
|
+
"Create an agent test and use flags to specify all required information; if a test with same API name already exists in the org, overwrite it without confirmation. Use the org with alias \"my-org\":\n<%= config.bin %> <%= command.id %> --spec specs/Resort_Manager-testSpec.yaml --api-name Resort_Manager_Test --force-overwrite --target-org my-org",
|
|
3157
|
+
"Preview what the agent test metadata (AiEvaluationDefinition) looks like without deploying it to your default org:\n<%= config.bin %> <%= command.id %> --spec specs/Resort_Manager-testSpec.yaml --api-name Resort_Manager_Test --preview",
|
|
3158
|
+
"Author an Agentforce Studio (NGT) test from an NGT-shaped YAML; writes an AiTestingDefinition metadata file:\n<%= config.bin %> <%= command.id %> --spec specs/ReturnsCheckout.ngt.yaml --api-name Returns_Checkout --test-runner agentforce-studio --target-org my-org"
|
|
3248
3159
|
],
|
|
3249
3160
|
"flags": {
|
|
3250
3161
|
"json": {
|
|
@@ -3262,6 +3173,20 @@
|
|
|
3262
3173
|
"multiple": false,
|
|
3263
3174
|
"type": "option"
|
|
3264
3175
|
},
|
|
3176
|
+
"api-name": {
|
|
3177
|
+
"name": "api-name",
|
|
3178
|
+
"summary": "API name of the new test; the API name must not exist in the org.",
|
|
3179
|
+
"hasDynamicHelp": false,
|
|
3180
|
+
"multiple": false,
|
|
3181
|
+
"type": "option"
|
|
3182
|
+
},
|
|
3183
|
+
"spec": {
|
|
3184
|
+
"name": "spec",
|
|
3185
|
+
"summary": "Path to the test spec YAML file.",
|
|
3186
|
+
"hasDynamicHelp": false,
|
|
3187
|
+
"multiple": false,
|
|
3188
|
+
"type": "option"
|
|
3189
|
+
},
|
|
3265
3190
|
"target-org": {
|
|
3266
3191
|
"char": "o",
|
|
3267
3192
|
"name": "target-org",
|
|
@@ -3279,52 +3204,17 @@
|
|
|
3279
3204
|
"multiple": false,
|
|
3280
3205
|
"type": "option"
|
|
3281
3206
|
},
|
|
3282
|
-
"
|
|
3283
|
-
"
|
|
3284
|
-
"
|
|
3285
|
-
"summary": "Job ID of the original agent test run.",
|
|
3286
|
-
"hasDynamicHelp": false,
|
|
3287
|
-
"multiple": false,
|
|
3288
|
-
"type": "option"
|
|
3289
|
-
},
|
|
3290
|
-
"use-most-recent": {
|
|
3291
|
-
"char": "r",
|
|
3292
|
-
"name": "use-most-recent",
|
|
3293
|
-
"summary": "Use the job ID of the most recent agent test run.",
|
|
3207
|
+
"preview": {
|
|
3208
|
+
"name": "preview",
|
|
3209
|
+
"summary": "Preview the test metadata file without deploying to your org.",
|
|
3294
3210
|
"allowNo": false,
|
|
3295
3211
|
"type": "boolean"
|
|
3296
3212
|
},
|
|
3297
|
-
"
|
|
3298
|
-
"
|
|
3299
|
-
"
|
|
3300
|
-
"
|
|
3301
|
-
"
|
|
3302
|
-
"hasDynamicHelp": true,
|
|
3303
|
-
"multiple": false,
|
|
3304
|
-
"type": "option"
|
|
3305
|
-
},
|
|
3306
|
-
"result-format": {
|
|
3307
|
-
"name": "result-format",
|
|
3308
|
-
"summary": "Format of the agent test run results.",
|
|
3309
|
-
"default": "human",
|
|
3310
|
-
"hasDynamicHelp": false,
|
|
3311
|
-
"multiple": false,
|
|
3312
|
-
"options": [
|
|
3313
|
-
"json",
|
|
3314
|
-
"human",
|
|
3315
|
-
"junit",
|
|
3316
|
-
"tap"
|
|
3317
|
-
],
|
|
3318
|
-
"type": "option"
|
|
3319
|
-
},
|
|
3320
|
-
"output-dir": {
|
|
3321
|
-
"char": "d",
|
|
3322
|
-
"description": "If the agent test run completes, write the results to the specified directory. If the test is still running, the test results aren't written.",
|
|
3323
|
-
"name": "output-dir",
|
|
3324
|
-
"summary": "Directory to write the agent test results into.",
|
|
3325
|
-
"hasDynamicHelp": false,
|
|
3326
|
-
"multiple": false,
|
|
3327
|
-
"type": "option"
|
|
3213
|
+
"force-overwrite": {
|
|
3214
|
+
"name": "force-overwrite",
|
|
3215
|
+
"summary": "Don't prompt for confirmation when overwriting an existing test (based on API name) in your org.",
|
|
3216
|
+
"allowNo": false,
|
|
3217
|
+
"type": "boolean"
|
|
3328
3218
|
},
|
|
3329
3219
|
"test-runner": {
|
|
3330
3220
|
"description": "By default, the command automatically detects which test runner to use based on the test definition metadata type in your org. Use this flag to explicitly specify the runner type. 'agentforce-studio' uses AiTestingDefinition metadata. 'testing-center' uses AiEvaluationDefinition metadata.",
|
|
@@ -3337,23 +3227,16 @@
|
|
|
3337
3227
|
"testing-center"
|
|
3338
3228
|
],
|
|
3339
3229
|
"type": "option"
|
|
3340
|
-
},
|
|
3341
|
-
"verbose": {
|
|
3342
|
-
"description": "When enabled, includes detailed generated data (such as invoked actions) in the human-readable test results output. This is useful for debugging test failures and understanding what actions were actually invoked during the test run.\n\nThe generated data is in JSON format and includes the Apex classes or Flows that were invoked, the Salesforce objects that were touched, and so on. Use the JSON structure of this information to build the test case JSONPath expression when using custom evaluations.",
|
|
3343
|
-
"name": "verbose",
|
|
3344
|
-
"summary": "Show generated data in the test results output.",
|
|
3345
|
-
"allowNo": false,
|
|
3346
|
-
"type": "boolean"
|
|
3347
3230
|
}
|
|
3348
3231
|
},
|
|
3349
3232
|
"hasDynamicHelp": true,
|
|
3350
3233
|
"hiddenAliases": [],
|
|
3351
|
-
"id": "agent:test:
|
|
3234
|
+
"id": "agent:test:create",
|
|
3352
3235
|
"pluginAlias": "@salesforce/plugin-agent",
|
|
3353
3236
|
"pluginName": "@salesforce/plugin-agent",
|
|
3354
3237
|
"pluginType": "core",
|
|
3355
3238
|
"strict": true,
|
|
3356
|
-
"summary": "
|
|
3239
|
+
"summary": "Create an agent test in your org using a local test spec YAML file.",
|
|
3357
3240
|
"enableJsonFlag": true,
|
|
3358
3241
|
"envVariablesSection": {
|
|
3359
3242
|
"header": "ENVIRONMENT VARIABLES",
|
|
@@ -3369,19 +3252,19 @@
|
|
|
3369
3252
|
"body": [
|
|
3370
3253
|
{
|
|
3371
3254
|
"name": "Succeeded (0)",
|
|
3372
|
-
"description": "Test
|
|
3255
|
+
"description": "Test created and deployed successfully."
|
|
3373
3256
|
},
|
|
3374
3257
|
{
|
|
3375
3258
|
"name": "Failed (1)",
|
|
3376
|
-
"description": "
|
|
3259
|
+
"description": "Test validation errors or metadata format issues."
|
|
3377
3260
|
},
|
|
3378
3261
|
{
|
|
3379
3262
|
"name": "NotFound (2)",
|
|
3380
|
-
"description": "
|
|
3263
|
+
"description": "Test spec file not found or org connection failed."
|
|
3381
3264
|
},
|
|
3382
3265
|
{
|
|
3383
|
-
"name": "
|
|
3384
|
-
"description": "
|
|
3266
|
+
"name": "DeploymentFailed (4)",
|
|
3267
|
+
"description": "Deployment failed due to API or network errors."
|
|
3385
3268
|
}
|
|
3386
3269
|
]
|
|
3387
3270
|
},
|
|
@@ -3391,29 +3274,25 @@
|
|
|
3391
3274
|
"commands",
|
|
3392
3275
|
"agent",
|
|
3393
3276
|
"test",
|
|
3394
|
-
"
|
|
3277
|
+
"create.js"
|
|
3395
3278
|
],
|
|
3396
3279
|
"aliasPermutations": [],
|
|
3397
3280
|
"permutations": [
|
|
3398
|
-
"agent:test:
|
|
3399
|
-
"test:agent:
|
|
3400
|
-
"test:
|
|
3401
|
-
"agent:
|
|
3402
|
-
"
|
|
3403
|
-
"
|
|
3281
|
+
"agent:test:create",
|
|
3282
|
+
"test:agent:create",
|
|
3283
|
+
"test:create:agent",
|
|
3284
|
+
"agent:create:test",
|
|
3285
|
+
"create:agent:test",
|
|
3286
|
+
"create:test:agent"
|
|
3404
3287
|
]
|
|
3405
3288
|
},
|
|
3406
|
-
"agent:test:
|
|
3289
|
+
"agent:test:list": {
|
|
3407
3290
|
"aliases": [],
|
|
3408
3291
|
"args": {},
|
|
3409
|
-
"description": "
|
|
3292
|
+
"description": "The command outputs a table with the name (API name) of each test along with its unique ID, type ('agentforce-studio' or 'testing-center'), and the date it was created in the org.",
|
|
3410
3293
|
"examples": [
|
|
3411
|
-
"
|
|
3412
|
-
"
|
|
3413
|
-
"Run tests using a JSON payload:\n<%= config.bin %> <%= command.id %> --spec specs/eval-payload.json --target-org my-org",
|
|
3414
|
-
"Run tests and output results in JUnit format; useful for continuous integration and deployment (CI/CD):\n<%= config.bin %> <%= command.id %> --spec specs/my-agent-testSpec.yaml --target-org my-org --result-format junit",
|
|
3415
|
-
"Run tests with contextVariables to inject contextual data into agent sessions (add contextVariables to test cases in your YAML spec):\n<%= config.bin %> <%= command.id %> --spec specs/agent-with-context.yaml --target-org my-org",
|
|
3416
|
-
"Pipe JSON payload from stdin (--spec flag is automatically populated from stdin):\n$ echo '{\"tests\":[...]}' | <%= config.bin %> <%= command.id %> --spec --target-org my-org"
|
|
3294
|
+
"List the agent tests in your default org:\n<%= config.bin %> <%= command.id %>",
|
|
3295
|
+
"List the agent tests in an org with alias \"my-org\"\"\n<%= config.bin %> <%= command.id %> --target-org my-org"
|
|
3417
3296
|
],
|
|
3418
3297
|
"flags": {
|
|
3419
3298
|
"json": {
|
|
@@ -3447,62 +3326,16 @@
|
|
|
3447
3326
|
"hasDynamicHelp": false,
|
|
3448
3327
|
"multiple": false,
|
|
3449
3328
|
"type": "option"
|
|
3450
|
-
},
|
|
3451
|
-
"spec": {
|
|
3452
|
-
"char": "s",
|
|
3453
|
-
"name": "spec",
|
|
3454
|
-
"required": true,
|
|
3455
|
-
"summary": "Path to test spec file (YAML or JSON). Supports reading from stdin when piping content.",
|
|
3456
|
-
"hasDynamicHelp": false,
|
|
3457
|
-
"multiple": false,
|
|
3458
|
-
"type": "option"
|
|
3459
|
-
},
|
|
3460
|
-
"api-name": {
|
|
3461
|
-
"char": "n",
|
|
3462
|
-
"name": "api-name",
|
|
3463
|
-
"summary": "Agent API name (also called DeveloperName) used to resolve agent_id and agent_version_id. Auto-inferred from the YAML spec's subjectName.",
|
|
3464
|
-
"hasDynamicHelp": false,
|
|
3465
|
-
"multiple": false,
|
|
3466
|
-
"type": "option"
|
|
3467
|
-
},
|
|
3468
|
-
"result-format": {
|
|
3469
|
-
"name": "result-format",
|
|
3470
|
-
"summary": "Format of the agent test run results.",
|
|
3471
|
-
"default": "human",
|
|
3472
|
-
"hasDynamicHelp": false,
|
|
3473
|
-
"multiple": false,
|
|
3474
|
-
"options": [
|
|
3475
|
-
"json",
|
|
3476
|
-
"human",
|
|
3477
|
-
"junit",
|
|
3478
|
-
"tap"
|
|
3479
|
-
],
|
|
3480
|
-
"type": "option"
|
|
3481
|
-
},
|
|
3482
|
-
"batch-size": {
|
|
3483
|
-
"name": "batch-size",
|
|
3484
|
-
"summary": "Number of tests per API request (max 5).",
|
|
3485
|
-
"default": 5,
|
|
3486
|
-
"hasDynamicHelp": false,
|
|
3487
|
-
"multiple": false,
|
|
3488
|
-
"type": "option"
|
|
3489
|
-
},
|
|
3490
|
-
"no-normalize": {
|
|
3491
|
-
"name": "no-normalize",
|
|
3492
|
-
"summary": "Disable auto-normalization of field names and shorthand references.",
|
|
3493
|
-
"allowNo": false,
|
|
3494
|
-
"type": "boolean"
|
|
3495
3329
|
}
|
|
3496
3330
|
},
|
|
3497
3331
|
"hasDynamicHelp": true,
|
|
3498
3332
|
"hiddenAliases": [],
|
|
3499
|
-
"id": "agent:test:
|
|
3333
|
+
"id": "agent:test:list",
|
|
3500
3334
|
"pluginAlias": "@salesforce/plugin-agent",
|
|
3501
3335
|
"pluginName": "@salesforce/plugin-agent",
|
|
3502
3336
|
"pluginType": "core",
|
|
3503
|
-
"state": "beta",
|
|
3504
3337
|
"strict": true,
|
|
3505
|
-
"summary": "
|
|
3338
|
+
"summary": "List the available agent tests in your org.",
|
|
3506
3339
|
"enableJsonFlag": true,
|
|
3507
3340
|
"envVariablesSection": {
|
|
3508
3341
|
"header": "ENVIRONMENT VARIABLES",
|
|
@@ -3518,19 +3351,11 @@
|
|
|
3518
3351
|
"body": [
|
|
3519
3352
|
{
|
|
3520
3353
|
"name": "Succeeded (0)",
|
|
3521
|
-
"description": "
|
|
3522
|
-
},
|
|
3523
|
-
{
|
|
3524
|
-
"name": "Failed (1)",
|
|
3525
|
-
"description": "Tests encountered execution errors (tests couldn't run properly)."
|
|
3526
|
-
},
|
|
3527
|
-
{
|
|
3528
|
-
"name": "NotFound (2)",
|
|
3529
|
-
"description": "Agent not found, spec file not found, or invalid agent name."
|
|
3354
|
+
"description": "Agent tests listed successfully."
|
|
3530
3355
|
},
|
|
3531
3356
|
{
|
|
3532
|
-
"name": "
|
|
3533
|
-
"description": "Failed to
|
|
3357
|
+
"name": "Failed (4)",
|
|
3358
|
+
"description": "Failed to retrieve agent tests due to API or network errors."
|
|
3534
3359
|
}
|
|
3535
3360
|
]
|
|
3536
3361
|
},
|
|
@@ -3540,26 +3365,26 @@
|
|
|
3540
3365
|
"commands",
|
|
3541
3366
|
"agent",
|
|
3542
3367
|
"test",
|
|
3543
|
-
"
|
|
3368
|
+
"list.js"
|
|
3544
3369
|
],
|
|
3545
3370
|
"aliasPermutations": [],
|
|
3546
3371
|
"permutations": [
|
|
3547
|
-
"agent:test:
|
|
3548
|
-
"test:agent:
|
|
3549
|
-
"test:
|
|
3550
|
-
"agent:
|
|
3551
|
-
"
|
|
3552
|
-
"
|
|
3372
|
+
"agent:test:list",
|
|
3373
|
+
"test:agent:list",
|
|
3374
|
+
"test:list:agent",
|
|
3375
|
+
"agent:list:test",
|
|
3376
|
+
"list:agent:test",
|
|
3377
|
+
"list:test:agent"
|
|
3553
3378
|
]
|
|
3554
3379
|
},
|
|
3555
|
-
"agent:test:
|
|
3380
|
+
"agent:test:results": {
|
|
3556
3381
|
"aliases": [],
|
|
3557
3382
|
"args": {},
|
|
3558
|
-
"description": "
|
|
3383
|
+
"description": "This command requires a job ID, which the original \"agent test run\" command displays when it completes. You can also use the --use-most-recent flag to see results for the most recently run agent test.\n\nBy default, this command outputs test results in human-readable tables for each test case. The tables show whether the test case passed, the expected and actual values, the test score, how long the test took, and more. Use the --result-format to display the test results in JSON or Junit format. Use the --output-dir flag to write the results to a file rather than to the terminal.",
|
|
3559
3384
|
"examples": [
|
|
3560
|
-
"
|
|
3561
|
-
"
|
|
3562
|
-
"
|
|
3385
|
+
"Get the results of an agent test run in your default org using its job ID:\n<%= config.bin %> <%= command.id %> --job-id 4KBfake0000003F4AQ",
|
|
3386
|
+
"Get the results of the most recently run agent test in an org with alias \"my-org\":\n<%= config.bin %> <%= command.id %> --use-most-recent --target-org my-org",
|
|
3387
|
+
"Get the results of the most recently run agent test in your default org, and write the JSON-formatted results into a directory called \"test-results\":\n<%= config.bin %> <%= command.id %> --use-most-recent --output-dir ./test-results --result-format json"
|
|
3563
3388
|
],
|
|
3564
3389
|
"flags": {
|
|
3565
3390
|
"json": {
|
|
@@ -3594,22 +3419,15 @@
|
|
|
3594
3419
|
"multiple": false,
|
|
3595
3420
|
"type": "option"
|
|
3596
3421
|
},
|
|
3597
|
-
"
|
|
3598
|
-
"char": "
|
|
3599
|
-
"name": "
|
|
3600
|
-
"
|
|
3422
|
+
"job-id": {
|
|
3423
|
+
"char": "i",
|
|
3424
|
+
"name": "job-id",
|
|
3425
|
+
"required": true,
|
|
3426
|
+
"summary": "Job ID of the completed agent test run.",
|
|
3601
3427
|
"hasDynamicHelp": false,
|
|
3602
3428
|
"multiple": false,
|
|
3603
3429
|
"type": "option"
|
|
3604
3430
|
},
|
|
3605
|
-
"wait": {
|
|
3606
|
-
"char": "w",
|
|
3607
|
-
"name": "wait",
|
|
3608
|
-
"summary": "Number of minutes to wait for the command to complete and display results to the terminal window.",
|
|
3609
|
-
"hasDynamicHelp": true,
|
|
3610
|
-
"multiple": false,
|
|
3611
|
-
"type": "option"
|
|
3612
|
-
},
|
|
3613
3431
|
"result-format": {
|
|
3614
3432
|
"name": "result-format",
|
|
3615
3433
|
"summary": "Format of the agent test run results.",
|
|
@@ -3655,12 +3473,12 @@
|
|
|
3655
3473
|
},
|
|
3656
3474
|
"hasDynamicHelp": true,
|
|
3657
3475
|
"hiddenAliases": [],
|
|
3658
|
-
"id": "agent:test:
|
|
3476
|
+
"id": "agent:test:results",
|
|
3659
3477
|
"pluginAlias": "@salesforce/plugin-agent",
|
|
3660
3478
|
"pluginName": "@salesforce/plugin-agent",
|
|
3661
3479
|
"pluginType": "core",
|
|
3662
3480
|
"strict": true,
|
|
3663
|
-
"summary": "
|
|
3481
|
+
"summary": "Get the results of a completed agent test run.",
|
|
3664
3482
|
"enableJsonFlag": true,
|
|
3665
3483
|
"envVariablesSection": {
|
|
3666
3484
|
"header": "ENVIRONMENT VARIABLES",
|
|
@@ -3676,19 +3494,15 @@
|
|
|
3676
3494
|
"body": [
|
|
3677
3495
|
{
|
|
3678
3496
|
"name": "Succeeded (0)",
|
|
3679
|
-
"description": "
|
|
3680
|
-
},
|
|
3681
|
-
{
|
|
3682
|
-
"name": "Failed (1)",
|
|
3683
|
-
"description": "Tests encountered execution errors (test cases with ERROR status when using --wait)."
|
|
3497
|
+
"description": "Results retrieved successfully. Test results (passed/failed) are in the output."
|
|
3684
3498
|
},
|
|
3685
3499
|
{
|
|
3686
3500
|
"name": "NotFound (2)",
|
|
3687
|
-
"description": "
|
|
3501
|
+
"description": "Job ID not found or invalid."
|
|
3688
3502
|
},
|
|
3689
3503
|
{
|
|
3690
|
-
"name": "
|
|
3691
|
-
"description": "Failed to
|
|
3504
|
+
"name": "Failed (4)",
|
|
3505
|
+
"description": "Failed to retrieve results due to API or network errors."
|
|
3692
3506
|
}
|
|
3693
3507
|
]
|
|
3694
3508
|
},
|
|
@@ -3698,29 +3512,26 @@
|
|
|
3698
3512
|
"commands",
|
|
3699
3513
|
"agent",
|
|
3700
3514
|
"test",
|
|
3701
|
-
"
|
|
3515
|
+
"results.js"
|
|
3702
3516
|
],
|
|
3703
3517
|
"aliasPermutations": [],
|
|
3704
3518
|
"permutations": [
|
|
3705
|
-
"agent:test:
|
|
3706
|
-
"test:agent:
|
|
3707
|
-
"test:
|
|
3708
|
-
"agent:
|
|
3709
|
-
"
|
|
3710
|
-
"
|
|
3519
|
+
"agent:test:results",
|
|
3520
|
+
"test:agent:results",
|
|
3521
|
+
"test:results:agent",
|
|
3522
|
+
"agent:results:test",
|
|
3523
|
+
"results:agent:test",
|
|
3524
|
+
"results:test:agent"
|
|
3711
3525
|
]
|
|
3712
3526
|
},
|
|
3713
|
-
"agent:
|
|
3527
|
+
"agent:test:resume": {
|
|
3714
3528
|
"aliases": [],
|
|
3715
3529
|
"args": {},
|
|
3716
|
-
"description": "
|
|
3530
|
+
"description": "This command requires a job ID, which the original \"agent test run\" command displays when it completes. You can also use the --use-most-recent flag to see results for the most recently run agent test.\n\nUse the --wait flag to specify the number of minutes for this command to wait for the agent test to complete; if the test completes by the end of the wait time, the command displays the test results. If not, the CLI returns control of the terminal to you, and you must run \"agent test resume\" again.\n\nBy default, this command outputs test results in human-readable tables for each test case. The tables show whether the test case passed, the expected and actual values, the test score, how long the test took, and more. Use the --result-format to display the test results in JSON or Junit format. Use the --output-dir flag to write the results to a file rather than to the terminal.",
|
|
3717
3531
|
"examples": [
|
|
3718
|
-
"
|
|
3719
|
-
"
|
|
3720
|
-
"
|
|
3721
|
-
"Delete traces older than 7 days:\n<%= config.bin %> <%= command.id %> --older-than 7d",
|
|
3722
|
-
"Delete traces older than 24 hours for a specific agent; don't prompt for confirmation:\n<%= config.bin %> <%= command.id %> --agent My_Agent --older-than 24h --no-prompt",
|
|
3723
|
-
"Delete all traces for all agents and sessions; don't prompt for confirmation:\n<%= config.bin %> <%= command.id %> --no-prompt"
|
|
3532
|
+
"Resume an agent test in your default org using a job ID:\n<%= config.bin %> <%= command.id %> --job-id 4KBfake0000003F4AQ",
|
|
3533
|
+
"Resume the most recently-run agent test in an org with alias \"my-org\" org; wait 10 minutes for the tests to finish:\n<%= config.bin %> <%= command.id %> --use-most-recent --wait 10 --target-org my-org",
|
|
3534
|
+
"Resume the most recent agent test in your default org, and write the JSON-formatted results into a directory called \"test-results\":\n<%= config.bin %> <%= command.id %> --use-most-recent --output-dir ./test-results --result-format json"
|
|
3724
3535
|
],
|
|
3725
3536
|
"flags": {
|
|
3726
3537
|
"json": {
|
|
@@ -3738,51 +3549,126 @@
|
|
|
3738
3549
|
"multiple": false,
|
|
3739
3550
|
"type": "option"
|
|
3740
3551
|
},
|
|
3741
|
-
"
|
|
3742
|
-
"char": "
|
|
3743
|
-
"name": "
|
|
3744
|
-
"
|
|
3552
|
+
"target-org": {
|
|
3553
|
+
"char": "o",
|
|
3554
|
+
"name": "target-org",
|
|
3555
|
+
"noCacheDefault": true,
|
|
3556
|
+
"required": true,
|
|
3557
|
+
"summary": "Username or alias of the target org. Not required if the `target-org` configuration variable is already set.",
|
|
3558
|
+
"hasDynamicHelp": true,
|
|
3559
|
+
"multiple": false,
|
|
3560
|
+
"type": "option"
|
|
3561
|
+
},
|
|
3562
|
+
"api-version": {
|
|
3563
|
+
"description": "Override the api version used for api requests made by this command",
|
|
3564
|
+
"name": "api-version",
|
|
3745
3565
|
"hasDynamicHelp": false,
|
|
3746
3566
|
"multiple": false,
|
|
3747
3567
|
"type": "option"
|
|
3748
3568
|
},
|
|
3749
|
-
"
|
|
3750
|
-
"
|
|
3751
|
-
"
|
|
3569
|
+
"job-id": {
|
|
3570
|
+
"char": "i",
|
|
3571
|
+
"name": "job-id",
|
|
3572
|
+
"summary": "Job ID of the original agent test run.",
|
|
3752
3573
|
"hasDynamicHelp": false,
|
|
3753
3574
|
"multiple": false,
|
|
3754
3575
|
"type": "option"
|
|
3755
3576
|
},
|
|
3756
|
-
"
|
|
3757
|
-
"
|
|
3758
|
-
"
|
|
3577
|
+
"use-most-recent": {
|
|
3578
|
+
"char": "r",
|
|
3579
|
+
"name": "use-most-recent",
|
|
3580
|
+
"summary": "Use the job ID of the most recent agent test run.",
|
|
3581
|
+
"allowNo": false,
|
|
3582
|
+
"type": "boolean"
|
|
3583
|
+
},
|
|
3584
|
+
"wait": {
|
|
3585
|
+
"char": "w",
|
|
3586
|
+
"name": "wait",
|
|
3587
|
+
"summary": "Number of minutes to wait for the command to complete and display results to the terminal window.",
|
|
3588
|
+
"default": "5 minutes",
|
|
3589
|
+
"hasDynamicHelp": true,
|
|
3590
|
+
"multiple": false,
|
|
3591
|
+
"type": "option"
|
|
3592
|
+
},
|
|
3593
|
+
"result-format": {
|
|
3594
|
+
"name": "result-format",
|
|
3595
|
+
"summary": "Format of the agent test run results.",
|
|
3596
|
+
"default": "human",
|
|
3759
3597
|
"hasDynamicHelp": false,
|
|
3760
3598
|
"multiple": false,
|
|
3599
|
+
"options": [
|
|
3600
|
+
"json",
|
|
3601
|
+
"human",
|
|
3602
|
+
"junit",
|
|
3603
|
+
"tap"
|
|
3604
|
+
],
|
|
3761
3605
|
"type": "option"
|
|
3762
3606
|
},
|
|
3763
|
-
"
|
|
3764
|
-
"
|
|
3765
|
-
"
|
|
3607
|
+
"output-dir": {
|
|
3608
|
+
"char": "d",
|
|
3609
|
+
"description": "If the agent test run completes, write the results to the specified directory. If the test is still running, the test results aren't written.",
|
|
3610
|
+
"name": "output-dir",
|
|
3611
|
+
"summary": "Directory to write the agent test results into.",
|
|
3612
|
+
"hasDynamicHelp": false,
|
|
3613
|
+
"multiple": false,
|
|
3614
|
+
"type": "option"
|
|
3615
|
+
},
|
|
3616
|
+
"test-runner": {
|
|
3617
|
+
"description": "By default, the command automatically detects which test runner to use based on the test definition metadata type in your org. Use this flag to explicitly specify the runner type. 'agentforce-studio' uses AiTestingDefinition metadata. 'testing-center' uses AiEvaluationDefinition metadata.",
|
|
3618
|
+
"name": "test-runner",
|
|
3619
|
+
"summary": "Explicitly specify which test runner to use (agentforce-studio or testing-center).",
|
|
3620
|
+
"hasDynamicHelp": false,
|
|
3621
|
+
"multiple": false,
|
|
3622
|
+
"options": [
|
|
3623
|
+
"agentforce-studio",
|
|
3624
|
+
"testing-center"
|
|
3625
|
+
],
|
|
3626
|
+
"type": "option"
|
|
3627
|
+
},
|
|
3628
|
+
"verbose": {
|
|
3629
|
+
"description": "When enabled, includes detailed generated data (such as invoked actions) in the human-readable test results output. This is useful for debugging test failures and understanding what actions were actually invoked during the test run.\n\nThe generated data is in JSON format and includes the Apex classes or Flows that were invoked, the Salesforce objects that were touched, and so on. Use the JSON structure of this information to build the test case JSONPath expression when using custom evaluations.",
|
|
3630
|
+
"name": "verbose",
|
|
3631
|
+
"summary": "Show generated data in the test results output.",
|
|
3766
3632
|
"allowNo": false,
|
|
3767
3633
|
"type": "boolean"
|
|
3768
3634
|
}
|
|
3769
3635
|
},
|
|
3770
|
-
"hasDynamicHelp":
|
|
3636
|
+
"hasDynamicHelp": true,
|
|
3771
3637
|
"hiddenAliases": [],
|
|
3772
|
-
"id": "agent:
|
|
3638
|
+
"id": "agent:test:resume",
|
|
3773
3639
|
"pluginAlias": "@salesforce/plugin-agent",
|
|
3774
3640
|
"pluginName": "@salesforce/plugin-agent",
|
|
3775
3641
|
"pluginType": "core",
|
|
3776
3642
|
"strict": true,
|
|
3777
|
-
"summary": "
|
|
3643
|
+
"summary": "Resume an agent test that you previously started in your org so you can view the test results.",
|
|
3778
3644
|
"enableJsonFlag": true,
|
|
3779
|
-
"
|
|
3645
|
+
"envVariablesSection": {
|
|
3646
|
+
"header": "ENVIRONMENT VARIABLES",
|
|
3647
|
+
"body": [
|
|
3648
|
+
{
|
|
3649
|
+
"name": "SF_TARGET_ORG",
|
|
3650
|
+
"description": "Username or alias of your default org. Overrides the target-org configuration variable."
|
|
3651
|
+
}
|
|
3652
|
+
]
|
|
3653
|
+
},
|
|
3780
3654
|
"errorCodes": {
|
|
3781
3655
|
"header": "ERROR CODES",
|
|
3782
3656
|
"body": [
|
|
3783
3657
|
{
|
|
3784
3658
|
"name": "Succeeded (0)",
|
|
3785
|
-
"description": "
|
|
3659
|
+
"description": "Test completed successfully (with test results in the output)."
|
|
3660
|
+
},
|
|
3661
|
+
{
|
|
3662
|
+
"name": "Failed (1)",
|
|
3663
|
+
"description": "Tests encountered execution errors (test cases with ERROR status)."
|
|
3664
|
+
},
|
|
3665
|
+
{
|
|
3666
|
+
"name": "NotFound (2)",
|
|
3667
|
+
"description": "Job ID not found or invalid."
|
|
3668
|
+
},
|
|
3669
|
+
{
|
|
3670
|
+
"name": "OperationFailed (4)",
|
|
3671
|
+
"description": "Failed to poll test due to API or network errors."
|
|
3786
3672
|
}
|
|
3787
3673
|
]
|
|
3788
3674
|
},
|
|
@@ -3791,31 +3677,30 @@
|
|
|
3791
3677
|
"lib",
|
|
3792
3678
|
"commands",
|
|
3793
3679
|
"agent",
|
|
3794
|
-
"
|
|
3795
|
-
"
|
|
3680
|
+
"test",
|
|
3681
|
+
"resume.js"
|
|
3796
3682
|
],
|
|
3797
3683
|
"aliasPermutations": [],
|
|
3798
3684
|
"permutations": [
|
|
3799
|
-
"agent:
|
|
3800
|
-
"
|
|
3801
|
-
"
|
|
3802
|
-
"agent:
|
|
3803
|
-
"
|
|
3804
|
-
"
|
|
3685
|
+
"agent:test:resume",
|
|
3686
|
+
"test:agent:resume",
|
|
3687
|
+
"test:resume:agent",
|
|
3688
|
+
"agent:resume:test",
|
|
3689
|
+
"resume:agent:test",
|
|
3690
|
+
"resume:test:agent"
|
|
3805
3691
|
]
|
|
3806
3692
|
},
|
|
3807
|
-
"agent:
|
|
3693
|
+
"agent:test:run-eval": {
|
|
3808
3694
|
"aliases": [],
|
|
3809
3695
|
"args": {},
|
|
3810
|
-
"description": "
|
|
3696
|
+
"description": "Specify the tests you want to run with one of these inputs to the --spec flag:\n\n- YAML test spec generated by the `agent generate test-spec` CLI command\n- JSON payload\n\nWhen you provide a YAML test spec, this command automatically translates test cases into internal state-based evaluation framework calls and infers the agent name from the test spec's `subjectName` field. As a result, you can use the same test spec with both the `agent test run` and `agent test run-eval` commands. YAML test specs also support context variables, which allow you to inject contextual data (such as CaseId or RoutableId) into agent sessions for testing with different contexts.\n\nWhen you provide a JSON payload, it's sent directly to the evaluation framework with optional normalization. The normalizer auto-corrects common field name mistakes, converts shorthand references to JSONPath, and injects defaults. Use `--no-normalize` to disable this auto-normalization. JSON payloads can also include context_variables on agent.create_session steps for the same contextual testing capabilities as when you use a YAML test spec.\n\nThis command supports more than 8 evaluator types, including subagent routing assertions, action invocation checks, string/numeric assertions, semantic similarity scoring, and LLM-based quality ratings.",
|
|
3811
3697
|
"examples": [
|
|
3812
|
-
"
|
|
3813
|
-
"
|
|
3814
|
-
"
|
|
3815
|
-
"
|
|
3816
|
-
"
|
|
3817
|
-
"
|
|
3818
|
-
"Return results as JSON:\n<%= config.bin %> <%= command.id %> --json"
|
|
3698
|
+
"Run tests using a YAML test spec on the org with alias \"my-org\":\n<%= config.bin %> <%= command.id %> --spec specs/my-agent-testSpec.yaml --target-org my-org",
|
|
3699
|
+
"Run tests using a YAML spec with explicit agent name override; use your default org:\n<%= config.bin %> <%= command.id %> --spec specs/my-agent-testSpec.yaml --api-name My_Agent",
|
|
3700
|
+
"Run tests using a JSON payload:\n<%= config.bin %> <%= command.id %> --spec specs/eval-payload.json --target-org my-org",
|
|
3701
|
+
"Run tests and output results in JUnit format; useful for continuous integration and deployment (CI/CD):\n<%= config.bin %> <%= command.id %> --spec specs/my-agent-testSpec.yaml --target-org my-org --result-format junit",
|
|
3702
|
+
"Run tests with contextVariables to inject contextual data into agent sessions (add contextVariables to test cases in your YAML spec):\n<%= config.bin %> <%= command.id %> --spec specs/agent-with-context.yaml --target-org my-org",
|
|
3703
|
+
"Pipe JSON payload from stdin (--spec flag is automatically populated from stdin):\n$ echo '{\"tests\":[...]}' | <%= config.bin %> <%= command.id %> --spec --target-org my-org"
|
|
3819
3704
|
],
|
|
3820
3705
|
"flags": {
|
|
3821
3706
|
"json": {
|
|
@@ -3833,46 +3718,106 @@
|
|
|
3833
3718
|
"multiple": false,
|
|
3834
3719
|
"type": "option"
|
|
3835
3720
|
},
|
|
3836
|
-
"
|
|
3837
|
-
"
|
|
3838
|
-
"
|
|
3721
|
+
"target-org": {
|
|
3722
|
+
"char": "o",
|
|
3723
|
+
"name": "target-org",
|
|
3724
|
+
"noCacheDefault": true,
|
|
3725
|
+
"required": true,
|
|
3726
|
+
"summary": "Username or alias of the target org. Not required if the `target-org` configuration variable is already set.",
|
|
3727
|
+
"hasDynamicHelp": true,
|
|
3728
|
+
"multiple": false,
|
|
3729
|
+
"type": "option"
|
|
3730
|
+
},
|
|
3731
|
+
"api-version": {
|
|
3732
|
+
"description": "Override the api version used for api requests made by this command",
|
|
3733
|
+
"name": "api-version",
|
|
3839
3734
|
"hasDynamicHelp": false,
|
|
3840
3735
|
"multiple": false,
|
|
3841
3736
|
"type": "option"
|
|
3842
3737
|
},
|
|
3843
|
-
"
|
|
3844
|
-
"char": "
|
|
3845
|
-
"name": "
|
|
3846
|
-
"
|
|
3738
|
+
"spec": {
|
|
3739
|
+
"char": "s",
|
|
3740
|
+
"name": "spec",
|
|
3741
|
+
"required": true,
|
|
3742
|
+
"summary": "Path to test spec file (YAML or JSON). Supports reading from stdin when piping content.",
|
|
3847
3743
|
"hasDynamicHelp": false,
|
|
3848
3744
|
"multiple": false,
|
|
3849
3745
|
"type": "option"
|
|
3850
3746
|
},
|
|
3851
|
-
"
|
|
3852
|
-
"
|
|
3853
|
-
"name": "
|
|
3854
|
-
"summary": "
|
|
3747
|
+
"api-name": {
|
|
3748
|
+
"char": "n",
|
|
3749
|
+
"name": "api-name",
|
|
3750
|
+
"summary": "Agent API name (also called DeveloperName) used to resolve agent_id and agent_version_id. Auto-inferred from the YAML spec's subjectName.",
|
|
3751
|
+
"hasDynamicHelp": false,
|
|
3752
|
+
"multiple": false,
|
|
3753
|
+
"type": "option"
|
|
3754
|
+
},
|
|
3755
|
+
"result-format": {
|
|
3756
|
+
"name": "result-format",
|
|
3757
|
+
"summary": "Format of the agent test run results.",
|
|
3758
|
+
"default": "human",
|
|
3759
|
+
"hasDynamicHelp": false,
|
|
3760
|
+
"multiple": false,
|
|
3761
|
+
"options": [
|
|
3762
|
+
"json",
|
|
3763
|
+
"human",
|
|
3764
|
+
"junit",
|
|
3765
|
+
"tap"
|
|
3766
|
+
],
|
|
3767
|
+
"type": "option"
|
|
3768
|
+
},
|
|
3769
|
+
"batch-size": {
|
|
3770
|
+
"name": "batch-size",
|
|
3771
|
+
"summary": "Number of tests per API request (max 5).",
|
|
3772
|
+
"default": 5,
|
|
3855
3773
|
"hasDynamicHelp": false,
|
|
3856
3774
|
"multiple": false,
|
|
3857
3775
|
"type": "option"
|
|
3776
|
+
},
|
|
3777
|
+
"no-normalize": {
|
|
3778
|
+
"name": "no-normalize",
|
|
3779
|
+
"summary": "Disable auto-normalization of field names and shorthand references.",
|
|
3780
|
+
"allowNo": false,
|
|
3781
|
+
"type": "boolean"
|
|
3858
3782
|
}
|
|
3859
3783
|
},
|
|
3860
|
-
"hasDynamicHelp":
|
|
3784
|
+
"hasDynamicHelp": true,
|
|
3861
3785
|
"hiddenAliases": [],
|
|
3862
|
-
"id": "agent:
|
|
3786
|
+
"id": "agent:test:run-eval",
|
|
3863
3787
|
"pluginAlias": "@salesforce/plugin-agent",
|
|
3864
3788
|
"pluginName": "@salesforce/plugin-agent",
|
|
3865
3789
|
"pluginType": "core",
|
|
3790
|
+
"state": "beta",
|
|
3866
3791
|
"strict": true,
|
|
3867
|
-
"summary": "
|
|
3792
|
+
"summary": "Run rich evaluation tests against an Agentforce agent.",
|
|
3868
3793
|
"enableJsonFlag": true,
|
|
3869
|
-
"
|
|
3794
|
+
"envVariablesSection": {
|
|
3795
|
+
"header": "ENVIRONMENT VARIABLES",
|
|
3796
|
+
"body": [
|
|
3797
|
+
{
|
|
3798
|
+
"name": "SF_TARGET_ORG",
|
|
3799
|
+
"description": "Username or alias of your default org. Overrides the target-org configuration variable."
|
|
3800
|
+
}
|
|
3801
|
+
]
|
|
3802
|
+
},
|
|
3870
3803
|
"errorCodes": {
|
|
3871
3804
|
"header": "ERROR CODES",
|
|
3872
3805
|
"body": [
|
|
3873
3806
|
{
|
|
3874
3807
|
"name": "Succeeded (0)",
|
|
3875
|
-
"description": "
|
|
3808
|
+
"description": "Tests completed successfully. Test results (passed/failed) are in the JSON output."
|
|
3809
|
+
},
|
|
3810
|
+
{
|
|
3811
|
+
"name": "Failed (1)",
|
|
3812
|
+
"description": "Tests encountered execution errors (tests couldn't run properly)."
|
|
3813
|
+
},
|
|
3814
|
+
{
|
|
3815
|
+
"name": "NotFound (2)",
|
|
3816
|
+
"description": "Agent not found, spec file not found, or invalid agent name."
|
|
3817
|
+
},
|
|
3818
|
+
{
|
|
3819
|
+
"name": "OperationFailed (4)",
|
|
3820
|
+
"description": "Failed to execute tests due to API or network errors."
|
|
3876
3821
|
}
|
|
3877
3822
|
]
|
|
3878
3823
|
},
|
|
@@ -3881,31 +3826,27 @@
|
|
|
3881
3826
|
"lib",
|
|
3882
3827
|
"commands",
|
|
3883
3828
|
"agent",
|
|
3884
|
-
"
|
|
3885
|
-
"
|
|
3829
|
+
"test",
|
|
3830
|
+
"run-eval.js"
|
|
3886
3831
|
],
|
|
3887
3832
|
"aliasPermutations": [],
|
|
3888
3833
|
"permutations": [
|
|
3889
|
-
"agent:
|
|
3890
|
-
"
|
|
3891
|
-
"
|
|
3892
|
-
"agent:
|
|
3893
|
-
"
|
|
3894
|
-
"
|
|
3834
|
+
"agent:test:run-eval",
|
|
3835
|
+
"test:agent:run-eval",
|
|
3836
|
+
"test:run-eval:agent",
|
|
3837
|
+
"agent:run-eval:test",
|
|
3838
|
+
"run-eval:agent:test",
|
|
3839
|
+
"run-eval:test:agent"
|
|
3895
3840
|
]
|
|
3896
3841
|
},
|
|
3897
|
-
"agent:
|
|
3842
|
+
"agent:test:run": {
|
|
3898
3843
|
"aliases": [],
|
|
3899
3844
|
"args": {},
|
|
3900
|
-
"description": "
|
|
3845
|
+
"description": "Use the --api-name flag to specify the name of the agent test you want to run. Use the output of the \"agent test list\" command to get the names of all the available agent tests in your org.\n\nBy default, this command starts the agent test in your org, but it doesn't wait for the test to finish. Instead, it displays the \"agent test resume\" command, with a job ID, that you execute to see the results of the test run, and then returns control of the terminal window to you. Use the --wait flag to specify the number of minutes for the command to wait for the agent test to complete; if the test completes by the end of the wait time, the command displays the test results. If not, run \"agent test resume\".\n\nBy default, this command outputs test results in human-readable tables for each test case, if the test completes in time. The tables show whether the test case passed, the expected and actual values, the test score, how long the test took, and more. Use the --result-format to display the test results in JSON or Junit format. Use the --output-dir flag to write the results to a file rather than to the terminal.",
|
|
3901
3846
|
"examples": [
|
|
3902
|
-
"
|
|
3903
|
-
"
|
|
3904
|
-
"
|
|
3905
|
-
"Drill into routing decisions for the first turn of the conversation:\n<%= config.bin %> <%= command.id %> --session-id <SESSION_ID> --format detail --dimension routing --turn 1",
|
|
3906
|
-
"Show all errors across the session:\n<%= config.bin %> <%= command.id %> --session-id <SESSION_ID> --format detail --dimension errors",
|
|
3907
|
-
"Output raw trace JSON for custom parsing:\n<%= config.bin %> <%= command.id %> --session-id <SESSION_ID> --format raw",
|
|
3908
|
-
"Return results as JSON:\n<%= config.bin %> <%= command.id %> --session-id <SESSION_ID> --json"
|
|
3847
|
+
"Start an agent test called Resort_Manager_Test for an agent in your default org, don't wait for the test to finish:\n<%= config.bin %> <%= command.id %> --api-name Resort_Manager_Test",
|
|
3848
|
+
"Start an agent test for an agent in an org with alias \"my-org\" and wait for 10 minutes for the test to finish:\n<%= config.bin %> <%= command.id %> --api-name Resort_Manager_Test --wait 10 --target-org my-org",
|
|
3849
|
+
"Start an agent test and write the JSON-formatted results into a directory called \"test-results\":\n<%= config.bin %> <%= command.id %> --api-name Resort_Manager_Test --wait 10 --output-dir ./test-results --result-format json"
|
|
3909
3850
|
],
|
|
3910
3851
|
"flags": {
|
|
3911
3852
|
"json": {
|
|
@@ -3923,78 +3864,137 @@
|
|
|
3923
3864
|
"multiple": false,
|
|
3924
3865
|
"type": "option"
|
|
3925
3866
|
},
|
|
3926
|
-
"
|
|
3927
|
-
"char": "
|
|
3928
|
-
"name": "
|
|
3867
|
+
"target-org": {
|
|
3868
|
+
"char": "o",
|
|
3869
|
+
"name": "target-org",
|
|
3870
|
+
"noCacheDefault": true,
|
|
3929
3871
|
"required": true,
|
|
3930
|
-
"summary": "
|
|
3872
|
+
"summary": "Username or alias of the target org. Not required if the `target-org` configuration variable is already set.",
|
|
3873
|
+
"hasDynamicHelp": true,
|
|
3874
|
+
"multiple": false,
|
|
3875
|
+
"type": "option"
|
|
3876
|
+
},
|
|
3877
|
+
"api-version": {
|
|
3878
|
+
"description": "Override the api version used for api requests made by this command",
|
|
3879
|
+
"name": "api-version",
|
|
3931
3880
|
"hasDynamicHelp": false,
|
|
3932
3881
|
"multiple": false,
|
|
3933
3882
|
"type": "option"
|
|
3934
3883
|
},
|
|
3935
|
-
"
|
|
3936
|
-
"char": "
|
|
3937
|
-
"name": "
|
|
3938
|
-
"summary": "
|
|
3939
|
-
"
|
|
3884
|
+
"api-name": {
|
|
3885
|
+
"char": "n",
|
|
3886
|
+
"name": "api-name",
|
|
3887
|
+
"summary": "API name of the agent test to run; corresponds to the name of the AiEvaluationDefinition metadata component that implements the agent test.",
|
|
3888
|
+
"hasDynamicHelp": false,
|
|
3889
|
+
"multiple": false,
|
|
3890
|
+
"type": "option"
|
|
3891
|
+
},
|
|
3892
|
+
"wait": {
|
|
3893
|
+
"char": "w",
|
|
3894
|
+
"name": "wait",
|
|
3895
|
+
"summary": "Number of minutes to wait for the command to complete and display results to the terminal window.",
|
|
3896
|
+
"hasDynamicHelp": true,
|
|
3897
|
+
"multiple": false,
|
|
3898
|
+
"type": "option"
|
|
3899
|
+
},
|
|
3900
|
+
"result-format": {
|
|
3901
|
+
"name": "result-format",
|
|
3902
|
+
"summary": "Format of the agent test run results.",
|
|
3903
|
+
"default": "human",
|
|
3940
3904
|
"hasDynamicHelp": false,
|
|
3941
3905
|
"multiple": false,
|
|
3942
3906
|
"options": [
|
|
3943
|
-
"
|
|
3944
|
-
"
|
|
3945
|
-
"
|
|
3907
|
+
"json",
|
|
3908
|
+
"human",
|
|
3909
|
+
"junit",
|
|
3910
|
+
"tap"
|
|
3946
3911
|
],
|
|
3947
3912
|
"type": "option"
|
|
3948
3913
|
},
|
|
3949
|
-
"
|
|
3914
|
+
"output-dir": {
|
|
3950
3915
|
"char": "d",
|
|
3951
|
-
"
|
|
3952
|
-
"
|
|
3916
|
+
"description": "If the agent test run completes, write the results to the specified directory. If the test is still running, the test results aren't written.",
|
|
3917
|
+
"name": "output-dir",
|
|
3918
|
+
"summary": "Directory to write the agent test results into.",
|
|
3953
3919
|
"hasDynamicHelp": false,
|
|
3954
3920
|
"multiple": false,
|
|
3955
|
-
"options": [
|
|
3956
|
-
"actions",
|
|
3957
|
-
"grounding",
|
|
3958
|
-
"routing",
|
|
3959
|
-
"errors"
|
|
3960
|
-
],
|
|
3961
3921
|
"type": "option"
|
|
3962
3922
|
},
|
|
3963
|
-
"
|
|
3964
|
-
"
|
|
3965
|
-
"name": "
|
|
3966
|
-
"summary": "
|
|
3923
|
+
"test-runner": {
|
|
3924
|
+
"description": "By default, the command automatically detects which test runner to use based on the test definition metadata type in your org. Use this flag to explicitly specify the runner type. 'agentforce-studio' uses AiTestingDefinition metadata. 'testing-center' uses AiEvaluationDefinition metadata.",
|
|
3925
|
+
"name": "test-runner",
|
|
3926
|
+
"summary": "Explicitly specify which test runner to use (agentforce-studio or testing-center).",
|
|
3967
3927
|
"hasDynamicHelp": false,
|
|
3968
3928
|
"multiple": false,
|
|
3929
|
+
"options": [
|
|
3930
|
+
"agentforce-studio",
|
|
3931
|
+
"testing-center"
|
|
3932
|
+
],
|
|
3969
3933
|
"type": "option"
|
|
3934
|
+
},
|
|
3935
|
+
"verbose": {
|
|
3936
|
+
"description": "When enabled, includes detailed generated data (such as invoked actions) in the human-readable test results output. This is useful for debugging test failures and understanding what actions were actually invoked during the test run.\n\nThe generated data is in JSON format and includes the Apex classes or Flows that were invoked, the Salesforce objects that were touched, and so on. Use the JSON structure of this information to build the test case JSONPath expression when using custom evaluations.",
|
|
3937
|
+
"name": "verbose",
|
|
3938
|
+
"summary": "Show generated data in the test results output.",
|
|
3939
|
+
"allowNo": false,
|
|
3940
|
+
"type": "boolean"
|
|
3970
3941
|
}
|
|
3971
3942
|
},
|
|
3972
|
-
"hasDynamicHelp":
|
|
3943
|
+
"hasDynamicHelp": true,
|
|
3973
3944
|
"hiddenAliases": [],
|
|
3974
|
-
"id": "agent:
|
|
3945
|
+
"id": "agent:test:run",
|
|
3975
3946
|
"pluginAlias": "@salesforce/plugin-agent",
|
|
3976
3947
|
"pluginName": "@salesforce/plugin-agent",
|
|
3977
3948
|
"pluginType": "core",
|
|
3978
3949
|
"strict": true,
|
|
3979
|
-
"summary": "
|
|
3950
|
+
"summary": "Start an agent test in your org.",
|
|
3980
3951
|
"enableJsonFlag": true,
|
|
3981
|
-
"
|
|
3952
|
+
"envVariablesSection": {
|
|
3953
|
+
"header": "ENVIRONMENT VARIABLES",
|
|
3954
|
+
"body": [
|
|
3955
|
+
{
|
|
3956
|
+
"name": "SF_TARGET_ORG",
|
|
3957
|
+
"description": "Username or alias of your default org. Overrides the target-org configuration variable."
|
|
3958
|
+
}
|
|
3959
|
+
]
|
|
3960
|
+
},
|
|
3961
|
+
"errorCodes": {
|
|
3962
|
+
"header": "ERROR CODES",
|
|
3963
|
+
"body": [
|
|
3964
|
+
{
|
|
3965
|
+
"name": "Succeeded (0)",
|
|
3966
|
+
"description": "Test started successfully (without --wait), or test completed successfully (with --wait)."
|
|
3967
|
+
},
|
|
3968
|
+
{
|
|
3969
|
+
"name": "Failed (1)",
|
|
3970
|
+
"description": "Tests encountered execution errors (test cases with ERROR status when using --wait)."
|
|
3971
|
+
},
|
|
3972
|
+
{
|
|
3973
|
+
"name": "NotFound (2)",
|
|
3974
|
+
"description": "Test definition not found or invalid test name."
|
|
3975
|
+
},
|
|
3976
|
+
{
|
|
3977
|
+
"name": "OperationFailed (4)",
|
|
3978
|
+
"description": "Failed to start or poll test due to API or network errors."
|
|
3979
|
+
}
|
|
3980
|
+
]
|
|
3981
|
+
},
|
|
3982
3982
|
"isESM": true,
|
|
3983
3983
|
"relativePath": [
|
|
3984
3984
|
"lib",
|
|
3985
3985
|
"commands",
|
|
3986
3986
|
"agent",
|
|
3987
|
-
"
|
|
3988
|
-
"
|
|
3987
|
+
"test",
|
|
3988
|
+
"run.js"
|
|
3989
3989
|
],
|
|
3990
3990
|
"aliasPermutations": [],
|
|
3991
3991
|
"permutations": [
|
|
3992
|
-
"agent:
|
|
3993
|
-
"
|
|
3994
|
-
"
|
|
3995
|
-
"agent:
|
|
3996
|
-
"
|
|
3997
|
-
"
|
|
3992
|
+
"agent:test:run",
|
|
3993
|
+
"test:agent:run",
|
|
3994
|
+
"test:run:agent",
|
|
3995
|
+
"agent:run:test",
|
|
3996
|
+
"run:agent:test",
|
|
3997
|
+
"run:test:agent"
|
|
3998
3998
|
]
|
|
3999
3999
|
},
|
|
4000
4000
|
"agent:validate:authoring-bundle": {
|
|
@@ -4667,5 +4667,5 @@
|
|
|
4667
4667
|
]
|
|
4668
4668
|
}
|
|
4669
4669
|
},
|
|
4670
|
-
"version": "
|
|
4670
|
+
"version": "2.0.0"
|
|
4671
4671
|
}
|