Changes
The {{UBIK}} Intelligent Atelier Plugin provides a user interface for interactive agentic AI modelling in {{UBIK}} Studio.
== Overview ==The Intelligent Atelier can be used to develop part of a {{UnderConstructionStartUBIK}}customizing, debug errors or to find answers to {{UBIK}}-specific questions.In the To-Do List, one can always see what is being planned and done. The artefacts view lists all currently relevant objects, ready for drag & drop to other {{UBIK}} Studio controls.[[File:intelligent-atelier-control.png|thumb|right|350px|]]
== Prerequisites ==
The Intelligent Atelier Plugin is available starting with '''a {{UBIK 5.2.0''' version and can only be used in }} Plugin for {{UBIK}} Studio.{{Version/ServerSince|5.2.0}}. Before using === Installation ===Install the plugin, it must be installed via with the name "Add PluginsUBIK.Module.IntelligentAtelier" #thing#, where using [[Injection_Management|UBIK Plugin Injection]].=== Configuration ===For the plugin feature to work, an AI model is copied automatically or required. Access to this service must be provided by manually copying the plugin in the Injection folder (''\AppData\Local\Augmensys\UBIK\CUSTOM\administrator.In {DataBase Name{UBIK}\INJECTION '} Studio')s database connection settings, where its automatically discovered during configure values for the startup.following keys:To use the * <b>AI service, the plugin requires a valid configuration of theREST API URL</b>:Azure AI Foundry deployment URL* <b>AI Model* URL andREST API Key</b>: Azure AI Foundry deployment Key* <b>AI REST API key with acces to Model</b>: The name of the selected deployed model The plugin currently supports the REST API with When this article was created, the supported models from '''are GPT-4.1''' to '''and GPT-5.4''', presumably including any version in between. After Further, only the installation the Intelligent Atelier can be opened through:Azure OpenAI chat completion REST API is supported.* UBIK Studio [[File:ai-> Views api-> settings.png|thumb|right|350px|]]=== Accessibility ===The Intelligent Atelier, can be opened either as a Window or* as a Tab header Control. Use the "Magic Stick IconWand" ### Screenshots from * How toolbar menu icon or the "Intelligent Atelier" View-menu entry to open it looks when openedin a window, or right-click the tab header in the main working area to open the Intelligent Atelier as a tab control, using the respective context menu entry. * Where it can be opened[[File:intelligent-atelier-icon.png|thumb|right|350px|]][[File:intelligent-atelier-tab.png|thumb|right|350px|]]
== Usage ==
[[File:intelligent-atelier-control-areas.png|thumb|right|350px|]]# UI Elements=== Paradigm ===RequestThe general usage workflow is to enter and send a request, upon which the Intelligent Atelier creates a plan and works it off, providing the results.*Complex requests usually require a dialog to refine the results iteratively.Response=== Use-cases ===*The Intelligent Atelier supports the following use-cases:To* <b>Support</b>: Answer a {{UBIK}}-Do Listrelated question*<b>Concept</b>: Provide a functional or technical customizing conceptArtefacts* <b>Debugging</b>: Find a configuration error* <b>Bugfixing</b>: Fix a misconfiguration* <b>Prototyping</b>: Implement requirements=== Request ===# WorkflowIn the "Request" field (1.), the user can enter any prompt corresponding to a use-case listed above, and start processing using the Play-button. Open === Response ===Once the Intelligent Atelierhas come to a conclusion, it will output an answer in the "Response" field (2.).Describe This can take a while, because there is a lot of expert knowledge to process for the moddeling task you want or ask Atelier.Further, similarly to an interaction with a questioncoworker, complex requests usually require a dialog, with the user reviewing the (intermediate) results and providing follow-up instructions.Start === To-Do List ===For most non-trivial use-cases, the agent execution Intelligent Atelier establishes a plan in the form of a To-Do List (You are able 3.). Hover the items to pause inspect its notes in a tool-tip!=== Artefacts ===All relevant objects accessed, created or stop edited by the executionIntelligent Atelier are listed in the Artefacts area (4.)Response box shows you . These items can be dragged and dropped to most other {{UBIK}} Studio controls, including tab controls like the results Bulk Editor, Relation Editor or Object Explorer.=== Tips and tricks ===* Create a backup of the comment from database before starting an Atelier session.* To restart a session completely, close the AIIntelligent Atelier control or window and open a new one.ToDo list shows its progress Artefacts shown when * The quality of the progress results depends, amongst other factors, on the quality of the request. The clearer and more precise a prompt is done , the easier it is to process.* Ambiguity or something even contradiction are some of the most difficult obstacles for the Intelligent Atelier; the results are rarely satisfactory for requests with these properties.* Sometimes, the modelling gets off on the wrong foot. When things just don't work out, often it's best to restart with a new session.== Supported scope ==When this article was created, the Intelligent Atelier had an understanding of the following concepts:* Basic ER-models with MetaClasses, MetaProperties, References, Relations* Basic View Items (Relation, Reference, including the reverse cases)* MetaClass Scopes * Basic View configuration including explicit root objects* Not yet supported: Queries, Proxies, Plugin content like MRO, etc.
== Technical background ==
The Intelligent Atelier uses an agentic loop with a mixture-of-experts architecture on application level. An Azure OpenAI chat completions REST API is accessed in combination with a rich set of functions for tool-calls and elaborate system instructions to enable both a deep understanding of {{UBIK}} and an algorithm for processing complex requirements.
== See also ==
*[[Injection_Management|UBIK Plugin Injection]]
