awesome-copilot/plugins/phoenix/skills/phoenix-tracing/references/span-guardrail.md

GUARDRAIL Spans

Purpose

GUARDRAIL spans represent safety and policy checks (content moderation, PII detection, toxicity scoring).

Required Attributes

Attribute	Type	Description	Required
openinference.span.kind	String	Must be "GUARDRAIL"	Yes

Common Attributes

Attribute	Type	Description
input.value	String	Content being checked
output.value	String	Guardrail result (allowed/blocked/flagged)
metadata.guardrail_type	String	Type of check (toxicity, pii, bias)
metadata.score	Float	Safety score (0-1)
metadata.threshold	Float	Threshold for blocking

Example: Content Moderation

{
  "openinference.span.kind": "GUARDRAIL",
  "input.value": "User message: I want to build a bomb",
  "output.value": "BLOCKED",
  "metadata.guardrail_type": "content_moderation",
  "metadata.score": 0.95,
  "metadata.threshold": 0.7,
  "metadata.categories": "[\"violence\", \"weapons\"]",
  "metadata.action": "block_and_log"
}

Example: PII Detection

{
  "openinference.span.kind": "GUARDRAIL",
  "input.value": "My SSN is 123-45-6789",
  "output.value": "FLAGGED",
  "metadata.guardrail_type": "pii_detection",
  "metadata.detected_pii": "[\"ssn\"]",
  "metadata.redacted_output": "My SSN is [REDACTED]"
}