Crear un endpoint REST con Spring Boot e integrarlo con IA usando LangChain4j

Clase 3 de 23 • Curso de Java Spring Boot

Resumen

Domina cómo crear un endpoint REST en Java con Spring Boot y potenciarlo rápidamente con inteligencia artificial utilizando LangChain4j. Aquí exploramos paso a paso cómo lograr que tu aplicación responda a peticiones y, además, integre respuestas impulsadas por IA usando OpenAI, todo dentro de un entorno organizado y moderno como IntelliJ IDEA.

¿Cómo crear un endpoint REST en Java con Spring Boot?

Primero, asegúrate de tener tu proyecto cargado y corriendo en IntelliJ IDEA; si puedes ver una respuesta desde el navegador, vas por buen camino.

Debes crear una nueva clase llamada HelloController dentro del paquete com.platzi.play.
Anota la clase con @RestController, lo que le indica a Spring Boot que aceptará y gestionará peticiones HTTP.
Agrega un método que retorne, por ejemplo, Hello world. Usa la anotación @GetMapping para especificar que este método responderá a peticiones GET.
Si accedes desde el navegador al endpoint raíz, obtendrás la respuesta definida, por ejemplo: “Hola mundo, Hello world”.

Así queda tu primer endpoint operativo en un proyecto Java con Spring Boot.

¿Cómo integrar inteligencia artificial a un proyecto Spring Boot con LangChain4j?

El siguiente paso es sumar inteligencia artificial a tu proyecto. Para esto, sigue estos puntos:

Usa la librería LangChain4j, especialmente diseñada para conectar APIs de inteligencia artificial con tus servicios Java.
Busca la documentación oficial de LangChain4j y agrega sus dependencias en el archivo build.gradle. Incluye las dependencias para OpenAI y Spring Boot usando la versión 1.0.0-beta1, que permite el uso de una demo API key gratuita.
Refresca el proyecto Gradle para descargar e instalar las dependencias.
En el archivo application.properties dentro de la carpeta Resources, configura los parámetros necesarios para LangChain4j:
langchain4j.openai.chatmodel.apikey=demo
langchain4j.openai.chatmodel.model-name=gpt-4omini

Esto habilita a tu aplicación para procesar solicitudes de IA fácilmente.

¿Cómo crear y consumir un servicio de inteligencia artificial personalizado en Spring Boot?

Crea una nueva interface llamada PlatziPlayAIService.
Anótala con @AIServices para indicar que será usada como servicio de IA.
En la interface, añade un método llamado generateGreeting anotado con @UserMessage. Usa triple comilla para definir el prompt: pide un saludo de bienvenida, con menos de 120 caracteres y el estilo de Platzi.
Llegó el momento de integrar este servicio al HelloController. Decláralo como final, agréga una instancia en el constructor para permitir la inyección por Spring.
Modifica el endpoint para que retorne la respuesta de generateGreeting() en vez de Hello world.
Relanza la aplicación, accede al endpoint y visualiza un saludo personalizado generado por OpenAI; cada petición puede recibir un mensaje diferente.

¿Te imaginas otros casos de uso para esta integración? ¿Qué otras funciones de IA podrías probar con LangChain4j? Comparte tus ideas en los comentarios y sigue explorando el potencial de estas herramientas.

Paul Cortes

student•

Si no quieren descargar el archivo de application.properties entonces aqui les dejo el texto que deben pegar en ese archivo:

langchain4j.open-ai.chat-model.api-key=demo
langchain4j.open-ai.chat-model.model-name=gpt-4o-mini

Y tambien por si acaso el del build.gradle :

// LangChain4j
	implementation 'dev.langchain4j:langchain4j-open-ai-spring-boot-starter:1.0.0-beta1'
	implementation 'dev.langchain4j:langchain4j-spring-boot-starter:1.0.0-beta1'

Alejandro Ramírez

teacher•

Gracias Paul!

Husiel Ruiz

student•

En mi caso trabajo con maven y gemini, para lo que requieran les dejo las dependencias:

<dependency>    
<groupId>dev.langchain4j</groupId>    <artifactId>langchain4j-google-ai-gemini-spring-boot-starter</artifactId>    
<version>1.3.0-beta9</version>
</dependency>
<dependency>    
<groupId>dev.langchain4j</groupId>    <artifactId>langchain4j-spring-boot-starter</artifactId>    
<version>1.3.0-beta9</version>
</dependency>

Tambien necesitan las propiedades

langchain4j.google-ai-gemini.chat-model.api-key=<<Aqui colocar la Apikey generada por gemini>>
langchain4j.google-ai-gemini.chat-model.model-name=gemini-2.5-flash #Esta version es la gratuita

Aqui pueden generar la api key: https://aistudio.google.com/apikey

Saludos,

Alejandro Ramírez

teacher•

Genial! La ventaja de LangChain4j es esa, que puedes usar cualquier LLM.

cristian mosquera trullo

student•

muchas gracias

Eliezer Romero

company_admin•

yo tuve que agregar una configuración

package com.platzi.play; import dev.langchain4j.service.AiServices;import dev.langchain4j.model.openai.OpenAiChatModel;import org.springframework.context.annotation.Bean;import org.springframework.context.annotation.Configuration; @Configurationpublic class AiServiceConfig { @Bean public PlatziPlayAiService platziPlayAiService() { // OpenAiChatModel model = OpenAiChatModel.builder() // .apiKey(System.getenv("OPENAI_API_KEY")) // .build(); OpenAiChatModel model = OpenAiChatModel.builder() .baseUrl("http://langchain4j.dev/demo/openai/v1") .apiKey("demo") .modelName("gpt-4o-mini") .build(); return AiServices.create(PlatziPlayAiService.class, model); } }

con lo del property no funcionó del todo

Jesús Patricio Pereira Matus

student•

eh estado viendo y probando el tema de @Restcontroller y @GetMapping y bueno pude definir lo siguiente restcontroller es para que el codigo o la clase en java se comporte en rest a que me refiero con esto, poder hacer que devuelva cosas en base a una peticion o endpoint, getmapping defines el endpoint entre parentesis la / define el root o punto de inicio de la api y lo que este debajo de esta anotacion sera lo que se ejecutara al entrar a ese endpoint, corriganme si estoy mal o si estoy bien acepto recomendaciones son mis primeros 20 o 30 min viendo spring :cc

Alejandro Ramírez

teacher•

Tu explicación es correcta Jesús: @RestController le indica a Spring que esa clase va a exponer endpoints REST (las respuestas se devuelven directamente en formato JSON o similar). Y @GetMapping("/...") define la ruta que va a responder a una petición GET en ese endpoint.

La recomendación es que poco a poco explores otras anotaciones como @PostMapping, @PutMapping o @DeleteMapping, que siguen la misma idea pero para otros verbos HTTP. Vas excelente para llevar solo unos minutos con Spring! 🚀

Cristian Damaso Calderon Rojas

student•

Maven:

<dependency>
			<groupId>dev.langchain4j</groupId>
			<artifactId>langchain4j-open-ai-spring-boot-starter</artifactId>
			<version>1.0.0-beta1</version>
		</dependency>
		<dependency>
			<groupId>dev.langchain4j</groupId>
			<artifactId>langchain4j-spring-boot-starter</artifactId>
			<version>1.0.0-beta1</version>
		</dependency>

application.properties:

# Configuración simple para desarrollo - no requiere API keys
langchain4j.open-ai.chat-model.api-key=demo
langchain4j.open-ai.chat-model.model-name=gpt-4o-mini

DAVID ENRIQUE SÁNCHEZ SIERRA

student•

Muchas gracias!

Will Carlo

student•

Por un momento creí que era para ayudar al autocompletado del código, increible que ahora podeamos generar cosas como los LoremIpsums con IA directamente desde el código súper fácil.

juan.restrepoa

student•

Para los que mencionan que no les funciona la parte del iaService, me funcionó de esta manera:

Dentro del mismo paquete me tocó crear una clase que le puse LangChainConfig

package com.platzi.play;
import dev.langchain4j.model.chat.ChatLanguageModel;import dev.langchain4j.model.openai.OpenAiChatModel;import org.springframework.context.annotation.Bean;import org.springframework.context.annotation.Configuration;@Configurationpublic class LangChainConfig {    @Bean    public ChatLanguageModel chatLanguageModel() {        return OpenAiChatModel.builder()                .apiKey("demo")                .modelName("gpt-4o-mini")                .baseUrl("http://langchain4j.dev/demo/openai/v1")                .build();    }}

En el application.properties me quedó asi:

langchain4j.open-ai.chat-model.api-key=demolangchain4j.open-ai.chat-model.model-name=gpt-4o-minilangchain4j.open-ai.chat-model.base-url=http://langchain4j.dev/demo/openai/v1langchain4j.open-ai.chat-model.enabled=true

En el build.gradle:

implementation 'dev.langchain4j:langchain4j-open-ai:0.35.0'implementation 'dev.langchain4j:langchain4j:0.35.0'implementation 'dev.langchain4j:langchain4j-spring-boot-starter:0.35.0'

Ana Maria Gómez

student•

Hola! Me salta un dev.langchain4j.exception.HttpException: 401 Unauthorized. He creado una key desde gpt y la he agregado en .properties con langchain4j.openai.api-key pero aún no funciona. Alguien sabe como puedo solucionarlo?

Juan David Grijalba

student•

Me paso lo mismo, lograste solucionarlo?, no quiero quedarme estancado.

Juan Gabriel Ballesteros Villacrés

student•

Para usar el api-key: demo

debes agregar tambien la siguiente propiedad en al archivo aplication.properties:

langchain4j.open-ai.chat-model.base-url=http://langchain4j.dev/demo/openai/v1

Al menos deberías tener las tres propiedades siguientes:

langchain4j.open-ai.chat-model.api-key=demo

langchain4j.open-ai.chat-model.model-name=gpt-4o-mini

langchain4j.open-ai.chat-model.base-url=http://langchain4j.dev/demo/openai/v1

Gerson Augusto Rosales Jauregui

student••

Aqui esta el promt

"Genera un saludo de bienvenida a la plataforma de gestión de películas PlatziPlay. Usa menos de 120 caracteres y hazlo con un estilo amigable."

Ingenieria Resuelve

student•

Hola buen dia, mi duda es que funcion esta teniendo esta variable

String generateGreeting();

Kristhian Lizcano

student•

Dependiendo de las preferencias del usuario mostrarle sus peliculas favoritas

Angie Leticia Gil Lopez

student•

Esta Clase me encanto!

Alejandro Ramírez

teacher•

Angie, te imaginas un curso completo de LangChain4j? 👀

Cesar Eduardo Valle Pino

student•

Para quienes utilicen Maven, hay que copiar las siguientes líneas en las dependencias del archivo pom.xml

Con la versión 1.0.0-beta1, funciona tal como lo muestra Alejandro en la clase, y no olviden presionar el botón para que se actualicen las dependencias del proyecto.

ALEXANDER CARDONA ALZATE

student•

Excelente curso, muy chevere la funcionalidad de IA

Julian Ruiz

student•

Me sigue saliendo el mismo error al incluir la anotación, siento que esas dependencias no se reconocen.

Julian Ruiz

student•

Como hago para que me salgan las ayudas en el properties.

Carlos Benitez

student•

estaria bien poder seleccionar la calidad del video en el reproductor

Víctor Manuel

student•

¿Por que el controller no implementa la interfaz?

¿No deberia implementarla para poder acceder al metodo generateGreeting?

FERNANDO OROZCO

student•

El controllador se va a encargar de manejar los metodos REST (GET, POST, PUT, DELETE,...). En este caso SpringBoot se encarga de injectar (algo que aun no enseña y que explico por encima) un objeto del tipo de la interfaz, ese objeto si tiene acceso a ese metodo.

ANDRES ALFONSO MIRA MEJIA

student•

✅

Juan Lagos

student••

Estas dependencias que se dejaron son beta después de indagar y probar estas son las dependencias idóneas

implementation 'dev.langchain4j:langchain4j-spring-boot-starter:0.36.2' implementation 'dev.langchain4j:langchain4j-open-ai-spring-boot-starter:0.36.2'

Son gratuitas Oscar hasta donde he realizado pruebas no he tenido limitación

Oscar Andrés Barrera Arévalo

student•

y estas serian gratiutas ? o tambien son de paga