Praison AI

enable • AI Agent SDK

enable: Enable the plugin system.

enable

Function

</div>

This function is defined in the plugins module.

Enable the plugin system.

Discovers and enables plugins from default directories. This is the main entry point for using plugins.

Signature

python
def enable(plugins: list, options_by_name: dict) -> None

Parameters

ParamField list

Optional list of plugin names to enable. If None, enables all discovered plugins.

ParamField dict

Optional `&#123;plugin_name: options_dict&#125; mapping of per-plugin options (e.g. from .praisonai/config.yaml). Each enabled plugin receives its own options via on_config`.

Usage

python
# Enable all discovered plugins
    from praisonaiagents import plugins
    plugins.enable()

    # Enable specific plugins only
    plugins.enable(["logging", "metrics"])

    # Enable with per-plugin options
    plugins.enable(["pii_guardrail"], {"pii_guardrail": {"redact": ["email"]}})

Uses

  • get_plugin_manager
  • manager.set_plugin_options
  • manager.auto_discover_plugins
  • manager.discover_entry_points
  • manager.set_registration_allow_list
  • manager.list_plugins
  • manager.enable
  • manager.disable
  • manager.wire_into_hook_registry
  • logging.debug

Notes

  • Tools and guardrails work WITHOUT calling enable()
  • Only background plugins (hooks, metrics, logging) need enable()
  • Can also be enabled via PRAISONAI_PLUGINS env var
  • Can also be enabled via .praisonai/config.yaml (unified) or config.toml

Used By

Source

View on GitHub

praisonaiagents/plugins/__init__.py at line 137