Skip to content

Quarkus LangChain4j Workshop

Welcome to the Quarkus LangChain4j Workshop!
This workshop will guide you through building AI-infused applications and agentic systems using Quarkus and LangChain4j.

You will learn how to:

  • Integrate LLMs (Language Models) into your Quarkus application
  • Build a chatbot using Quarkus
  • Configure and send prompts to the LLM
  • Implement guardrails for safe interactions
  • Build simple and advanced RAG (Retrieval-Augmented Generation) patterns
  • Use remote tools via the Model Context Protocol (MCP)
  • Connect with remote agents using Agent-to-Agent (A2A) communication
  • Design agentic systems using workflow and supervisor patterns

Workshop Scenario

The workshop follows Miles of Smiles, a fictional car rental company, across three sections that together tell a complete customer journey.

The workshop is divided into three sections:

  • Section 1 – AI-infused application (11 steps): You’ll progressively build a customer-facing support chatbot, starting with basic LLM integration and adding features such as structured outputs, guardrails, RAG, MCP integration, and observability.

  • Section 2 – Agentic systems (7 steps + bonus): You’ll build a new multi-agent architecture, introducing agentic workflows, supervisor patterns, human-in-the-loop, multimodal agents, and Agent-to-Agent (A2A) communication, with a bonus step that covers deploying to Kubernetes/OpenShift.

  • Section 3 – Enterprise agentic AI patterns (9 steps): You’ll build an intelligent trip planning system using advanced orchestration patterns, including agent skills, guardrails, event-driven workflows with Quarkus Flow, persistent state, voting/loop patterns, custom orchestration, MCP, A2A, and LLM-based evaluation.

!!! warning “Section 3 is experimental” Section 3 is actively being developed and some steps are still being finalized. You are welcome to try it and share your feedback with us!

Each step builds on the previous one, with the results stored in separate directories (step-XX):

  • Final solution for Section 1: section-1/step-11
  • Final solution for Section 2: section-2/step-07
  • Final solution for Section 3: section-3/step-09 (in progress)

How to Work with Steps

Tip

We recommend starting with the main branch, then opening the project from step-01 in your IDE.
If you prefer, you can make a copy of the directory instead.

Note

To reset to a particular step, either overwrite your working directory with the content of that step,
or open the project directly from the desired step directory.

Quarkus LangChain4j Workshop Architecture

Let’s Get Started

First, check the requirements page to prepare your environment.

Once ready, you can pick one of these entries points to start the workshop: