> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://docs.nvidia.com/nemo/guardrails/llms.txt.
> For full documentation content, see https://docs.nvidia.com/nemo/guardrails/llms-full.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.nvidia.com/nemo/guardrails/_mcp/server.

# nemoguardrails.library.guardrails_ai.actions

Dynamic validator loading for Guardrails AI integration.

## Module Contents

### Classes

| Name                                                           | Description |
| -------------------------------------------------------------- | ----------- |
| [`Guard`](#nemoguardrails-library-guardrails_ai-actions-Guard) | -           |

### Functions

| Name                                                                                                                 | Description                                                    |
| -------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------- |
| [`_get_guard`](#nemoguardrails-library-guardrails_ai-actions-_get_guard)                                             | Get or create a Guard instance for a validator.                |
| [`_load_validator_class`](#nemoguardrails-library-guardrails_ai-actions-_load_validator_class)                       | Dynamically load a validator class.                            |
| [`guardrails_ai_validation_mapping`](#nemoguardrails-library-guardrails_ai-actions-guardrails_ai_validation_mapping) | Map Guardrails AI validation result to NeMo Guardrails format. |
| [`validate_guardrails_ai`](#nemoguardrails-library-guardrails_ai-actions-validate_guardrails_ai)                     | Unified action for all Guardrails AI validators.               |
| [`validate_guardrails_ai_input`](#nemoguardrails-library-guardrails_ai-actions-validate_guardrails_ai_input)         | Unified action for all Guardrails AI validators.               |
| [`validate_guardrails_ai_output`](#nemoguardrails-library-guardrails_ai-actions-validate_guardrails_ai_output)       | Unified action for all Guardrails AI validators.               |

### Data

[`_guard_cache`](#nemoguardrails-library-guardrails_ai-actions-_guard_cache)

[`_validator_class_cache`](#nemoguardrails-library-guardrails_ai-actions-_validator_class_cache)

[`log`](#nemoguardrails-library-guardrails_ai-actions-log)

### API

```python
class nemoguardrails.library.guardrails_ai.actions.Guard()
```

```python
nemoguardrails.library.guardrails_ai.actions.Guard.use(
    validator
)
```

```python
nemoguardrails.library.guardrails_ai.actions.Guard.validate(
    text,
    metadata = None
)
```

```python
nemoguardrails.library.guardrails_ai.actions._get_guard(
    validator_name: str,
    validator_params = {}
) -> nemoguardrails.library.guardrails_ai.actions.Guard
```

Get or create a Guard instance for a validator.

```python
nemoguardrails.library.guardrails_ai.actions._load_validator_class(
    validator_name: str
) -> typing.Type
```

Dynamically load a validator class.

```python
nemoguardrails.library.guardrails_ai.actions.guardrails_ai_validation_mapping(
    result: typing.Dict[str, typing.Any]
) -> bool
```

Map Guardrails AI validation result to NeMo Guardrails format.

```python
nemoguardrails.library.guardrails_ai.actions.validate_guardrails_ai(
    validator_name: str,
    text: str,
    kwargs = {}
) -> typing.Dict[str, typing.Any]
```

Unified action for all Guardrails AI validators.

**Parameters:**

Name of the validator to use (from VALIDATOR\_REGISTRY)

Text to validate

**Returns:** `Dict[str, Any]`

Dict with validation\_result

```python
nemoguardrails.library.guardrails_ai.actions.validate_guardrails_ai_input(
    validator: str,
    config: nemoguardrails.rails.llm.config.RailsConfig,
    context: typing.Optional[dict] = None,
    text: typing.Optional[str] = None,
    kwargs = {}
) -> typing.Dict[str, typing.Any]
```

Unified action for all Guardrails AI validators.

**Parameters:**

Name of the validator to use (from VALIDATOR\_REGISTRY)

Text to validate

Optional context dictionary

**Returns:** `Dict[str, Any]`

Dict with validation\_result and valid (bool derived from validation\_passed).

```python
nemoguardrails.library.guardrails_ai.actions.validate_guardrails_ai_output(
    validator: str,
    context: typing.Optional[dict] = None,
    text: typing.Optional[str] = None,
    config: typing.Optional[nemoguardrails.rails.llm.config.RailsConfig] = None,
    kwargs = {}
) -> typing.Dict[str, typing.Any]
```

Unified action for all Guardrails AI validators.

**Parameters:**

Name of the validator to use (from VALIDATOR\_REGISTRY)

Text to validate

Optional context dictionary

**Returns:** `Dict[str, Any]`

Dict with validation\_result and valid (bool derived from validation\_passed).

```python
nemoguardrails.library.guardrails_ai.actions._guard_cache: Dict[tuple, Guard] = {}
```

```python
nemoguardrails.library.guardrails_ai.actions._validator_class_cache: Dict[str, Type] = {}
```

```python
nemoguardrails.library.guardrails_ai.actions.log = logging.getLogger(__name__)
```