Lessons
- 1Calling a modelMessages, temperature, tokens, cost, and structured output instead of free text.
- 2Context engineeringWhat goes in the window and what comes out, and why longer is not better.
- 3Evaluation firstFifty golden questions before any change, then a model as judge.
- 4Vector searchWhat similarity brings together, where it misleads, and indexing in pgvector.
- 5ChunkingBy paragraph, by heading, or overlapping, and what each does to retrieval.
- 6Hybrid searchBM25 with vectors and a reranker, the right default in most cases.
- 7Arabic retrievalNormalisation, diacritics, hamza forms and Arabic-Indic digits.
- 8Retrieval metricsRecall, precision and MRR, then faithfulness to the source.
- 9The system's limitsWhen the system declines, and scope as a query predicate not a prompt wish.
- 10Project: an Arabic document assistantIt answers with a citation, and carries a number before and after every change.