*/
    public static ChatIntent fromValue(final String value) {
        if (value == null) {
            return UNCLEAR;
        }
        for (final ChatIntent intent : values()) {
            if (intent.value.equalsIgnoreCase(value.trim())) {
                return intent;
            }
        }
        return UNCLEAR;
    }

 * Contains the detected intent type, Fess query, and other metadata.
 */
public class IntentDetectionResult {

    private final ChatIntent intent;
    private final String query;
    private final String documentUrl;
    private final String reasoning;

    private IntentDetectionResult(final ChatIntent intent, final String query, final String documentUrl, final String reasoning) {
        this.intent = intent;
        this.query = query;

    }

    @Test
    public void test_fromValue_summary() {
        assertEquals(ChatIntent.SUMMARY, ChatIntent.fromValue("summary"));
        assertEquals(ChatIntent.SUMMARY, ChatIntent.fromValue("SUMMARY"));
        assertEquals(ChatIntent.SUMMARY, ChatIntent.fromValue("Summary"));
    }

    @Test
    public void test_fromValue_faq() {

            final String intentStr = extractJsonString(response, "intent");
            final ChatIntent intent = ChatIntent.fromValue(intentStr);
            final String query = extractJsonString(response, "query");
            final String reasoning = extractJsonString(response, "reasoning");

            if (intent == ChatIntent.SEARCH) {
                return IntentDetectionResult.search(query, reasoning);

        assertEquals(ChatIntent.SEARCH, result.getIntent());
        assertEquals("", result.getQuery());
    }

    @Test
    public void test_search_withNullQuery() {
        final IntentDetectionResult result = IntentDetectionResult.search(null, "test");

        assertEquals(ChatIntent.SEARCH, result.getIntent());
        assertNull(result.getQuery());
    }

import org.codelibs.fess.entity.HighlightInfo;
import org.codelibs.fess.entity.SearchRenderData;
import org.codelibs.fess.entity.SearchRequestParams;
import org.codelibs.fess.helper.MarkdownRenderer;
import org.codelibs.fess.llm.ChatIntent;
import org.codelibs.fess.llm.IntentDetectionResult;
import org.codelibs.fess.llm.LlmChatResponse;
import org.codelibs.fess.llm.LlmClient;
import org.codelibs.fess.llm.LlmClientManager;

        history.add(LlmMessage.assistant("Fess is an enterprise search server."));

        final IntentDetectionResult result = client.detectIntent("How about Docker?", history);

        assertEquals(ChatIntent.SEARCH, result.getIntent());
        assertEquals("Fess Docker", result.getQuery());

        // Verify the full request has structured messages: system + history + wrapped user