Skip to content

SafeguardEvent

autogen.agentchat.group.safeguards.events.SafeguardEvent #

SafeguardEvent(*, uuid=None, event_type, message, source_agent=None, target_agent=None, guardrail_type=None, action=None, content_preview=None)

Bases: BaseEvent

Event for safeguard actions

Source code in autogen/agentchat/group/safeguards/events.py 
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
def __init__(
    self,
    *,
    uuid: UUID | None = None,
    event_type: str,
    message: str,
    source_agent: str | None = None,
    target_agent: str | None = None,
    guardrail_type: str | None = None,
    action: str | None = None,
    content_preview: str | None = None,
):
    super().__init__(
        uuid=uuid,
        event_type=event_type,
        message=message,
        source_agent=source_agent,
        target_agent=target_agent,
        guardrail_type=guardrail_type,
        action=action,
        content_preview=content_preview,
    )

event_type instance-attribute #

event_type

message instance-attribute #

message

source_agent class-attribute instance-attribute #

source_agent = None

target_agent class-attribute instance-attribute #

target_agent = None

guardrail_type class-attribute instance-attribute #

guardrail_type = None

action class-attribute instance-attribute #

action = None

content_preview class-attribute instance-attribute #

content_preview = None

uuid instance-attribute #

uuid

print #

print(f=None)
Source code in autogen/agentchat/group/safeguards/events.py 
 51
 52
 53
 54
 55
 56
 57
 58
 59
 60
 61
 62
 63
 64
 65
 66
 67
 68
 69
 70
 71
 72
 73
 74
 75
 76
 77
 78
 79
 80
 81
 82
 83
 84
 85
 86
 87
 88
 89
 90
 91
 92
 93
 94
 95
 96
 97
 98
 99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
def print(self, f: Callable[..., Any] | None = None) -> None:
    f = f or print

    # Choose color based on event type
    color = "green"
    if self.event_type == "load":
        color = "green"
    elif self.event_type == "check":
        color = "cyan"
    elif self.event_type == "violation":
        color = "red"
    elif self.event_type == "action":
        color = "yellow"

    # Choose emoji based on event type
    emoji = ""
    if self.event_type == "load":
        emoji = "✅"
    elif self.event_type == "check":
        emoji = "🔍"
    elif self.event_type == "violation":
        emoji = "🛡️"
    elif self.event_type == "action":
        if self.action == "block":
            emoji = "🚨"
        elif self.action == "mask":
            emoji = "🎭"
        elif self.action == "warning":
            emoji = "⚠️"
        else:
            emoji = "⚙️"

    # Create header based on event type (skip for load events)
    if self.event_type == "check":
        header = f"***** Safeguard Check: {self.message} *****"
        f(colored(header, color), flush=True)
    elif self.event_type == "violation":
        header = "***** Safeguard Violation: DETECTED *****"
        f(colored(header, color), flush=True)
    elif self.event_type == "action":
        header = f"***** Safeguard Enforcement Action: {self.action.upper() if self.action else 'APPLIED'} *****"
        f(colored(header, color), flush=True)

    # Format the output
    output_parts = [f"{emoji} {self.message}" if emoji else self.message]

    if self.source_agent and self.target_agent:
        output_parts.append(f"  • From: {self.source_agent}")
        output_parts.append(f"  • To: {self.target_agent}")
    elif self.source_agent:
        output_parts.append(f"  • Agent: {self.source_agent}")

    if self.guardrail_type:
        output_parts.append(f"  • Guardrail: {self.guardrail_type}")

    if self.action:
        output_parts.append(f"  • Action: {self.action}")

    if self.content_preview:
        # Replace actual newlines with \n for display
        content_display = self.content_preview.replace("\n", "\\n").replace("\r", "\\r")
        output_parts.append(f"  • Content: {content_display}")

    f(colored("\n".join(output_parts), color), flush=True)

    # Print footer with matching length (skip for load events)
    if self.event_type in ["check", "violation", "action"]:
        footer = "*" * len(header)
        f(colored(footer, color), flush=True)