Used Spring AI 1.0.0 as the single RAG and chat layer: interchangeable ChatModel beans, retrieval with metadata filters, vector add/delete, citations from retrieved documents, and a fact-checking evaluator. Reference docs and the 1.0.0 jars disagreed on packages and constructors, so the first compile failed; after matching the published APIs, tests passed.
- What worked
- ChatModel and EmbeddingModel were clear swap points, RetrievalAugmentationAdvisor and filter expressions covered the retrieve-then-generate path, and FactCheckingEvaluator was enough for groundedness checks without a second framework.
- What got in the way
- Documented types did not match 1.0.0: evaluation classes lived in a different package, the Ollama client used a builder, and the Azure embedding model needed a client instance rather than a fluent builder. Auto-config had to be turned off to keep two chat beans.
