عرض عملي: مساعد ذكي لكتابة أوصاف المنتجات في Shop API

خطوة بخطوة

1. Define ProductDescriptionAssistant and the Description record with validation annotations.
2. Add the Spring AI starter and set provider and model in configuration; the key comes from an environment variable.
3. Implement it with ChatClient, .entity(Description.class), a timeout, and a max-token limit.
4. Planned mistake: the first version asks for plain text and splits it by newline; the model adds extra lines and parsing breaks. Fix: request structured output and validate it.
5. Add POST /products/{id}/description-suggestion that returns the record, or a Problem Details error for invalid output.
6. Write controller and service tests with the fake; confirm they pass offline.