⚠️ IMPORTANT: All features are experimental, under active development. Use at your own risk. Customization to your workflow required. © 2026 GLG, a.s. | ← Back to Index
17. Troubleshooting
Common Issues
| Problem | Cause | Solution |
|---|---|---|
FeatureNotAvailable |
Feature not in current tier | Check tier with uaml.license_status(), suggest upgrade |
| Empty recall results | No memories stored yet | Store some knowledge first with uaml.learn() |
| Low relevance results | Default preset too strict | Switch to "research" preset or lower min_relevance_score |
| High token usage | Too broad queries | Use Focus Engine with explicit budget_tokens |
| Duplicate entries | No dedup configured | Enable dedup: uaml config set dedup true |
| PII blocked | PII detector active | Adjust PII policy per category, or use pii_policy: "mask" |
| MCP connection failed | Server not running | Start with uaml mcp start (port 8770) |
| Import failed | Wrong format | Use JSONL format from uaml export |
Health Check
uaml health
# Or via REST:
curl http://localhost:8780/api/health
Returns: database status, disk space, memory count, last sync time, service status.
Diagnostic Commands
uaml stats # Memory statistics
uaml config show # Current configuration
uaml license status # License tier and expiry