Skip to main content
Common issues and solutions when using QWED Open Responses.

Installation issues

”No module named ‘qwed_open_responses’”

Cause: Package not installed Solution:
For specific integrations:

“ImportError: langchain not found”

Cause: Missing optional dependency Solution:

Guard failures

”SchemaGuard: Missing required field”

Cause: Output doesn’t match expected schema Debug:
Common fixes:
  • Check field names (case-sensitive)
  • Ensure all required fields are present
  • Verify types match schema

”ToolGuard: Tool in blocklist”

Cause: Agent tried to call a blocked tool Debug:
Options:
  1. Remove tool from blocklist if safe
  2. Use whitelist instead
  3. Create exception for specific cases

”MathGuard: Calculation mismatch”

Cause: LLM provided wrong calculation Debug:
This is working as intended! The guard caught an LLM hallucination. Options:
  1. Return error to user
  2. Retry with corrected prompt
  3. Use QWED’s math engine directly

”SafetyGuard: PII detected”

Cause: Response contains personally identifiable information Patterns detected:
  • SSN: \d{3}-\d{2}-\d{4}
  • Credit Card: \d{16}
  • Email: Standard email pattern
  • Phone: Various formats
Options:
  1. Block (default): Return error
  2. Redact: Replace with [REDACTED]
  3. Custom patterns: Add your own

”StateGuard: Invalid transition”

Cause: Trying to move to invalid state Debug:
Fix: Review your state machine definition.

Integration issues

LangChain callback not triggering

Check callback is added:
Check tool is being called:

OpenAI wrapper not verifying

Check you’re using VerifiedOpenAI:
Check tool_choice is set:

Guards not being applied

Check guard order:
Check guard is configured:

Performance issues

Verification is slow

Reduce guards:
Cache schemas:

Too many false positives

Tune PII patterns:
Adjust tolerance:

Common errors reference


Getting help

  1. GitHub Issues: github.com/QWED-AI/qwed-open-responses/issues
  2. Documentation: docs.qwedai.com/open-responses
  3. Examples: GitHub Examples