How prkhar2209/spring-ai works
This repository is a Spring AI course collection: separate runnable examples demonstrate provider connections, prompt and chat patterns, retrieval, MCP, and support-agent workflows rather than one unified application. A typical request enters a sample controller and uses a configured chat client; the RAG example additionally configures a retriever, while help-desk examples expose ticket operations through tools and persistence. The tree documents further capabilities including streaming, structured output, memory, audio, images, and email handling. Connections between unsampled examples are omitted or marked unverified; the README describes course scope and referenced technologies, not application call flows.
Main entry points: HelpDeskTicketService.java Ticket service · SupportAgent.java Email support agent · StructuredOutPutController.java Structured output · WebSearchRAGChatClientConfig.java RAG chat setup
Components 29
Model providers
- Provider chat samples
section01 - Bedrock chat
section01/bedrock/src/main/java/com/eazybytes/bedrock/controller/ChatController.java - Docker model chat
section01/dockermodel/src/main/java/com/eazybytes/dockermodel/controller/ChatController.java - Ollama chat
section01/ollama/src/main/java/com/eazybytes/ollama/controller/ChatController.java - Multi-model chat
section01/multimodel/src/main/java/com/eazybytes/multimodel/controller/MultiModelChatController.java
Chat patterns
- Chat and prompt APIs
section02/springai/src/main/java/com/eazybytes/springai/controller - Structured output
section02/springai/src/main/java/com/eazybytes/springai/controller/StructuredOutPutController.java - Country response model
section02/springai/src/main/java/com/eazybytes/springai/model/CountryCities.java - Token usage audit
section02/springai/src/main/java/com/eazybytes/springai/advisors/TokenUsageAuditAdvisor.java - Memory chat
section04/springai/src/main/java/com/eazybytes/springai/controller/ChatMemoryController.java - Self-evaluating chat
section08/springai/src/main/java/com/eazybytes/springai/controller/SelfEvaluatingChatController.java - Audio interaction
section_10/springai/src/main/java/com/eazybytes/springai/controller/AudioController.java - Image interaction
section_10/springai/src/main/java/com/eazybytes/springai/controller/ImageController.java
Retrieval and RAG
- RAG endpoint
section05/springai/src/main/java/com/eazybytes/springai/controller/RAGController.java - RAG chat setup
section05/springai/src/main/java/com/eazybytes/springai/config/WebSearchRAGChatClientConfig.java - Web document retriever
section05/springai/src/main/java/com/eazybytes/springai/rag/WebSearchDocumentRetriever.java - Document loading
section05/springai/src/main/java/com/eazybytes/springai/rag
MCP integrations
- MCP client
section07/mcpclient/src/main/java/com/eazybytes/mcpclient/controller/MCPClientController.java - Remote MCP tools
section07/mcpserverremote/src/main/java/com/eazybytes/mcpserverremote/tool/HelpDeskTools.java - STDIO MCP tools
section07/mcpserverstdio/src/main/java/com/eazybytes/mcpserverstdio/tool/HelpDeskTools.java - MCP extensions
section07/mcp-elicitation
Support workflows
- Ticket service
section07/mcpserverremote/src/main/java/com/eazybytes/mcpserverremote/service/HelpDeskTicketService.java - Ticket repository
section07/mcpserverremote/src/main/java/com/eazybytes/mcpserverremote/repository/HelpDeskTicketRepository.java - Ticket record
section07/mcpserverremote/src/main/java/com/eazybytes/mcpserverremote/entity/HelpDeskTicket.java - Commerce support tools
section_11/support-agent-demo/mcp-server/src/main/java/com/eazybytes/mcp/server/tool - Email support agent
section_11/support-agent-demo/support-agent/src/main/java/com/eazybytes/support/agent/service/SupportAgent.java - Inbox monitor
section_11/support-agent-demo/support-agent/src/main/java/com/eazybytes/support/agent/service/InboxMonitor.java
Other components
- API user
- Mailpit service
Connections 13
- API user → Bedrock chat: submits chat
- API user → Docker model chat: submits chat
- API user → Ollama chat: submits chat
- API user → Multi-model chat: submits chat
- Structured output → Country response model: uses response
section02/springai/src/main/java/com/eazybytes/springai/controller/StructuredOutPutController.java - RAG chat setup → Web document retriever: configures retriever
section05/springai/src/main/java/com/eazybytes/springai/config/WebSearchRAGChatClientConfig.java - Ticket service → Ticket repository: saves and queries
section07/mcpserverremote/src/main/java/com/eazybytes/mcpserverremote/service/HelpDeskTicketService.java - Ticket service → Ticket record: builds tickets
section07/mcpserverremote/src/main/java/com/eazybytes/mcpserverremote/service/HelpDeskTicketService.java - Remote MCP tools → Ticket service: invokes service
- STDIO MCP tools → Ticket service: invokes service
- Email support agent → Commerce support tools: uses support tools
- Inbox monitor → Email support agent: dispatches email
- Email support agent → Mailpit service: accesses inbox