add 6.2 new features

zspitzer · zspitzer · commit 27e46237b22e · 2025-02-27T10:45:25.000+01:00
diff --git a/docs/00.home/homepage.md b/docs/00.home/homepage.md
@@ -18,7 +18,7 @@ To find out more about getting involved as a developer with Lucee, checkout our
 
 ## Recipes 
 
-**New!** We have added a whole series of detailed [[Recipes]] showing you how to take advantage of the wide range of features in Lucee.
+We have added a whole series of detailed [[Recipes]] showing you how to take advantage of the wide range of features in Lucee.
 
 ## Deploying Lucee
 
@@ -30,14 +30,16 @@ To find out more about getting involved as a developer with Lucee, checkout our
 
 ## Lucee 6.2
 
-Lucee 6.2 is our upcoming next major release, currently at the Release Candidate stage, including enhanced Java and Maven integration, Jakarta Servlet support and better runtime performance, up to 50% faster than Lucee 5.4.
+**New!** Lucee 6.2 is our latest stable release, with enhanced Java and Maven integration, Jakarta Servlet support and better runtime performance.
+
+Lucee 6.2 up to 50% faster than Lucee 5.4, while using less memory.
+
+Our Official Docker images and Installers for 6.2 all bundle Tomcat 10.1 and Java 21. This may cause issues with the switch to the Jakarta namespace, Lucee 6.2 supports both, but anything which integrates with Tomcat (i.e. urlrewrite) will need updating, see the [Jakarta](https://luceeserver.atlassian.net/issues/?jql=labels%20%3D%20%22jakarta%22) issues in our bug tracker.
 
 [[breaking-changes-6-1-to-6-2]]
 
 ## Lucee 6.1
 
-Lucee 6.1 is current stable release of Lucee.
-
 Targeting better performance and reduced memory usage, Lucee 6.1 introduces full support for Java 17 and 21, as well as Java 11.
 Java 8 is no longer officially supported.
 
diff --git a/docs/03.reference/01.functions/luceeaigetmetadata/_arguments/detailed.md b/docs/03.reference/01.functions/luceeaigetmetadata/_arguments/detailed.md
@@ -0,0 +1,4 @@
+When true, includes additional detailed information:
+
+- Models: List of available models with their names, labels, descriptions, and custom settings
+- Files: For file-capable engines, lists associated files with their IDs, purposes, sizes, creation dates, and status information
diff --git a/docs/03.reference/01.functions/luceeaigetmetadata/_arguments/name.md b/docs/03.reference/01.functions/luceeaigetmetadata/_arguments/name.md
@@ -0,0 +1,4 @@
+The name of the AI endpoint to get metadata for. Can be either:
+
+1. A direct endpoint name as configured in the Lucee Administrator
+2. A default reference (e.g., "default:exception") which will resolve to the configured default endpoint for that category
diff --git a/docs/03.reference/01.functions/luceeaigetmetadata/_returnTypeDesc.md b/docs/03.reference/01.functions/luceeaigetmetadata/_returnTypeDesc.md
diff --git a/docs/03.reference/01.functions/luceeaigetmetadata/_usageNotes.md b/docs/03.reference/01.functions/luceeaigetmetadata/_usageNotes.md
diff --git a/docs/03.reference/01.functions/luceeaigetmetadata/function.md b/docs/03.reference/01.functions/luceeaigetmetadata/function.md
@@ -0,0 +1,11 @@
+---
+title: LuceeAIgetMetadata
+id: function-luceeaigetmetadata
+categories:
+- ai
+---
+
+This feature is experimental and may be subject to change. If you encounter any issues while using this functionality, please report bugs and errors in our bug tracking system.
+Retrieves metadata about a configured AI endpoint. 
+Returns information about the endpoint's configuration, 
+and optionally detailed information about available models and associated files.
diff --git a/docs/03.reference/01.functions/luceeaihas/_arguments/name.md b/docs/03.reference/01.functions/luceeaihas/_arguments/name.md
@@ -0,0 +1,4 @@
+The name of the AI endpoint to check. Can be either:
+
+1. A direct endpoint name as configured in the Lucee Administrator
+2. A default reference (e.g., "default:exception") which will check if a default endpoint is configured for that category
diff --git a/docs/03.reference/01.functions/luceeaihas/_returnTypeDesc.md b/docs/03.reference/01.functions/luceeaihas/_returnTypeDesc.md
diff --git a/docs/03.reference/01.functions/luceeaihas/_usageNotes.md b/docs/03.reference/01.functions/luceeaihas/_usageNotes.md
diff --git a/docs/03.reference/01.functions/luceeaihas/function.md b/docs/03.reference/01.functions/luceeaihas/function.md
@@ -0,0 +1,9 @@
+---
+title: LuceeAIhas
+id: function-luceeaihas
+categories:
+- ai
+---
+
+This feature is experimental and may be subject to change. If you encounter any issues while using this functionality, please report bugs and errors in our bug tracking system.
+Checks whether a specific AI endpoint is configured and available for use.
diff --git a/docs/03.reference/01.functions/luceecreateaisession/_arguments/name.md b/docs/03.reference/01.functions/luceecreateaisession/_arguments/name.md
@@ -0,0 +1,13 @@
+Specifies which AI endpoint configuration to use. Can be provided in two formats:
+
+1. Direct endpoint name:
+The name of an endpoint as defined in the Lucee Administrator (similar to how datasource names work)
+2. Default reference:
+Using the format "default:category" to use the endpoint configured as the default for that specific category in the Lucee Administrator.
+
+Currently supported default categories:
+
+- exception: For exception analysis
+- documentation: For documentation tasks
+
+The endpoint configurations and their default category assignments are managed in the Lucee Administrator.
diff --git a/docs/03.reference/01.functions/luceecreateaisession/_arguments/systemMessage.md b/docs/03.reference/01.functions/luceecreateaisession/_arguments/systemMessage.md
@@ -0,0 +1,11 @@
+Initial instruction set that defines the AI's behavior and expertise for this session. This message sets the context and rules for all subsequent interactions.
+
+Best practices:
+
+- Be specific about the AI's role and expertise
+- Define output format requirements clearly
+- Include any necessary constraints or rules
+- Specify error handling preferences
+- Define response structure expectations
+
+The system message persists throughout the session and influences all responses.
diff --git a/docs/03.reference/01.functions/luceecreateaisession/_returnTypeDesc.md b/docs/03.reference/01.functions/luceecreateaisession/_returnTypeDesc.md
diff --git a/docs/03.reference/01.functions/luceecreateaisession/_usageNotes.md b/docs/03.reference/01.functions/luceecreateaisession/_usageNotes.md
diff --git a/docs/03.reference/01.functions/luceecreateaisession/function.md b/docs/03.reference/01.functions/luceecreateaisession/function.md
@@ -0,0 +1,21 @@
+---
+title: LuceeCreateAIsession
+id: function-luceecreateaisession
+categories:
+- ai
+---
+
+This feature is experimental and may be subject to change. If you encounter any issues while using this functionality, please report bugs and errors in our bug tracking system.
+Creates a new AI session for interaction with Large Language Models (LLMs). 
+The session maintains conversation history and context between interactions. 
+Each session can be configured with different parameters to optimize for specific use cases like code analysis, content generation, or data processing.
+
+Common usage patterns:
+
+- Exception analysis and debugging assistance
+- Code documentation generation
+- Query optimization suggestions
+- Security review assistance
+- Performance optimization recommendations
+
+The session persists until explicitly terminated or the application restarts.
diff --git a/docs/03.reference/01.functions/luceeinquiryaisession/_arguments/listener.md b/docs/03.reference/01.functions/luceeinquiryaisession/_arguments/listener.md
@@ -0,0 +1,3 @@
+A user-defined function that receives the response in chunks as they arrive from the AI. This enables real-time processing or display of the response.
+The listener function should accept a single argument which will contain the response chunk.
+When a listener is provided, the function still returns the complete response as a string, but also streams each chunk to the listener as it arrives.
diff --git a/docs/03.reference/01.functions/luceeinquiryaisession/_arguments/question.md b/docs/03.reference/01.functions/luceeinquiryaisession/_arguments/question.md
@@ -0,0 +1,2 @@
+The question or message to send to the AI. This can be plain text or structured data (like JSON) depending on how the session was configured in its system message.
+The question becomes part of the conversation history and provides context for future interactions within the same session.
diff --git a/docs/03.reference/01.functions/luceeinquiryaisession/_arguments/session.md b/docs/03.reference/01.functions/luceeinquiryaisession/_arguments/session.md
@@ -0,0 +1 @@
+The AI session object returned by LuceeCreateAISession(). This session maintains the conversation history and configuration settings like temperature and system message.
diff --git a/docs/03.reference/01.functions/luceeinquiryaisession/_returnTypeDesc.md b/docs/03.reference/01.functions/luceeinquiryaisession/_returnTypeDesc.md
diff --git a/docs/03.reference/01.functions/luceeinquiryaisession/_usageNotes.md b/docs/03.reference/01.functions/luceeinquiryaisession/_usageNotes.md
diff --git a/docs/03.reference/01.functions/luceeinquiryaisession/function.md b/docs/03.reference/01.functions/luceeinquiryaisession/function.md
@@ -0,0 +1,10 @@
+---
+title: LuceeInquiryAIsession
+id: function-luceeinquiryaisession
+categories:
+- ai
+---
+
+This feature is experimental and may be subject to change. If you encounter any issues while using this functionality, please report bugs and errors in our bug tracking system.
+Sends a question/message to an AI session and returns the response. The function maintains conversation context from previous interactions within the same session.
+The response can either be returned as a complete string or streamed in chunks to a listener function for real-time processing.
diff --git a/docs/03.reference/02.tags/search/_attributes/contextpassagelength.md b/docs/03.reference/02.tags/search/_attributes/contextpassagelength.md
@@ -0,0 +1,3 @@
+Used as a guide for splitting the text into paragraphs. The splitter tries to keep paragraphs close to this length 
+while maintaining natural text boundaries. Note that paragraphs may exceed this length if no suitable break point is found.
+Default: 150
diff --git a/docs/03.reference/05.objects/query/keyexists/_arguments/query.md b/docs/03.reference/05.objects/query/keyexists/_arguments/query.md
@@ -0,0 +1 @@
+Name of the query to check
diff --git a/docs/03.reference/05.objects/query/setcell/_arguments/column_name.md b/docs/03.reference/05.objects/query/setcell/_arguments/column_name.md
@@ -0,0 +1 @@
+Name of the column to update
diff --git a/docs/03.reference/05.objects/query/setcell/_arguments/row_number.md b/docs/03.reference/05.objects/query/setcell/_arguments/row_number.md
@@ -0,0 +1 @@
+Which row to update, defaults to the the last row in the query
diff --git a/docs/03.reference/05.objects/query/setcell/_arguments/value.md b/docs/03.reference/05.objects/query/setcell/_arguments/value.md
@@ -0,0 +1 @@
+New value for the cell
diff --git a/docs/03.reference/05.objects/query/slice/_arguments/query.md b/docs/03.reference/05.objects/query/slice/_arguments/query.md
@@ -0,0 +1 @@
+Name of the query to slice
diff --git a/docs/05.categories/005.ai/category.md b/docs/05.categories/005.ai/category.md
@@ -0,0 +1,6 @@
+---
+title: AI / LLM Integration
+id: category-ai
+---
+
+The AI support feature is experimental and the function API may be subject to change.
diff --git a/docs/recipes/ai-for-documentation.md b/docs/recipes/ai-for-documentation.md
@@ -2,6 +2,7 @@
 {
   "title": "AI Integration for Documentation (Experimental)",
   "id": "ai-documentation-setup",
+  "categories": [ "ai" ],
   "description": "Guide to configuring AI for use in Lucee's Documentation tab, leveraging retrieval-augmented generation (RAG) and enhanced search functionality.",
   "keywords": [
     "AI",
diff --git a/docs/recipes/ai.md b/docs/recipes/ai.md
@@ -2,6 +2,7 @@
 {
   "title": "AI (experimental)",
   "id": "ai",
+  "categories": ["ai"],
   "description": "",
   "keywords": [
     "AI",
diff --git a/docs/recipes/breaking-changes-6-2.md b/docs/recipes/breaking-changes-6-2.md
@@ -15,6 +15,14 @@
 
 This document outlines the breaking changes introduced when upgrading from Lucee 6.1 to Lucee 6.2. Be aware of these changes when migrating your applications to ensure smooth compatibility.
 
+## Java Support
+
+- Java 21 is recommended as it's a LTS release.
+- Java 23 is supported
+- Java 24-ea works, but there are some issues with date handling
+- Java 11 is supported
+- Java 8 is no longer supported
+
 ## Changing PreciseMath to be off by default
 
 With Lucee 6, we introduced support for higher precision maths, by switching the underlying Java class from Double to BigInteger.
