spring-projects / spring-projects/spring-ai
Provider Exception Failure Analysis abstraction to provide better error messages to users
Nobody has claimed this yet.
- Dominant language
- Java
- Stars
- 9.5k
- Forks
- 2.9k
- Avg merge
- 1d 10h
- Merged PRs (30d)
- 5
Description
Since Spring AI integrates with numerous vector stores and models Exceptions are going to happen and users will struggle to figure out why the exception is occurring. Sprig Boot has the concept of Exception failure analyzer by introducing a failure analyzer abstraction into the spring-ai core we can enable model providers, vector store providers and advisor implementers the ability to offer more friendly error messages that will guide users towards a quick resolution of the issues and reduce the volume of Q&A issues raised.
Examples of users raising issues that can benefit from a failure analyzer.
- #1675
Contributor guide
First steps
- Read the whole issue, then the project's contributing guide.
- Comment on the issue to say you are picking it up — it saves two people doing the same work.
- Fork the repository and make your change on a branch.
- Open a pull request that references the issue number.
Research direction
Start by reading Spring Boot's AbstractFailureAnalyzer documentation linked in the issue and the Spring AI core entry points for model providers, vector stores, and advisors. Define the scope of the failure-analyzer abstraction and verify that providers and advisor implementers can supply user-oriented resolution guidance.
Written by the indexing model from the issue text.
Assessment
- Tech stack
- java, spring-boot
- Domain
- api, backend
- Issue type
- Feature
- Difficulty
- 5/5
- Estimated time
- Over a week
- Activity status
- Stale
- Clarity
- Needs clarification
- Newbie friendliness
- 30/100