FEAT: Custom scenario parameters from CLI and YAML

.pyrit_conf_example

@@ -54,6 +54,22 @@ initializers:
         - default
         - scorer
 
+# Default Scenario
+# ----------------
+# Optional default scenario to run when invoking `pyrit_scan` without a
+# positional scenario name. Also accepts custom parameters declared by the
+# scenario via its `supported_parameters()` classmethod (see
+# `pyrit_scan <scenario> --help` to discover them).
+#
+# - name: scenario registry name (e.g. `airt.scam`, `foundry.red_team_agent`)
+# - args: per-scenario custom parameters; CLI flags override these per key
+#
+# Example:
+# scenario:
+#   name: airt.scam
+#   args:
+#     max_turns: 10
+
 # Operator and Operation Labels
 # ------------------------------
 # Default labels applied to all attacks created with PyRIT.

doc/code/scenarios/0_scenarios.ipynb

@@ -36,7 +36,7 @@
     "\n",
     "Scenarios should take almost no effort to run with default values. The [PyRIT Scanner](../../scanner/0_scanner.md) provides two CLIs for running scenarios: [pyrit_scan](../../scanner/1_pyrit_scan.ipynb) for automated execution and [pyrit_shell](../../scanner/2_pyrit_shell.md) for interactive exploration.\n",
     "\n",
-    "For programmatic configuration — customizing datasets, strategies, scorers, and baseline mode — see [Scenario Parameters](./1_scenario_parameters.ipynb).\n",
+    "For programmatic configuration — customizing datasets, strategies, scorers, and baseline mode — see [Common Scenario Parameters](./1_common_scenario_parameters.ipynb).\n",
     "\n",
     "## How It Works\n",
     "\n",
@@ -393,7 +393,7 @@
     "\n",
     "To run *only* the baseline (no attack strategies), create a `RedTeamAgent` with\n",
     "`include_baseline=True` (the default) and pass `scenario_strategies=None`. See\n",
-    "[Scenario Parameters](./1_scenario_parameters.ipynb) for a working example."
+    "[Common Scenario Parameters](./1_common_scenario_parameters.ipynb) for a working example."
    ]
   },
   {
@@ -423,6 +423,9 @@
   }
  ],
  "metadata": {
+  "jupytext": {
+   "main_language": "python"
+  },
   "language_info": {
    "codemirror_mode": {
     "name": "ipython",

doc/code/scenarios/0_scenarios.py

@@ -38,7 +38,7 @@
 #
 # Scenarios should take almost no effort to run with default values. The [PyRIT Scanner](../../scanner/0_scanner.md) provides two CLIs for running scenarios: [pyrit_scan](../../scanner/1_pyrit_scan.ipynb) for automated execution and [pyrit_shell](../../scanner/2_pyrit_shell.md) for interactive exploration.
 #
-# For programmatic configuration — customizing datasets, strategies, scorers, and baseline mode — see [Scenario Parameters](./1_scenario_parameters.ipynb).
+# For programmatic configuration — customizing datasets, strategies, scorers, and baseline mode — see [Common Scenario Parameters](./1_common_scenario_parameters.ipynb).
 #
 # ## How It Works
 #
@@ -178,7 +178,7 @@ def _build_display_group(self, *, technique_name: str, seed_group_name: str) ->
 #
 # To run *only* the baseline (no attack strategies), create a `RedTeamAgent` with
 # `include_baseline=True` (the default) and pass `scenario_strategies=None`. See
-# [Scenario Parameters](./1_scenario_parameters.ipynb) for a working example.
+# [Common Scenario Parameters](./1_common_scenario_parameters.ipynb) for a working example.
 
 # %% [markdown]
 #

doc/code/scenarios/1_scenario_parameters.ipynb → doc/code/scenarios/1_common_scenario_parameters.ipynb

@@ -5,7 +5,7 @@
    "id": "0",
    "metadata": {},
    "source": [
-    "# Scenario Parameters\n",
+    "# Common Scenario Parameters\n",
     "\n",
     "This guide covers the key parameters for configuring scenarios programmatically: datasets,\n",
     "strategies, baseline execution, and custom scorers. All examples use `RedTeamAgent` but the\n",
@@ -455,6 +455,9 @@
   }
  ],
  "metadata": {
+  "jupytext": {
+   "main_language": "python"
+  },
   "language_info": {
    "codemirror_mode": {
     "name": "ipython",

doc/code/scenarios/1_scenario_parameters.py → doc/code/scenarios/1_common_scenario_parameters.py

@@ -9,7 +9,7 @@
 # ---
 
 # %% [markdown]
-# # Scenario Parameters
+# # Common Scenario Parameters
 #
 # This guide covers the key parameters for configuring scenarios programmatically: datasets,
 # strategies, baseline execution, and custom scorers. All examples use `RedTeamAgent` but the