or run

npx @tessl/cli init
Log in

Version

Tile

Overview

Evals

Files

docs

agent.mdagentos.mdeval.mdexceptions.mdguardrails.mdindex.mdknowledge.mdmedia.mdmemory.mdmodels.mdsessions.mdstorage.mdteam.mdtools.mdworkflow.md
tile.json

guardrails.mddocs/

Guardrails API

Input validation, output filtering, and safety checks.

Capabilities

Base Guardrail

from agno.guardrails import BaseGuardrail

class BaseGuardrail:
    def check(
        self,
        input: Any,
        **kwargs
    ) -> Any:
        """
        Process and validate input/output.

        Parameters:
            input: Data to validate
            **kwargs: Additional parameters

        Returns:
            Any: Validated or transformed data

        Raises:
            InputCheckError: If input validation fails
            OutputCheckError: If output validation fails
        """

    async def async_check(
        self,
        input: Any,
        **kwargs
    ) -> Any:
        """
        Async version of check().

        Parameters:
            input: Data to validate
            **kwargs: Additional parameters

        Returns:
            Any: Validated or transformed data

        Raises:
            InputCheckError: If input validation fails
            OutputCheckError: If output validation fails
        """

OpenAI Moderation

from agno.guardrails import OpenAIModerationGuardrail

class OpenAIModerationGuardrail(BaseGuardrail):
    def __init__(
        self,
        api_key: Optional[str] = None,
        **kwargs
    ): ...

PII Detection

from agno.guardrails import PIIDetectionGuardrail

class PIIDetectionGuardrail(BaseGuardrail):
    def __init__(
        self,
        patterns: Optional[List[str]] = None,
        **kwargs
    ): ...

Prompt Injection

from agno.guardrails import PromptInjectionGuardrail

class PromptInjectionGuardrail(BaseGuardrail): ...

Usage Examples

Input Validation

from agno.agent import Agent
from agno.guardrails import OpenAIModerationGuardrail, PIIDetectionGuardrail

agent = Agent(
    model=...,
    pre_hooks=[
        OpenAIModerationGuardrail(),
        PIIDetectionGuardrail()
    ]
)

Output Validation

from agno.agent import Agent
from agno.guardrails import OpenAIModerationGuardrail

agent = Agent(
    model=...,
    post_hooks=[
        OpenAIModerationGuardrail()
    ]
)