You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@groovy.apache.org by gi...@apache.org on 2025/11/14 10:39:34 UTC
(groovy-dev-site) branch asf-site updated: 2025/11/14 10:39:31: Generated dev website from groovy-website@27c6c2d
This is an automated email from the ASF dual-hosted git repository.
git-site-role pushed a commit to branch asf-site
in repository https://gitbox.apache.org/repos/asf/groovy-dev-site.git
The following commit(s) were added to refs/heads/asf-site by this push:
new 1f40ae3 2025/11/14 10:39:31: Generated dev website from groovy-website@27c6c2d
1f40ae3 is described below
commit 1f40ae382e35ecbcdbe61386e4ae73b43f29fbde
Author: jenkins <bu...@apache.org>
AuthorDate: Fri Nov 14 10:39:31 2025 +0000
2025/11/14 10:39:31: Generated dev website from groovy-website@27c6c2d
---
blog/feed.atom | 6 +-
blog/groovy-ai.html | 587 +++++++++++++++++++++++++++++++++++++++++++++++-----
blog/index.html | 4 +-
3 files changed, 541 insertions(+), 56 deletions(-)
diff --git a/blog/feed.atom b/blog/feed.atom
index 8cf03ce..a7f025f 100644
--- a/blog/feed.atom
+++ b/blog/feed.atom
@@ -4,7 +4,7 @@
<link href="http://groovy.apache.org/blog"/>
<link href="http://groovy.apache.org/blog/feed.atom" rel="self"/>
<id>http://groovy.apache.org/blog</id>
- <updated>2025-11-07T23:00:00Z</updated>
+ <updated>2025-11-14T20:05:00Z</updated>
<entry>
<id>http://groovy.apache.org/blog/embabel-agentic-patterns</id>
<author>
@@ -23,9 +23,9 @@
</author>
<title type="html">Exploring AI with Groovy&trade;</title>
<link href="http://groovy.apache.org/blog/groovy-ai"/>
- <updated>2025-10-15T07:06:20Z</updated>
+ <updated>2025-11-14T20:05:00Z</updated>
<published>2025-10-15T07:06:20Z</published>
- <summary type="html">A tour of using Groovy with modern AI libraries including ollama4j, LangChain4j, Spring AI, and Embabel.</summary>
+ <summary type="html">A tour of using Groovy with modern AI libraries including Ollama4j, LangChain4j, Spring AI, Embabel, Micronaut, and Quarkus.</summary>
</entry>
<entry>
<id>http://groovy.apache.org/blog/exploring-gatherers4j</id>
diff --git a/blog/groovy-ai.html b/blog/groovy-ai.html
index 84e48c8..ce8f261 100644
--- a/blog/groovy-ai.html
+++ b/blog/groovy-ai.html
@@ -3,7 +3,7 @@
<!--[if IE 7]> <html class="no-js lt-ie9 lt-ie8"> <![endif]-->
<!--[if IE 8]> <html class="no-js lt-ie9"> <![endif]-->
<!--[if gt IE 8]><!--> <html class="no-js"> <!--<![endif]--><head>
- <meta charset='utf-8'/><meta http-equiv='X-UA-Compatible' content='IE=edge'/><meta name='viewport' content='width=device-width, initial-scale=1'/><meta name='keywords' content='groovy, ai, ollama4j, langchain4j, spring-ai, embabel'/><meta name='description' content='A tour of using Groovy with modern AI libraries including ollama4j, LangChain4j, Spring AI, and Embabel.'/><title>The Apache Groovy programming language - Blogs - Exploring AI with Groovy™</title><link href='../img/ [...]
+ <meta charset='utf-8'/><meta http-equiv='X-UA-Compatible' content='IE=edge'/><meta name='viewport' content='width=device-width, initial-scale=1'/><meta name='keywords' content='groovy, ai, ollama4j, langchain4j, spring-ai, embabel, micronaut-ai, quarkus-ai'/><meta name='description' content='A tour of using Groovy with modern AI libraries including Ollama4j, LangChain4j, Spring AI, Embabel, Micronaut, and Quarkus.'/><title>The Apache Groovy programming language - Blogs - Exploring AI [...]
</head><body>
<div id='fork-me'>
<a href='https://github.com/apache/groovy'>
@@ -59,19 +59,19 @@
</ul>
</div>
</div>
- </div><div id='content' class='page-1'><div class='row'><div class='row-fluid'><div class='col-lg-3'><ul class='nav-sidebar'><li><a href='./'>Blog index</a></li><li class='active'><a href='#doc'>Exploring AI with Groovy™</a></li><li><a href='#_introduction' class='anchor-link'>Introduction</a></li><li><a href='#_using_ollama4j' class='anchor-link'>Using Ollama4j</a></li><li><a href='#_using_langchain4j' class='anchor-link'>Using LangChain4j</a></li><li><a hr [...]
+ </div><div id='content' class='page-1'><div class='row'><div class='row-fluid'><div class='col-lg-3'><ul class='nav-sidebar'><li><a href='./'>Blog index</a></li><li class='active'><a href='#doc'>Exploring AI with Groovy™</a></li><li><a href='#_introduction' class='anchor-link'>Introduction</a></li><li><a href='#_using_ollama4j' class='anchor-link'>Using Ollama4j</a></li><li><a href='#_using_langchain4j' class='anchor-link'>Using LangChain4j</a></li><li><a hr [...]
<a href="https://github.com/paulk-asert/" target="_blank" rel="noopener noreferrer"><img style="border-radius:50%;height:48px;width:auto" src="img/paulk-asert.png" alt="Paul King"></a>
<div style="display:grid;align-items:center;margin:0.1ex;padding:0ex">
<div><a href="https://github.com/paulk-asert/" target="_blank" rel="noopener noreferrer"><span>Paul King</span></a></div>
<div><small><i>PMC Member</i></small></div>
</div>
- </div><br/><span>Published: 2025-10-15 07:06AM</span></p><hr/><div class="sect1">
+ </div><br/><span>Published: 2025-10-15 07:06AM (Last updated: 2025-11-14 08:05PM)</span></p><hr/><div class="sect1">
<h2 id="_introduction">Introduction</h2>
<div class="sectionbody">
<div class="quoteblock">
<blockquote>
<div class="paragraph">
-<p><span class="blue">In this post, we’ll look at several ways to integrate Groovy with AI tools, including <code>ollama4j</code>, <code>langchain4j</code>, <code>Spring AI</code>, and <code>Embabel</code>.</span></p>
+<p><span class="blue">In this post, we’ll look at several ways to integrate Groovy with AI tools, including <code>Ollama4j</code>, <code>LangChain4j</code>, <code>Spring AI</code>, <code>Embabel</code>, <code>Micronaut LangChain4j</code>, and <code>Quarkus LangChain4j</code>.</span></p>
</div>
</blockquote>
</div>
@@ -90,6 +90,7 @@ The libraries we use here can also connect to remote models and services.</p>
<div class="paragraph">
<p>The examples mostly use the <code>mistral:7b</code> model, which you’ll need to download to run the examples
unchanged, but feel free to try other models and see what results you get.
+Some of the examples use the <code>qwen3:8b</code> model. It seems to give better results when using tools.
We also used Groovy 5 and JDK 25, but the examples should work on other Groovy and Java versions.</p>
</div>
</div>
@@ -154,7 +155,8 @@ println "Four things:\n$result.responseModel.message.response"</code></pre>
</div>
</div>
<div class="paragraph">
-<p>We can continue the conversation by including the previous chat history in the next request:</p>
+<p>AI chat calls are stateless, but we can simulate continuing the conversation by
+including the previous chat history as additional messages in a subsequent request:</p>
</div>
<div class="listingblock">
<div class="content">
@@ -215,6 +217,275 @@ println "Response: " + chatModel.chat(prompt)</code></pre>
4. Take a day trip to the Glass House Mountains: Just a short drive from Caloundra, these iconic volcanic plugs offer breathtaking views and hiking trails for all levels of fitness. You can also visit the Kondalilla National Park for waterfalls and rainforest walks.</pre>
</div>
</div>
+<div class="paragraph">
+<p>Similarly to Ollama4j, we can manually include previous response messages
+to have a conversation with memory:</p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="prettyprint highlight"><code data-lang="groovy">var prompt = 'What are 4 interesting things to do while I am on vacation in Caloundra?'
+var response = model.chat(new UserMessage(prompt))
+
+var prompt2 = 'If I had half a day and can only go to one, which would you recommend?'
+var response2 = model.chat(response.aiMessage(), new UserMessage(prompt2))
+
+println """
+Four things:
+${response.aiMessage().text()}
+
+Best thing:
+${response2.aiMessage().text()}
+"""</code></pre>
+</div>
+</div>
+<div class="paragraph">
+<p>The output might be something like this:</p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre>Best thing:
+ If you only have half a day and can only choose one attraction, I would recommend visiting the UnderWater World SEA LIFE Mooloolaba. It's an excellent aquarium that offers a fascinating glimpse into the marine life of the region, and it's suitable for people of all ages.
+
+The UnderWater World is home to a variety of marine animals, including sharks, turtles, stingrays, seahorses, and many more. You can also participate in interactive experiences such as feeding the sharks or holding a starfish. The aquarium also offers educational programs and behind-the-scenes tours for those interested in learning more about marine conservation.
+
+While the Coastal Walk and Glass House Mountains are worth visiting if you have more time, they require more planning and travel time, so I would recommend UnderWater World SEA LIFE Mooloolaba as the best option for a half-day visit.</pre>
+</div>
+</div>
+<div class="paragraph">
+<p>LangChain4j however, also provides more friendly support to have a conversation with memory using its
+<code>AiServices</code> builder. We declare the interface of our chat assistant and provide some
+additional configuration information, and the builder will create our service for us:</p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="prettyprint highlight"><code data-lang="groovy">interface HolidayAssistant {
+ String chat(String message)
+}
+
+var model = OllamaChatModel.builder()
+ .baseUrl("http://localhost:11434")
+ .timeout(Duration.ofMinutes(5))
+ .modelName("mistral:7b")
+ .build()
+
+var chatMemory = MessageWindowChatMemory.withMaxMessages(10)
+
+var assistant = AiServices.builder(HolidayAssistant)
+ .chatModel(model)
+ .chatMemory(chatMemory)
+ .build()
+
+var prompt = 'What are 4 interesting things to do while I am on vacation in Caloundra?'
+var response = assistant.chat(prompt)
+
+var prompt2 = '''
+It might rain at some point on the weekend, so can you give me
+a very short description of a single backup alternative if it rains?
+Make it different to your previous suggestions since I am not
+sure which ones I will have already seen by the time it rains.
+'''
+var response2 = assistant.chat(prompt2)
+
+println """
+Four things:
+$response
+
+If it rains:
+$response2
+"""</code></pre>
+</div>
+</div>
+<div class="paragraph">
+<p><code>MessageWindowChatMemory</code> is one of several supported memory implementations.
+This ones keeps a window of in-memory messages available. Once the <em>max</em> configured
+number of messages is reached, they fall out of the cache.</p>
+</div>
+<div class="paragraph">
+<p>The output might be something like this:</p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre>Four things:
+ 1. Visit the beautiful beaches: Caloundra is known for its stunning beaches, with Mooloolaba Beach and Kings Beach being particularly popular. You can spend your days swimming, sunbathing, or even surfing.
+
+2. Explore the Underwater World SEA LIFE Sunshine Coast: This aquarium offers an amazing opportunity to get up close and personal with a variety of marine life, including sharks, stingrays, turtles, and seals.
+
+3. Visit the Bulcock Beach Esplanade: This is a great spot for shopping, dining, and people-watching. The esplanade offers a range of boutiques, cafes, and restaurants. Don't forget to check out the local markets that are held regularly.
+
+4. Take a day trip to Australia Zoo: Made famous by the Crocodile Hunter, Steve Irwin, this zoo is a must-visit for animal lovers. It's home to a wide variety of Australian wildlife and offers interactive experiences and shows throughout the day.
+
+If it rains:
+ If it rains, an indoor activity that you might enjoy is visiting the Queensland Air Museum in Caboolture, which is a short drive from Caloundra. The museum houses one of Australia's largest collections of aircraft and aviation artifacts, including military planes, helicopters, and memorabilia. It offers a fascinating look at the history of Australian aviation and is suitable for all ages.</pre>
+</div>
+</div>
+<div class="paragraph">
+<p><code>AiServices</code> also supports structured output if we declare that
+when defining our model, as this example shows:</p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="prettyprint highlight"><code data-lang="groovy">interface HolidayBot {
+ List<Activity> extractActivitiesFrom(String text)
+}
+
+var model = OllamaChatModel.builder()
+ .baseUrl("http://localhost:11434")
+ .supportedCapabilities(RESPONSE_FORMAT_JSON_SCHEMA)
+ .timeout(Duration.ofMinutes(5))
+ .modelName("mistral:7b")
+ .build()
+
+var chatMemory = MessageWindowChatMemory.withMaxMessages(10)
+
+var bot = AiServices.builder(HolidayBot)
+ .chatModel(model)
+ .chatMemory(chatMemory)
+ .build()
+
+var prompt = '''
+What are 4 interesting things to do for a long weekend vacation in Caloundra?
+Provide location, and suggested non-overlapping day and time for each activity.
+'''
+var response = bot.extractActivitiesFrom(prompt)
+
+var prompt2 = '''
+If my only spare time is Sunday morning, and I can only go to one activity, which would you recommend?
+'''
+var response2 = bot.extractActivitiesFrom(prompt2)
+
+println """
+Four things:
+${response.join('\n')}
+
+Best thing:
+${response2.join('\n')}
+"""</code></pre>
+</div>
+</div>
+<div class="paragraph">
+<p>Instead of returning a <code>String</code>, our chat service is now returning a <code>List<Activity></code> where <code>Activity</code>
+is a domain record defined as follows:</p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="prettyprint highlight"><code data-lang="groovy">@ToString(includePackage = false)
+record Activity(String activity, String location, String day, String time) {
+}</code></pre>
+</div>
+</div>
+<div class="paragraph">
+<p>The <code>RESPONSE_FORMAT_JSON_SCHEMA</code> configuration will represent our domain record
+in JSON using its record component names and values.</p>
+</div>
+<div class="paragraph">
+<p>The output might look something like:</p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre>Four things:
+Activity(Visit Australia Zoo, Beerwah, Queensland (Approx. 30 minutes drive from Caloundra), Day 1 - Friday, 9:00 AM - 5:00 PM)
+Activity(Explore Kings Beach and the Coastal Walk, Caloundra, Queensland, Day 2 - Saturday, 8:00 AM - Afternoon)
+Activity(Relax at Bulcock Beach Market, Bulcock Street, Caloundra, Day 3 - Sunday, 6:00 AM - 1:00 PM)
+Activity(Explore the Glass House Mountains, Glass House Mountains, Queensland (Approx. 45 minutes drive from Caloundra), Day 4 - Monday, 9:00 AM - 3:00 PM)
+
+Best thing:
+Activity(Relax at Bulcock Beach Market, Bulcock Street, Caloundra, Sunday, 6:00 AM - 1:00 PM)</pre>
+</div>
+</div>
+<div class="paragraph">
+<p><code>AiServices</code> also supports tools. Tools allow the LLM to query for information
+different to what it was trained on when the model was built.</p>
+</div>
+<div class="paragraph">
+<p>We’ll tweak our example to have a tool for finding "<em>next weekend</em>"
+and a tool for finding the weather forecast given a location and date.
+We’ll just have fake weather forecasts but we could call a REST service
+that provided real-time forecasting information.</p>
+</div>
+<div class="paragraph">
+<p>Our script now includes two tool definitions and might look something like this:</p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="prettyprint highlight"><code data-lang="groovy">interface HolidayAssistantTools {
+ String chat(String message)
+}
+
+@Tool("The LocalDate of the start of the coming weekend")
+LocalDate getWeekend() {
+ LocalDate.now().with(TemporalAdjusters.nextOrSame(DayOfWeek.SATURDAY))
+}
+
+@Field static Integer fakeDay = 0
+
+@Tool('The expected domain.Weather including weather forecast, min and max temperature in Celsius for a given location and LocalDate')
+Weather getWeather(String location, LocalDate date) {
+ var fakeWeather = [0: [Caloundra: new Weather('Sunny and Hot', 30, 37)],
+ 1: [Caloundra: new Weather('Raining', 5, 15)]]
+ fakeWeather[fakeDay++ % fakeWeather.size()][location]
+}
+
+var model = OllamaChatModel.builder()
+ .baseUrl("http://localhost:11434")
+ .timeout(Duration.ofMinutes(5))
+ .modelName("qwen3:8b")
+// .logRequests(true)
+// .logResponses(true)
+ .build()
+
+var chatMemory = MessageWindowChatMemory.withMaxMessages(10)
+
+var assistant = AiServices.builder(HolidayAssistantTools)
+ .chatModel(model)
+ .chatMemory(chatMemory)
+ .tools(this)
+ .build()
+
+var prompt = '''
+Recommend an interesting thing to see in Caloundra for each day of this coming weekend.
+Factor in expected weather when making recommendations. Do not hallucinate weather or dates.
+'''
+var response = assistant.chat(prompt)
+
+println """
+Preparing recommendations as at: ${LocalDate.now()}
+Interesting things:
+$response
+"""</code></pre>
+</div>
+</div>
+<div class="paragraph">
+<p>We switched to the <code>qwen3:8b</code> model. It is slightly larger to download but does
+a more reliable job calling tools correctly. The tools are annotation with <code>@Tools</code>
+and will be automatically found.</p>
+</div>
+<div class="paragraph">
+<p>The output might look something like:</p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre>Preparing recommendations as at: 2025-11-12
+Interesting things:
+Here’s a weather-aware recommendation for Caloundra this coming weekend (November 15–16, 2025):
+
+**Saturday, November 15 (Sunny & Hot: 30°C–37°C)**
+☀️ **Beach Day at Caloundra Spit**
+- Explore the scenic Caloundra Spit, a 12km stretch of sand with wildlife, birdlife, and picnic spots.
+- Try snorkeling or swimming in the calm waters (avoid midday sun; visit early morning or late afternoon).
+- Tip: Stay hydrated, wear sunscreen, and bring a hat.
+
+**Sunday, November 16 (Raining & Cool: 5°C–15°C)**
+🌧️ **Indoor Cultural Activities**
+- Visit the **Caloundra Art Gallery** or **Caloundra Library** for indoor browsing and local art exhibits.
+- Enjoy a cozy café visit (e.g., **The Coffee Bean & Tea Leaf**) with a book or light meal.
+- Tip: Pack an umbrella, layer clothing, and prioritize dry footwear.
+
+Safe travels! 🌊📚</pre>
+</div>
+</div>
+<div class="paragraph">
+<p>Note that it gave accurate recommendations that include our two fake weather forecasts.</p>
+</div>
</div>
</div>
<div class="sect1">
@@ -234,10 +505,10 @@ Our entire script is shown below:</p>
void main() {
try(var context = SpringApplication.run(Holiday)) {
var chatClient = context.getBean(ChatClient.Builder).build()
- var response = chatClient
- .prompt("What are some interesting things to do while I am on vacation in Caloundra?")
+ println chatClient
+ .prompt("What are four interesting things to do while I am on vacation in Caloundra?")
.call()
- println "Response:\n" + response.content()
+ .content()
}
}</code></pre>
</div>
@@ -251,8 +522,7 @@ to tell Spring AI to use Ollama and our chosen model.</p>
</div>
<div class="listingblock">
<div class="content">
-<pre>Response:
- Caloundra, located on the Sunshine Coast of Australia, offers a variety of activities that cater to different interests. Here are some suggestions for an enjoyable vacation:
+<pre> Caloundra, located on the Sunshine Coast of Australia, offers a variety of activities that cater to different interests. Here are some suggestions for an enjoyable vacation:
1. Beaches: Caloundry has several beautiful beaches, including Kings Beach, Moffat Beach, and Bulcock Beach. You can swim, sunbathe, surf, or just enjoy the stunning views.
@@ -260,34 +530,22 @@ to tell Spring AI to use Ollama and our chosen model.</p>
3. Explore the Glass House Mountains: These are a series of 12 granite peaks that offer stunning views of the surrounding area. You can hike, picnic, or simply enjoy the panoramic vistas.
-4. Visit the Eumundi Markets: Open on Saturdays and Wednesdays, these markets feature over 600 stalls selling art, crafts, produce, and food. It's a great place to pick up unique souvenirs and sample local delicacies.
-
-5. Go for a scenic flight: For a truly unforgettable experience, consider taking a scenic flight over the Sunshine Coast. You'll get breathtaking views of the coastline, hinterland, and the Glass House Mountains.
-
-6. Visit Australia Zoo: Made famous by the Crocodile Hunter, Steve Irwin, this zoo is home to a wide variety of Australian wildlife. It's a great place for families and animal lovers.
-
-7. Enjoy local cuisine: Caloundra has a vibrant food scene with numerous restaurants offering everything from fresh seafood to international cuisines. Be sure to try some local favorites like Barramundi, Moreton Bay bugs, and mangoes.
-
-8. Visit the Powerboat Park: If you're a fan of powerboats, this park is a must-visit. It features a museum dedicated to the history of powerboating in Australia.
-
-9. Relax at a day spa: After a day of exploring, treat yourself to a relaxing massage or beauty treatment at one of Caloundra's many day spas.
-
-10. Go fishing: Whether you prefer deep-sea fishing or casting a line from the shore, Caloundra offers numerous opportunities for anglers. You can even hire a charter boat if you don't have your own equipment.</pre>
+4. Visit the Eumundi Markets: Open on Saturdays and Wednesdays, these markets feature over 600 stalls selling art, crafts, produce, and food. It's a great place to pick up unique souvenirs and sample local delicacies.</pre>
</div>
</div>
<div class="paragraph">
<p>Spring AI also supports structured outputs — where responses are deserialized into domain objects.</p>
</div>
<div class="paragraph">
-<p>Let’s create a small domain model for describing activities and lists of activities (itineraries).</p>
+<p>We saw the <code>Activity</code> record previously. Rather than just having a list of <code>Activity</code>,
+let’s also define a record to capture itineraries of activities:</p>
</div>
<div class="listingblock">
<div class="content">
-<pre class="prettyprint highlight"><code data-lang="groovy">@ToString(includePackage = false)
-record Activity(String activity, String location, String day, String time) {
-}
-
-record Itinerary(List<Activity> itinerary) {
+<pre class="prettyprint highlight"><code data-lang="groovy">record Itinerary(List<Activity> itinerary) {
+ String display() {
+ itinerary.join('\n')
+ }
}</code></pre>
</div>
</div>
@@ -305,7 +563,7 @@ void main() {
.prompt("What are some interesting things to do while I am on vacation in Caloundra?")
.call()
.entity(Itinerary)
- println "Response:\n" + response.itinerary.join('\n')
+ println "Response:\n" + response.display()
}
}</code></pre>
</div>
@@ -324,6 +582,72 @@ Activity(Relax at Shelly Beach, Caloundra, Day 3, Morning)
Activity(Explore Pumicestone Passage by boat tour, Caloundra, Day 3, Afternoon)</pre>
</div>
</div>
+<div class="paragraph">
+<p>Spring AI also supports tools. Our script might look like this:</p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="prettyprint highlight"><code data-lang="groovy">@Component
+class WeekendTool {
+ @Tool(description = 'The LocalDate of the start of the coming weekend')
+ LocalDate getWeekend() {
+ LocalDate.now().with(TemporalAdjusters.nextOrSame(DayOfWeek.SATURDAY))
+ }
+}
+
+@Component
+class WeatherTool {
+ static Integer fakeDay = 0
+
+ @Tool(description = 'The expected weather including forecast, min and max temperature in Celsius for a given location and LocalDate')
+ Weather getWeather(String location, LocalDate date) {
+ var fakeWeather = [0: [Caloundra: new Weather('Sunny and Hot', 30, 37)],
+ 1: [Caloundra: new Weather('Raining', 5, 15)]]
+ fakeWeather[fakeDay++ % fakeWeather.size()][location]
+ }
+}
+
+@SpringBootApplication
+void main() {
+ var prompt = '''
+Recommend an interesting thing to see in Caloundra for each day of this coming weekend.
+Factor in expected weather when making recommendations. Do not hallucinate weather or dates.
+'''
+ try(var context = SpringApplication.run(Holiday)) {
+ var chatClient = context.getBean(ChatClient.Builder).build()
+ var weekend = context.getBean(WeekendTool)
+ var weather = context.getBean(WeatherTool)
+ var options = OllamaChatOptions.builder().model('qwen3:8b').build()
+ println chatClient
+ .prompt(prompt)
+ .options(options)
+ .tools(weekend, weather)
+ .call()
+ .content()
+ }
+}</code></pre>
+</div>
+</div>
+<div class="paragraph">
+<p>And the output might look like this:</p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre>**Saturday, November 15 (Sunny & Hot: 30°C–37°C)**
+Perfect for outdoor adventures!
+- **Caloundra Spit** – Explore the scenic coastal walk with panoramic ocean views.
+- **Snorkeling at Mooloolaba Beach** – Clear waters and vibrant marine life.
+- **Glass House Mountains Day Trip** – A short drive offers dramatic landscapes and hiking.
+
+**Sunday, November 16 (Raining: 5°C–15°C)**
+Opt for indoor attractions or sheltered activities:
+- **Caloundra Cultural Centre** – Discover local art and history.
+- **Caloundra Regional Gallery** – Enjoy contemporary exhibitions.
+- **Indoor Water Playground** – A splash-filled escape from the rain.
+
+Always check for real-time weather updates closer to the date! 🌞🌧️</pre>
+</div>
+</div>
</div>
</div>
<div class="sect1">
@@ -344,7 +668,7 @@ void main() {
println context.getBean(OperationContext)
.ai()
.withDefaultLlm()
- .generateText('What are some interesting things to do while I am on vacation in Caloundra?')
+ .generateText('What are four interesting things to do while I am on vacation in Caloundra?')
}
}</code></pre>
</div>
@@ -354,27 +678,13 @@ void main() {
</div>
<div class="listingblock">
<div class="content">
-<pre>Caloundra, located on the Sunshine Coast in Queensland, Australia, offers a variety of activities for tourists. Here are some suggestions for an enjoyable vacation:
-
-1. Visit the beautiful beaches: Caloundra has several beautiful beaches, such as Kings Beach, Shelly Beach, and Moffat Beach, where you can swim, sunbathe, or surf.
+<pre> 1. Visit the Bulcock Beach: This is a popular beach in Caloundra, perfect for swimming, sunbathing, and enjoying various water sports. There's also a picturesque esplanade with cafes, shops, and art galleries nearby.
-2. Explore the Coastal Walk: Take a leisurely stroll along the Coastal Walk, which offers stunning views of the ocean, coastal cliffs, and nearby islands.
+2. Explore the Kings Beach Park: Located next to Kings Beach, this park offers a variety of facilities including picnic areas, BBQ facilities, playgrounds, and beautiful views of the ocean. It's a great spot for families with children.
-3. Visit the Underwater World SEA LIFE Mooloolaba Aquarium: Discover an amazing underwater world filled with sea turtles, sharks, seahorses, and more.
+3. Visit the Australian Zoo: Made famous by Steve Irwin, the Australian Zoo is just a short drive from Caloundra. Here you can see a wide variety of Australian wildlife, including kangaroos, koalas, and crocodiles.
-4. Spend a day at Australia Zoo: Home to over 1,200 animals and the late Steve Irwin's family, this iconic zoo offers up-close encounters with some of Australia's most famous wildlife.
-
-5. Visit the Glastonbury Estate Winery: Taste locally produced wines at this picturesque winery, which also features a restaurant and beautiful gardens.
-
-6. Explore the Bulcock Beach Esplanade: This vibrant area offers a variety of shops, cafes, and restaurants, as well as regular markets on weekends.
-
-7. Take a day trip to Fraser Island: Known for its stunning beaches, crystal-clear waters, and rainforests, Fraser Island is just a short boat ride away from Caloundra.
-
-8. Enjoy the Pumicestone Passage: Go boating, kayaking, or fishing in this beautiful waterway that separates Bribie Island from the mainland.
-
-9. Visit the Powerboat Park: Watch high-speed powerboats compete in various races at this popular watersports venue.
-
-10. Relax at a spa or wellness center: Pamper yourself with a massage, beauty treatment, or yoga class at one of Caloundra's many wellness centers.</pre>
+4. Take a day trip to the Glass House Mountains: These are a series of 13 steep sided, volcanic plugs that dominate the local landscape. You can hike some of the mountains, or simply enjoy their unique beauty from various lookout points. Some popular ones include Mount Ngungun and Mount Beerwah.</pre>
</div>
</div>
<div class="paragraph">
@@ -472,7 +782,7 @@ class ItineraryAgent {
void main() {
try(var context = SpringApplication.run(Rated)) {
println context.getBean(Autonomy)
- .chooseAndRunAgent('A long-weekend holiday in Caloundra', ProcessOptions.DEFAULT).output
+ .chooseAndRunAgent('Itinerary for a relaxing long-weekend holiday in Caloundra', ProcessOptions.DEFAULT).output
}
}</code></pre>
</div>
@@ -502,11 +812,177 @@ The <code>@AchievesGoal</code> annotation makes use of Embabel’s goal-orie
</div>
</div>
<div class="sect1">
+<h2 id="_using_micronaut_langchain4j">Using Micronaut LangChain4j</h2>
+<div class="sectionbody">
+<div class="paragraph">
+<p><a href="https://micronaut-projects.github.io/micronaut-langchain4j/latest/guide/"><em>Micronaut LangChain4j</em></a>
+provides integration between Micronaut and LangChain4j.
+This module is regarded as somewhat experimental and subject to change, but
+is already quite feature rich. We’ll just look at some basic capabilities.</p>
+</div>
+<div class="paragraph">
+<p>First, let’s do a basic chat example. This time asking for recommendations for Auckland.
+Our code might look like this:</p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="prettyprint highlight"><code data-lang="groovy">@Singleton
+class AppRunner {
+ @Inject
+ HolidayAssistant assistant
+
+ void run() {
+ println assistant.activities('What are four good things to see while I am in Auckland?')
+ }
+}
+
+@AiService
+interface HolidayAssistant {
+ @SystemMessage('''
+ You are knowledgeable about places tourists might like to visit.
+ Answer using New Zealand slang but keep it family friendly.
+ ''')
+ String activities(String userMessage)
+}
+
+try(var context = ApplicationContext.run()) {
+ context.getBean(AppRunner).run()
+}</code></pre>
+</div>
+</div>
+<div class="paragraph">
+<p>Micronaut’s sweet spot is creating microservices.
+Here we are just creating a command-line application, so we aren’t use many Micronaut
+features, but we will use its dependency injection capabilities.
+While not strictly needed, a common convention is to have an <code>AppRunner</code> class with a <code>run</code> method
+to run our application.</p>
+</div>
+<div class="paragraph">
+<p>We saw previously that LangChain4j had an <code>AiServices</code> builder.
+Micronaut provides instead the more declarative approach of providing an <code>@AiServices</code>
+annotation. The code for our assistant will be generated at compile time.
+Note that we can provide a system message as part of that annotation.
+Watch out for the NZ slang in some of the responses!</p>
+</div>
+<div class="paragraph">
+<p>The output might look something like:</p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre> Blimey mate, while you're roaming around Auckland, here are four top-notch spots ya gotta check out:
+
+1. The Sky Tower - It's like the tallest bloke in town, with a view that'll make ya heart race.
+2. Waitomo Glowworm Caves - It's a magical spot where tiny luminescent critters put on a light show.
+3. Waiheke Island - A chilled-out paradise with beaches and vineyards, perfect for a day trip or longer stay.
+4. Auckland Zoo - Get up close and personal with some of New Zealand's native critters, as well as exotic animals from around the world. Kiwi, eh?</pre>
+</div>
+</div>
+<div class="paragraph">
+<p>Structured output is also supported.</p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="prettyprint highlight"><code data-lang="groovy">@AiService
+interface HolidayBot {
+ @SystemMessage('''
+ Return holiday activity suggestions as structured JSON matching Itinerary.
+ Timebox activities if needed to fit within the holiday length and not overlap other
+ activities while still giving enough time to see all major aspects of each attraction.
+ Exclude other information.
+ ''')
+ Itinerary itinerary(String userMessage)
+}
+
+try(var context = ApplicationContext.run()) {
+ println context.getBean(HolidayBot)
+ .itinerary('Four great things to see in Auckland over a weekend.')
+ .display()
+}</code></pre>
+</div>
+</div>
+<div class="paragraph">
+<p>Here we didn’t use the <code>AppRunner</code> convention.
+It’s just a single bean that we want to invoke after all.</p>
+</div>
+<div class="paragraph">
+<p>The output might look like:</p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre>Activity(Visit Auckland War Memorial Museum, Auckland, Day 1, 9:00 AM - 5:00 PM)
+Activity(Explore Viaduct Harbour and Wynyard Quarter, Auckland, Day 1, 6:00 PM - 8:00 PM)
+Activity(Hike up Mount Eden, Auckland, Day 2, 9:00 AM - 12:00 PM)
+Activity(Visit Waiheke Island and its vineyards, Waiheke Island, Day 2, 1:00 PM - 6:00 PM)</pre>
+</div>
+</div>
+</div>
+</div>
+<div class="sect1">
+<h2 id="_using_quarkus_langchain4j">Using Quarkus LangChain4j</h2>
+<div class="sectionbody">
+<div class="paragraph">
+<p>The
+<a href="https://docs.quarkiverse.io/quarkus-langchain4j/dev/index.html">Quarkus LangChain4j</a>
+extension integrates Large Language Models (LLMs) into your Quarkus applications.
+Let’s just build a simple chat example. Quarkus also follows the now familiar
+declarative approach. We can define an AI service like this:</p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="prettyprint highlight"><code data-lang="groovy">@RegisterAiService
+@ApplicationScoped
+interface HolidayAssistant {
+ @SystemMessage('You are knowledgeable about places tourists might like to visit.')
+ String ask(@UserMessage String question)
+}</code></pre>
+</div>
+</div>
+<div class="paragraph">
+<p>Then our main script would be this:</p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="prettyprint highlight"><code data-lang="groovy">@QuarkusMain
+class Holiday implements QuarkusApplication {
+
+ @Inject
+ HolidayAssistant assistant
+
+ @Override
+ int run(String... args) {
+ def question = 'What are four things to do while visiting Minneapolis?'
+ println "Asking: $question"
+ def answer = assistant.ask(question)
+ println "Answer: $answer"
+ return 0
+ }
+}</code></pre>
+</div>
+</div>
+<div class="paragraph">
+<p>Running the example might give output like:</p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre>Asking: What are four things to do while visiting Minneapolis?
+Answer: 1. Explore the Minneapolis Sculpture Garden: This 11-acre outdoor museum located in downtown Minneapolis is home to over 40 works of art, including the iconic "Spoonbridge and Cherry" sculpture. The garden also features walking trails, picnic areas, and a conservatory.
+
+2. Visit the Mill City Museum: Located in the former Washburn A Mill, this museum tells the story of Minneapolis' milling heritage. You can explore exhibits on the city's flour-milling past, take a tour of the restored flour mill elevators, and enjoy panoramic views of the Mississippi River from the rooftop observation deck.
+
+3. Stroll through the Minnehaha Park: This beautiful urban park features hiking trails, a waterfall, and breathtaking views of the Mississippi River. You can also visit Minnehaha Falls, a 53-foot waterfall that is one of the most popular attractions in Minneapolis.
+
+4. Attend a concert or sporting event: Minneapolis is home to several major sports teams, including the Minnesota Vikings (NFL), Minnesota Timberwolves (NBA), and Minnesota Twins (MLB). The city also has a thriving music scene, with venues like First Avenue and the Orpheum Theatre hosting concerts by popular artists. Additionally, the Walker Art Center offers free outdoor performances during the summer months at its Sculpture Garden.</pre>
+</div>
+</div>
+</div>
+</div>
+<div class="sect1">
<h2 id="_conclusion">Conclusion</h2>
<div class="sectionbody">
<div class="paragraph">
<p>Groovy’s interoperability, concise syntax, and powerful DSL capabilities make it an excellent language for prototyping and composing AI workflows on the JVM.
-Whether you’re chatting with Ollama, integrating via Spring, or orchestrating agents with Embabel, Groovy keeps your code clear and compact.
+Whether you’re chatting with Ollama, integrating via Spring, Micronaut, or Quarkus,
+or orchestrating agents with Embabel, Groovy keeps your code clear and compact.
Feel free to experiment with different models and prompts to see what interesting results you can achieve!</p>
</div>
<div class="paragraph">
@@ -515,6 +991,15 @@ Feel free to experiment with different models and prompts to see what interestin
Other examples of using Groovy with Spring AI can be found at:<br>
<a href="https://github.com/danvega/groovyai" class="bare">https://github.com/danvega/groovyai</a></p>
</div>
+<div class="sidebarblock">
+<div class="content">
+<div class="title">Update history</div>
+<div class="paragraph">
+<p><strong>15/Oct/2023</strong>: Initial version<br>
+<strong>14/Nov/2025</strong>: Updated with Micronaut, Quarkus, and tools examples.</p>
+</div>
+</div>
+</div>
</div>
</div></div></div></div></div><footer id='footer'>
<div class='row'>
diff --git a/blog/index.html b/blog/index.html
index 692faae..08bd4ee 100644
--- a/blog/index.html
+++ b/blog/index.html
@@ -59,7 +59,7 @@
</ul>
</div>
</div>
- </div><div id='content' class='page-1'><div class='row'><div class='row-fluid'><div class='col-lg-3' id='blog-index'><ul class='nav-sidebar list'><li class='active'><a href='/blog/'>Blogs</a></li><li><a href='embabel-agentic-patterns'>Groovy™, Embabel, and Agentic Design Patterns</a></li><li><a href='groovy-ai'>Exploring AI with Groovy™</a></li><li><a href='wayang-tensorflow'>Using TensorFlow from Apache Wayang</a></li><li><a href='using-groovy-with-ap [...]
+ </div><div id='content' class='page-1'><div class='row'><div class='row-fluid'><div class='col-lg-3' id='blog-index'><ul class='nav-sidebar list'><li class='active'><a href='/blog/'>Blogs</a></li><li><a href='groovy-ai'>Exploring AI with Groovy™</a></li><li><a href='embabel-agentic-patterns'>Groovy™, Embabel, and Agentic Design Patterns</a></li><li><a href='wayang-tensorflow'>Using TensorFlow from Apache Wayang</a></li><li><a href='using-groovy-with-ap [...]
<div class='row'>
<div class='colset-3-footer'>
<div class='col-1'>
@@ -103,7 +103,7 @@
colors: am5.ColorSet.new(root, {})
}));
wc.data.setAll([
- { category: "groovy", value: 87 }, { category: "asf", value: 2 }, { category: "apachecon", value: 3 }, { category: "communityovercode", value: 2 }, { category: "natural language processing", value: 2 }, { category: "nlp", value: 1 }, { category: "nlpcraft", value: 1 }, { category: "combinations", value: 1 }, { category: "permutations", value: 1 }, { category: "testing", value: 2 }, { category: "junit", value: 2 }, { category: "spock", value: 2 }, { category: "jqwik", valu [...]
+ { category: "groovy", value: 87 }, { category: "asf", value: 2 }, { category: "apachecon", value: 3 }, { category: "communityovercode", value: 2 }, { category: "natural language processing", value: 2 }, { category: "nlp", value: 1 }, { category: "nlpcraft", value: 1 }, { category: "combinations", value: 1 }, { category: "permutations", value: 1 }, { category: "testing", value: 2 }, { category: "junit", value: 2 }, { category: "spock", value: 2 }, { category: "jqwik", valu [...]
]);
wc.labels.template.setAll({
paddingTop: 5,