1. Latest Release Home
  2. Guides
  3. Concepts
  4. Tools
    1. AI App Manager
    2. Alert Editor
    3. Alias Sync Tool
    4. Analyzer
    5. Apache Parquet Merge Tool
    6. Avro Extractor Tool
    7. Business Schema Designer
    8. Business Schema Manager
    9. Cluster Management Console
    10. CMC Logs Manager
    11. CMC Monitoring
    12. CMC Patch Manager
    13. CMC Scheduler
    14. CMC Tenant Manager
    15. Command Line Interface
    16. Content Manager
    17. Dashboard Filters Manager
    18. Dashboard Manager
    19. Data Agent
    20. Data APIs for External Notebooks
    21. Data Lineage Viewer v2
    22. Data Manager
    23. Data Studio Manager
    24. Formula Builder
    25. Inspector Tool
    26. Join Editor
    27. Load Job Details Viewer
    28. Load Plan DAG Viewer
    29. Model Update Viewer
    30. Notebook Editor
    31. Profile Manager
    32. Public API
    33. Query Plan Viewer
    34. Scheduler
    35. Schema Designer
    36. Schema Diagram Viewer
    37. Schema Manager
    38. Schema Version Compare
    39. Schema Wizard
    40. Security Manager
    41. Spark Issue Detector
    42. Table Editor
    43. Tenant Management Tool
    44. Upload Service Command Line Interface (CLI)
    45. Versioning Migration Tool
  5. References
  6. Integrations
  7. Data applications
  8. Data Governance
  9. Release Notes
  10. Incorta Premium
  11. Release Support Policy
  12. Release Model

Tools → AI App Manager

About

The AI App Manager allows users with the appropriate role to create, manage, and interact with AI Apps within an Incorta tenant. The AI App Manager has two views: Your Applications for App Managers who build and publish apps, and a filtered published-apps view for App Viewers who access and use published apps.

Access requirement

AI Apps must be enabled for your tenant before the AI App Manager is accessible. Contact your Incorta Account Executive to enable AI Apps.

Important: Target persona

The initial version of AI Apps is targeted at developers or technically proficient users who can write, understand, and maintain code. While the AI-assisted development kit accelerates development by connecting a coding agent to live MCP tools, platform rules, and templates, it is designed to support someone able to review, debug, and maintain the generated code, not to serve as a no-code/low-code solution for non-technical business users.

Important: Scope of support

This release provides managed connectivity between user apps and Incorta. The platform is responsible for establishing and maintaining that connection. It does not include troubleshooting or repairing user app code; building, testing, and maintaining the app remains part of the app developer’s workflow.

To access the AI App Manager, in the Navigation pane, select AI Apps.

AI App Manager access

The following are the roles of users who have access to the AI App Manager.

RoleAccess
App ManagerFull access to all apps, including lifecycle states (Draft, Live, Down) and the app editor. Can create, import, edit, preview, publish, and delete apps.
App ViewerAccess to published (Live) apps only. Can open and interact with published apps. Does not have access to Draft apps or the editor.

Contact the Incorta Support Team to specify the Incorta user roles that have access as managers or viewers.

AI App Manager anatomy

The AI App Manager consists mainly of the following:

  • Your Applications page
  • App editor
  • Create App dialog
  • Scanning Report dialog
  • Secrets dialog

Your Applications page

The Your Applications page is the main view for the AI App Manager. While it displays all apps if the signed-in user is an App Manager, it displays only published apps to App Viewers.

The Your Applications page consists of the following:

Action bar

ControlDescription
Build Apps with AIOpens the Build Apps with AI dialog, which contains a copyable terminal command to set up or update the AI development kit and to connect a coding agent to live MCP tools, platform rules, and templates for building apps
+ Create AppOpens the Create App dialog to begin creating a new AI App

Search and filter bar

ControlDescription
Search apps...Searches app names and descriptions in the current view
Sort by listSorts the app card list by the most recently modified app, created app, or alphabetically
Filter iconFilters the list by app status or framework
Grid / List toggleSwitches the list view between card grid and list layout
Item countDisplays the total number of apps in the current view, in addition to the number of items that match the applied filter, if any

App cards

Each app appears as a card showing:

PropertyDescription
App iconIndicates the framework
App nameThe name of the AI App
Status badgeA colored pill showing the current lifecycle state: Live (green), Draft (yellow), Down (red)
DescriptionA short description of the app, if any
OwnerThe login name of the App author who created the app
Last updatedRelative timestamp of the last modification
OpenOpens the published app in a new tab. Only visible for live apps
More options (⋮)Opens a context menu with additional actions, including Unpublish, Manage Secrets, and Delete

App Editor

The app editor opens when an App Manager creates or edits an AI App. The editor is split into three panels, in addition to the versions panel.

Action bar

ControlDescription
BreadcrumbShows the current app name and version (for example, Applications › demo app › v1), in addition to the unsaved tag if the app contains unsaved changes
Security scan statusIndicates the current security scan status:
  ●  Unscanned: The code has not yet been scanned.
  ●  Clean: The last scan passed, even if there may be non-critical issues.
  ●  Scan failed: The last security scan found blocking issues.
PreviewStarts a new temporary preview session. The app runs for up to one hour and is accessible only to the App managers.
StartingIndicates that the preview session is starting
Restart previewRestarts the running preview session without triggering a publish.
PublishTriggers the security scan and, if the scan passes, publishes the app to make it accessible to all App viewers. A new URL is created, other than the preview one, accessible by all App viewers. Publishing a new version of the app replaces the old published version with the same URL. The URL follows this format: <cluster_url>/data-apps/my-apps/<tenant>/<app-name>/
Publish menu > Run security scanChecks the code for security issues
Publish menu > View scan reportOpens the Scanning Report dialog to display the scan results
Publish menu > EditForks a new draft of the published app to edit it without interrupting other users. When publishing this draft, the new updates will be available to all users without changes in the App URL. This option is available for published apps, whether live or down.
Publish menu > UnpublishUnpublishes the app
History iconOpens the app versions panel
More options icon (⋮)Opens a context menu with the Manage Secrets option

Explorer panel

The Explorer panel shows the file tree for the current app. It contains:

ControlDescription
File treeLists all files in the app, including app.py (entry point) and requirements.txt. The active file is highlighted.
New file iconCreates a new file in the app
Import code iconOpens the Import code dialog. You can upload a folder or a .zip file. The code you upload replaces all files in your current draft.
Code Snippets iconOpens the Code Snippets dialog to copy or insert code snippets that come with the release. Sample code snippets include code to connect to Incorta, query Incorta, create charts, and read secrets.

Code editor panel

The code editor panel occupies the main area of the App editor page.

Preview panel

The preview panel renders the running app alongside the code editor. When a preview is running, the panel shows the following:

ControlDescription
Refresh iconRefreshes the preview pane
URLA live URL for the preview session in the following format: <cluster_url>/data-apps/my-apps/test/<tenant>/<app-name>/<version>/
External link iconOpens the preview in a full browser tab
More options icon (⋮)Includes options to report a bug or ask for help by contacting the Support team

Versions panel

The version panel appears when you select the history icon. It displays the different app versions. The versions panel shows the following:

  • The version number
  • The version creator
  • The version creation date and time

The versions list contains a contextual menu with the following options:

OptionDescription
PreviewStarts a new temporary preview session
PublishTriggers the security scan and, if the scan passes, publishes the app to make it accessible to all App viewers. Publishing a new version of the app replaces the old published version.
UnpublishUnpublishes the live version
Open appOpens the app preview session if one is available
DownloadDownloads the app code
View scan reportOpens the Scanning Report dialog to display the scan results

Create App dialog

The Create App dialog opens when you select + Create App.

FieldDescription
Name (required)The display name of the AI App
DescriptionAn optional short description of what the app does
FrameworkThe app framework. For the initial release, AI Apps supports Streamlit as the application authoring framework, as well as a custom full-stack framework that includes Python FastAPI and JavaScript.

Scanning Report dialog

The Scanning Report dialog opens automatically when you select Publish. It runs while displaying the scanning animation, then shows results.

CheckDescription
Incorta importEnsures the entry point imports the Incorta SDK so branding is enforced
Entry pointVerifies that the expected entry point file exists in the root directory
Python requirementsChecks that a Python requirements.txt is present so pip packages can be installed.
File extensionsChecks that all files use supported extensions Refuses executable/script files in the upload (only the entry point is ever run).
Bandit security scanRuns static analysis to detect security vulnerabilities in the Python code, such as SQL injection vectors
pip-audit dependency scanScans requirements.txt for known CVEs using pip-audit

The overall result banner shows one of: Passed, Passed with warnings, or a blocking failure state.

ResultBadge colorEffect
PassedGreenCheck passed with no issues.
WarningOrangeNon-blocking finding. Publishing can proceed.
FailedRedPublishing is blocked until the issue is resolved.

Secrets dialog

This dialog appears when you select Manage secrets, allowing you to add secrets as key-value pairs. Secrets apply to the entire app, and every version can read them. Once saved, a secret's value is hidden and cannot be viewed again; however, you can still replace the value or delete the whole entry.

AI App Manager Actions

Create an app and write code in the editor

Use this approach when you want to write your code directly inside Incorta.

  1. In the Navigation bar, select AI Apps.
  2. In the Your Applications page, select + Create App.
  3. In the Create App dialog, enter a Name and optionally a Description.
  4. In the Framework drop-down list, select the framework to use for your app.
  5. Select Create. The app opens in the editor in Draft state.
  6. In the code editor, write your application code directly.
    • Optionally, copy or insert code snippets from the available built-in samples.
  7. To test your app, select Preview in the toolbar.
  8. When your app is ready to publish, select Publish.
  9. In the confirmation dialog, select Publish to proceed.
  10. Incorta runs an automated Scanning Report. Review the results:
    • If the scan shows Passed or Passed with warnings, select Confirm to complete publishing.
    • If the scan shows blocking failures, resolve each finding and select Publish again.
  11. After publishing, the app status changes to Live and is accessible to all App Viewers at a stable URL.

Import an existing app

Use this approach when you have an existing application on your local machine and want to import it into Incorta without rewriting it in the editor.

  1. In the Navigation bar, select AI Apps.

  2. Select + Create App, enter a Name, and select Create.

  3. In the editor toolbar, select the Import code icon (upload arrow).

  4. In the Import code dialog, drag and drop a .zip file or your app folder onto the upload area, or select Upload a folder instead to browse for a folder.

    Import warning

    The uploaded code replaces any existing code in the current draft.

  5. Confirm the folder name and file count shown in the dialog, then select Import.

  6. Review and adjust the imported code in the editor as needed.

  7. Select Preview to test, then Publish when ready.

Update a published app

When you want to update a published app without affecting the current live version, fork a draft and edit it as required:

  1. In Your Applications, locate the published app and select the app card to open it in the App Editor. Incorta opens the editor on the current draft. The breadcrumb shows the version number.
  2. Select the arrow next to the Publish button, and then select Edit. A new draft is created.
  3. Make your changes in the editor.
  4. Select Preview to test the updated version.
  5. When the update is ready, select Publish. In the confirmation dialog, select Publish to proceed through the security scan.
  6. After the scan passes, the new version replaces the previous published version at the same URL. App Viewers experience no change in the app address.

Build apps with AI assistance

AI Apps includes an AI-assisted development kit that accelerates local app development. App Managers can connect a coding agent, like Claude Code, to the platform via a simple install command, giving it access to live MCP tools, platform rules, and working templates to help write app code.

Here are the steps to set up or update the kit

  1. In the Navigation bar, select AI Apps.
  2. Select Build Apps with AI.
  3. In the Build Apps with AI dialog, select the Copy install command button.
  4. Paste the command in your terminal window, and start using it to help build AI Apps.
Responsibility for AI-generated code

Exercise caution! Using the copied command lets your coding agent act on the platform as you. The AI dev kit generates code as a starting point.
You are responsible for reviewing, testing, and ensuring the security and correctness of any AI-generated code before publishing.