Auto-update documentation (#19183)

Co-authored-by: github-actions[bot] <github-actions[bot]@users.noreply.github.com>

Author: github-actions[bot]

docs/docs.json

@@ -869,6 +869,7 @@
                       "v3/api-ref/python/prefect-cli-deployment",
                       "v3/api-ref/python/prefect-cli-dev",
                       "v3/api-ref/python/prefect-cli-events",
+                      "v3/api-ref/python/prefect-cli-experimental",
                       "v3/api-ref/python/prefect-cli-flow",
                       "v3/api-ref/python/prefect-cli-flow_run",
                       "v3/api-ref/python/prefect-cli-flow_runs_watching",

docs/v3/api-ref/python/prefect-cli-experimental.mdx

@@ -0,0 +1,34 @@
+---
+title: experimental
+sidebarTitle: experimental
+---
+
+# `prefect.cli.experimental`
+
+
+
+Experimental CLI commands.
+
+These commands provide access to experimental features that are subject to change.
+
+
+## Functions
+
+### `diagnose` <sup><a href="https://github.com/PrefectHQ/prefect/blob/main/src/prefect/cli/experimental.py#L31" target="_blank"><Icon icon="github" style="width: 14px; height: 14px;" /></a></sup>
+
+```python
+diagnose()
+```
+
+
+Diagnose the experimental plugin system.
+
+This command provides information about:
+- Whether the plugin system is enabled
+- What plugins are discoverable via entry points
+- Current configuration (timeouts, allow/deny lists)
+
+Note: This runs the plugin discovery but does not execute hooks.
+Use safe mode (PREFECT_EXPERIMENTS_PLUGINS_SAFE_MODE=1) to test plugin loading
+without executing hooks.
+

docs/v3/api-ref/python/prefect-settings-models-experiments.mdx

@@ -7,7 +7,43 @@ sidebarTitle: experiments
 
 ## Classes
 
-### `ExperimentsSettings` <sup><a href="https://github.com/PrefectHQ/prefect/blob/main/src/prefect/settings/models/experiments.py#L11" target="_blank"><Icon icon="github" style="width: 14px; height: 14px;" /></a></sup>
+### `PluginsSettings` <sup><a href="https://github.com/PrefectHQ/prefect/blob/main/src/prefect/settings/models/experiments.py#L13" target="_blank"><Icon icon="github" style="width: 14px; height: 14px;" /></a></sup>
+
+
+Settings for configuring the experimental plugin system
+
+
+**Methods:**
+
+#### `ser_model` <sup><a href="https://github.com/PrefectHQ/prefect/blob/main/src/prefect/settings/base.py#L168" target="_blank"><Icon icon="github" style="width: 14px; height: 14px;" /></a></sup>
+
+```python
+ser_model(self, handler: SerializerFunctionWrapHandler, info: SerializationInfo) -> Any
+```
+
+#### `settings_customise_sources` <sup><a href="https://github.com/PrefectHQ/prefect/blob/main/src/prefect/settings/base.py#L34" target="_blank"><Icon icon="github" style="width: 14px; height: 14px;" /></a></sup>
+
+```python
+settings_customise_sources(cls, settings_cls: type[BaseSettings], init_settings: PydanticBaseSettingsSource, env_settings: PydanticBaseSettingsSource, dotenv_settings: PydanticBaseSettingsSource, file_secret_settings: PydanticBaseSettingsSource) -> tuple[PydanticBaseSettingsSource, ...]
+```
+
+Define an order for Prefect settings sources.
+
+The order of the returned callables decides the priority of inputs; first item is the highest priority.
+
+See https://docs.pydantic.dev/latest/concepts/pydantic_settings/#customise-settings-sources
+
+
+#### `to_environment_variables` <sup><a href="https://github.com/PrefectHQ/prefect/blob/main/src/prefect/settings/base.py#L125" target="_blank"><Icon icon="github" style="width: 14px; height: 14px;" /></a></sup>
+
+```python
+to_environment_variables(self, exclude_unset: bool = False, include_secrets: bool = True, include_aliases: bool = False) -> dict[str, str]
+```
+
+Convert the settings object to a dictionary of environment variables.
+
+
+### `ExperimentsSettings` <sup><a href="https://github.com/PrefectHQ/prefect/blob/main/src/prefect/settings/models/experiments.py#L59" target="_blank"><Icon icon="github" style="width: 14px; height: 14px;" /></a></sup>
 
 
 Settings for configuring experimental features

docs/v3/api-ref/settings-ref.mdx

@@ -504,6 +504,13 @@ If `True`, warn on usage of experimental features.
 **Supported environment variables**:
 `PREFECT_EXPERIMENTS_WARN`, `PREFECT_EXPERIMENTAL_WARN`
 
+### `plugins`
+Settings for the experimental plugin system
+
+**Type**: [PluginsSettings](#pluginssettings)
+
+**TOML dotted key path**: `experiments.plugins`
+
 ---
 ## FlowsSettings
 Settings for controlling flow behavior
@@ -720,6 +727,81 @@ The maximum size in bytes for a single log.
 **Supported environment variables**:
 `PREFECT_LOGGING_TO_API_WHEN_MISSING_FLOW`
 
+---
+## PluginsSettings
+Settings for configuring the experimental plugin system
+### `enabled`
+Enable the experimental plugin system.
+
+**Type**: `boolean`
+
+**Default**: `False`
+
+**TOML dotted key path**: `experiments.plugins.enabled`
+
+**Supported environment variables**:
+`PREFECT_EXPERIMENTS_PLUGINS_ENABLED`
+
+### `allow`
+Comma-separated list of plugin names to allow. If set, only these plugins will be loaded.
+
+**Type**: `array | None`
+
+**Default**: `None`
+
+**TOML dotted key path**: `experiments.plugins.allow`
+
+**Supported environment variables**:
+`PREFECT_EXPERIMENTS_PLUGINS_ALLOW`
+
+### `deny`
+Comma-separated list of plugin names to deny. These plugins will not be loaded.
+
+**Type**: `array | None`
+
+**Default**: `None`
+
+**TOML dotted key path**: `experiments.plugins.deny`
+
+**Supported environment variables**:
+`PREFECT_EXPERIMENTS_PLUGINS_DENY`
+
+### `setup_timeout_seconds`
+Maximum time in seconds for all plugins to complete their setup hooks.
+
+**Type**: `number`
+
+**Default**: `20.0`
+
+**TOML dotted key path**: `experiments.plugins.setup_timeout_seconds`
+
+**Supported environment variables**:
+`PREFECT_EXPERIMENTS_PLUGINS_SETUP_TIMEOUT_SECONDS`
+
+### `strict`
+If True, exit if a required plugin fails during setup.
+
+**Type**: `boolean`
+
+**Default**: `False`
+
+**TOML dotted key path**: `experiments.plugins.strict`
+
+**Supported environment variables**:
+`PREFECT_EXPERIMENTS_PLUGINS_STRICT`
+
+### `safe_mode`
+If True, load plugins but do not execute their hooks. Useful for testing.
+
+**Type**: `boolean`
+
+**Default**: `False`
+
+**TOML dotted key path**: `experiments.plugins.safe_mode`
+
+**Supported environment variables**:
+`PREFECT_EXPERIMENTS_PLUGINS_SAFE_MODE`
+
 ---
 ## ResultsSettings
 Settings for controlling result storage behavior

schemas/settings.schema.json

@@ -364,6 +364,11 @@
                     ],
                     "title": "Warn",
                     "type": "boolean"
+                },
+                "plugins": {
+                    "$ref": "#/$defs/PluginsSettings",
+                    "description": "Settings for the experimental plugin system",
+                    "supported_environment_variables": []
                 }
             },
             "title": "ExperimentsSettings",
@@ -576,6 +581,89 @@
             "title": "LoggingToAPISettings",
             "type": "object"
         },
+        "PluginsSettings": {
+            "description": "Settings for configuring the experimental plugin system",
+            "properties": {
+                "enabled": {
+                    "default": false,
+                    "description": "Enable the experimental plugin system.",
+                    "supported_environment_variables": [
+                        "PREFECT_EXPERIMENTS_PLUGINS_ENABLED"
+                    ],
+                    "title": "Enabled",
+                    "type": "boolean"
+                },
+                "allow": {
+                    "anyOf": [
+                        {
+                            "items": {
+                                "type": "string"
+                            },
+                            "type": "array",
+                            "uniqueItems": true
+                        },
+                        {
+                            "type": "null"
+                        }
+                    ],
+                    "default": null,
+                    "description": "Comma-separated list of plugin names to allow. If set, only these plugins will be loaded.",
+                    "supported_environment_variables": [
+                        "PREFECT_EXPERIMENTS_PLUGINS_ALLOW"
+                    ],
+                    "title": "Allow"
+                },
+                "deny": {
+                    "anyOf": [
+                        {
+                            "items": {
+                                "type": "string"
+                            },
+                            "type": "array",
+                            "uniqueItems": true
+                        },
+                        {
+                            "type": "null"
+                        }
+                    ],
+                    "default": null,
+                    "description": "Comma-separated list of plugin names to deny. These plugins will not be loaded.",
+                    "supported_environment_variables": [
+                        "PREFECT_EXPERIMENTS_PLUGINS_DENY"
+                    ],
+                    "title": "Deny"
+                },
+                "setup_timeout_seconds": {
+                    "default": 20.0,
+                    "description": "Maximum time in seconds for all plugins to complete their setup hooks.",
+                    "supported_environment_variables": [
+                        "PREFECT_EXPERIMENTS_PLUGINS_SETUP_TIMEOUT_SECONDS"
+                    ],
+                    "title": "Setup Timeout Seconds",
+                    "type": "number"
+                },
+                "strict": {
+                    "default": false,
+                    "description": "If True, exit if a required plugin fails during setup.",
+                    "supported_environment_variables": [
+                        "PREFECT_EXPERIMENTS_PLUGINS_STRICT"
+                    ],
+                    "title": "Strict",
+                    "type": "boolean"
+                },
+                "safe_mode": {
+                    "default": false,
+                    "description": "If True, load plugins but do not execute their hooks. Useful for testing.",
+                    "supported_environment_variables": [
+                        "PREFECT_EXPERIMENTS_PLUGINS_SAFE_MODE"
+                    ],
+                    "title": "Safe Mode",
+                    "type": "boolean"
+                }
+            },
+            "title": "PluginsSettings",
+            "type": "object"
+        },
         "ResultsSettings": {
             "description": "Settings for controlling result storage behavior",
             "properties": {