spring-projects / spring-projects/spring-ai

Support for reasoning field in Chat Completion and maintenance roadmap for 1.1.x branch

Open
#5,523 4 comments 3 reactions 0 assignees View on GitHub

Nobody has claimed this yet.

status: waiting-for-triage
Dominant language
Java
Stars
9.5k
Forks
2.9k
Avg merge
1d 10h
Merged PRs (30d)
5

Description

Description

Currently, Spring AI (tested on version 1.1.2) appears to support the reasoning_content field (widely used by DeepSeek), but it does not seem to capture or map the reasoning field, which is frequently used by other providers or inference engines like vLLM (especially for Qwen 3.5 and other reasoning-capable models).

When using models that return the thought process under the reasoning key in the API response, this information is currently lost or inaccessible through the standard AssistantMessage or ChatResponse objects.

I am currently restricted to using Spring AI 1.1.x because my project is based on Spring Boot 3.5.x.

Questions
  1. Feature Support: Are there plans to add support for the reasoning field to achieve parity with reasoning_content?
  2. Backporting: Will this addition be available in the 1.1.x branch, or is it exclusive to the 2.x development line?
  3. 1.1.x Maintenance Lifecycle: What is the maintenance plan for the 1.1.x branch? Since it aligns with Spring Boot 3.x, will it continue to receive feature updates for new AI standards (like reasoning support), or is it moving into a maintenance-only mode?
Context

With the rapid evolution of reasoning models, having a unified way to access the thought process (regardless of whether the key is reasoning or reasoning_content) is crucial for building transparent AI applications.

Thank you for your guidance and support!

Contributor guide

Open the contributing guide

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. Open a pull request that references the issue number.

Research direction

Start by reviewing the Chat Completion response mapping and the AssistantMessage or ChatResponse objects mentioned in the issue, then compare how reasoning_content is currently handled. Confirm the expected behavior for a reasoning field and whether the change belongs in the 1.1.x branch; done means the reasoning value is accessible consistently and the branch policy is documented.

Written by the indexing model from the issue text.

Assessment

Tech stack
java, spring
Domain
ai, backend-api-design
Issue type
Feature
Difficulty
4/5
Estimated time
3-5 days
Activity status
Quiet
Clarity
Needs clarification
Newbie friendliness
38/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.