Skip to main content

Start from an outcome

These recipes are prompt shapes, not guaranteed results. Replace file, table, column, unit, and date names with values confirmed by /files and /schema.

Inspect before calculating

Outcome: confirm that the source Fella will query matches your assumptions.
Check inferred numeric types, date formats, nulls, units, capitalization, skipped files, preamble removal, and dropped total-row notes. Fix or clarify bad source assumptions before asking for a total.

Compare two periods

Outcome: get two totals and a reproducible delta.
Open How this was analyzed and inspect the date boundaries, category filter, refund handling, denominator, and units recorded for the run.

Rank categories

Outcome: find the largest contributors rather than list raw rows.
If you mean completed workouts only, say so and name the status value. Verification cannot infer a missing business rule.

Join two files

Outcome: combine records through an explicit key.
Inspect that both tables appear in the SQL, the join key is correct, and filters run before aggregation. If keys have different types or spelling, normalize the source or state the intended mapping.

Reconcile a document and a table

Outcome: use a stated target from text with observed values from rows.
Text claims appear as document evidence; calculations should still be grounded in tool output. A scanned PDF needs OCR before this recipe works.

Find and summarize document facts

Outcome: locate relevant passages without an embeddings index.
Fella uses direct regex search and document reads. Ask for file names or quoted passages when source traceability matters.

Create a compact chart

Outcome: visualize a small aggregated result.
Charts support bar, line, area, stacked area, pie/donut, scatter, histogram, box plot, heatmap, and forecast data. Long-form series can be plotted by selecting a time/category field, a group field, and a numeric value field; aggregate repeated x/group pairs explicitly. Line charts retain up to 1,000 points, with axis labels thinned for dense periods. The chart is derived from a read-only query result, so its labels and values are recorded with the same evidence as the calculation behind it.

Query directly

Outcome: bypass model interpretation when you know the table and SQLite query.
Direct SQL remains read-only and prints a system result; unlike an agent tool call, it does not create an assistant analysis record or run post-answer verification. The shipped backend is SQLite, so use SQLite syntax. A DuckDB-only function will not work in a normal release build.

Ask for a forecast responsibly

Outcome: estimate from the chosen history, and make the method and uncertainty visible.
Forecasts are valid analytical requests. When relevant history or assumptions are missing, Fella should explain the specific evidence gap, give any useful partial result, and ask for the missing input instead of inventing certainty or refusing solely because the question concerns the future.

Next steps

Troubleshoot a recipe

Diagnose source, provider, tool, and interpretation failures.

Inspect evidence

Review source selection, query logic, rows, and checks.