Skip to main content
Pro feature — requires BYOK (Bring Your Own Key) configuration.
Pass validation failures through your own OpenAI or Anthropic API for root cause analysis — including vendor-specific context like “this is a common Epic-to-downstream mapping issue.” BYOK means your data, your keys, your cost control.

​
Setup

Configure your AI provider key in Console settings or via environment variable: 
export PIDGEON_OPENAI_KEY="sk-..."
# or
export PIDGEON_ANTHROPIC_KEY="sk-ant-..."
Supported providers: OpenAI (GPT-4) and Anthropic (Claude).

​
Usage

pidgeon validate --file broken.hl7 --ai-triage

​
Example Output

AI Triage Analysis:

Root Cause: The PID.8 field contains "MALE" instead of the HL7 Table 0001
coded value "M". This is a common Epic-to-downstream mapping issue where
the sending system uses descriptive text instead of coded values.

Suggested Fix: Configure a Mirth transformer on Channel 12 to map
PID.8 values: "MALE" → "M", "FEMALE" → "F", "OTHER" → "O"

Confidence: 94%
Similar issues found: 23 messages in the last 24 hours

​
API

The AI Triage API is available at POST /api/loft/triage. See the API Reference for details.