Guardrail result

Guardrail result data models.

This module contains Pydantic models for guardrail operation results.

Authors

Kevin Yauris (kevin.yauris@gdplabs.id) Moch. Nauval Rizaldi Nasril (moch.n.r.nasril@gdplabs.id)

References

None

GuardrailResult

Bases: BaseModel

Result of a guardrail content safety check.

This model represents the standardized return value for all guardrail operations, providing type safety and validation for safety check results.

Attributes:

Name	Type	Description
is_safe	bool	Whether the content passed the safety check
reason	str | None	Human-readable reason for rejection (if not safe) or None
filtered_content	str | None	Cleaned/filtered version of content (if available) or None

from_dict(data) classmethod

Create from dictionary format for backward compatibility.

Parameters:

Name	Type	Description	Default
data	dict[str, Any]	Dictionary with is_safe, reason, and filtered_content keys	required

Returns:

Type	Description
GuardrailResult	GuardrailResult instance

safe(filtered_content=None) classmethod

Create a safe result.

Parameters:

Name	Type	Description	Default
filtered_content	str | None	Optional filtered content	None

Returns:

Type	Description
GuardrailResult	GuardrailResult indicating safe content

to_dict()

Convert to dictionary format for backward compatibility.

Returns:

Type	Description
dict[str, Any]	Dictionary representation of the result

unsafe(reason, filtered_content=None) classmethod

Create an unsafe result.

Parameters:

Name	Type	Description	Default
reason	str	Reason for rejection	required
filtered_content	str | None	Optional filtered content	None

Returns:

Type	Description
GuardrailResult	GuardrailResult indicating unsafe content