add AI assistance documentation (#872)

Author: Logende

README.md

@@ -99,6 +99,8 @@ Explore how to use MetaConfigurator with real-world examples:
 
 *   **[Code Generation](./documentation_user/examples/code_generation)** – Learn how to generate code in multiple programming languages from JSON schemas.
 
+*   **[AI Assistance](./documentation_user/examples/ai_assistance)** – Learn how to use AI-assisted features for schema and data creation/editing, as well as data transformation.
+
 
 
 📚 Read the full [User Documentation](./documentation_user).

documentation_user/README.md

@@ -6,6 +6,7 @@
 * [Configurator Building](examples/configurator_building) (Shows how to use MetaConfigurator as a Configurator Builder, allowing users to create and share URLs that open MetaConfigurator with preloaded schema, data, and settings)
 * [Code Generation](examples/code_generation) (Shows how to generate code in multiple programming languages from JSON schemas)
 * [Schema Selection List](examples/schema_selection_list) (Provide your users a pre-defined list of schemas to choose from; useful for organizations)
+* [AI Assistance](examples/ai_assistance) (Shows how to use AI-assisted features for schema and data creation/editing, as well as data transformation)
 
 ## Load a Schema
 

documentation_user/examples/ai_assistance/README.md

@@ -0,0 +1,41 @@
+# AI Assistance
+
+## Overview
+
+MetaConfigurator provides different AI-assisted features to help you create and edit JSON schemas and instance data using natural language inputs.
+
+Demonstration and Introduction video from the Allotrope Connect Workshop 2025 (click the image to open the video on Youtube):
+
+[![AI Assistance Introduction Video](http://i3.ytimg.com/vi/DfS6PgMr1q0/hqdefault.jpg)](https://www.youtube.com/watch?v=DfS6PgMr1q0)
+
+
+## Requirements
+
+To use the AI-assisted features, you need to have an OpenAI API key (or API key of another LLM endpoint provider). 
+You can obtain an API key by signing up on the [OpenAI website](https://platform.openai.com/signup/).
+
+## Endpoint Configuration
+
+To configure the LLM endpoint, open an AI-assisted feature (e.g., `Show AI Prompts View` button in the top menu bar) and expand the expandable/collapsible dialog.
+Here, you can enter your API key and select the desired LLM endpoint (e.g., OpenAI GPT-4, Perplexity, or a custom endpoint) and other parameters.
+
+<img alt="AI Endpoint Configuration" src="ai_settings.png" width="400"/>
+
+## How to Use AI Assistance
+
+### Schema Creation and Editing
+
+Open the AI Prompts View by clicking the `Show AI Prompts View` button in the top menu bar.
+Now you can enter prompts to create or edit schemas using natural language.
+
+### Schema Mapping and Data Transformation
+
+In the `Data` tab, click `Utility...` -> `Transform Data to match the Schema...`.
+This will open a dialog to generate a mapping configuration to map the current data to the target schema using AI.
+The generated mapping configuration can be reviewed and adjusted before applying it to transform the data.
+
+### Data Transformation to other Formats
+
+In the `Data` tab, click `Utility...` -> `Export Data via Text Template...`.
+This will open a dialog to generate a text template using AI to transform the current data to another format (e.g., XML, CSV, custom format).
+The generated text template can be reviewed and adjusted before applying it to transform the data.