Troubleshooting AI Search in FileFortress

Resolve provider, model, and interpretation issues with fast diagnostics

Quick Triage Rule

Separate setup problems (provider/model/endpoint) from prompt problems (query intent and filter extraction). Most fixes become obvious once you know which category you are in.

Symptom Matrix

Symptom Likely Cause First Fix
Provider returned 400 Model mismatch or endpoint incompatibility Verify exact model ID from /v1/models
No filters extracted Prompt is not search-filter intent Rephrase with media/size/date/remote terms
Unexpected filter interpretation Prompt ambiguity Run with --dry-run --explain

Fixing Provider 400 Errors

In Foundry setups, generic model names may fail even when the endpoint is healthy. Use the exact model ID that the endpoint reports.

# 1) Inspect active AI config
filefortress config list

# 2) Validate endpoint is running
foundry service status

# 3) Set exact model ID discovered from endpoint
filefortress tools configure foundry --model "phi-4-openvino-gpu:1"

# 4) Validate translation before search
filefortress ai "find images" --dry-run --explain
Planned Improvement

Model ID validation during tools configure foundry --model is planned to reduce runtime 400 surprises.

Handling \"No Filters Extracted\"

This message usually means the model did respond, but your prompt did not map to search fields.

Examples

Does Not Map

\"How many remotes do I have?\"

Maps Well

\"find images smaller than 5kb\"

For non-search questions, use command-specific alternatives:

  • filefortress remotes list for remote inventory/count
  • filefortress tools configure foundry for model/endpoint setup
  • filefortress config list for current local configuration state

Debug Workflow You Can Reuse

  1. Run the same prompt with --dry-run.
  2. Add --explain to inspect interpretation quality.
  3. If provider errors appear, verify endpoint + exact model ID.
  4. If interpretation is weak, rewrite prompt with explicit filter words.
  5. If needed, convert query to explicit search options.

Escalate to Explicit Search

When you need deterministic, scriptable behavior, use direct filters:

# Instead of:
filefortress ai "find images smaller than 5kb"

# Use deterministic command:
filefortress search --media-type image --size-max 5KB

Related Resources