From 19cad2573504edadffb3d3b2b7ebdb2607cc87db Mon Sep 17 00:00:00 2001 From: katarzyna_koltun Date: Wed, 3 Jun 2026 13:40:35 +0200 Subject: [PATCH 1/3] ConvUI Bridge --- .../snowflake/snowflake-convui-bridge.md | 58 +++++++++++++++++++ 1 file changed, 58 insertions(+) create mode 100644 content/en/docs/marketplace/platform-supported-content/modules/snowflake/snowflake-convui-bridge.md diff --git a/content/en/docs/marketplace/platform-supported-content/modules/snowflake/snowflake-convui-bridge.md b/content/en/docs/marketplace/platform-supported-content/modules/snowflake/snowflake-convui-bridge.md new file mode 100644 index 00000000000..67864b12237 --- /dev/null +++ b/content/en/docs/marketplace/platform-supported-content/modules/snowflake/snowflake-convui-bridge.md @@ -0,0 +1,58 @@ +--- +title: "Snowflake ConversationalUI Bridge" +url: /appstore/connectors/snowflake/snowflake-conversationalui-bridge/ +description: "Describes the configuration and usage of the Mendix-Snowflake AI Data Connector from the Mendix Marketplace." +weight: 20 +#If moving or renaming this doc file, implement a temporary redirect and let the respective team know they should update the URL in the product. See Mapping to Products for more details. +--- + +## Introduction + +The [Snowflake ConversationalUI Bridge module](https://marketplace.mendix.com/link/component/225717) provides a way to implement the Conversational UI for Snowflake Cortex Analyst. + +### Typical Use Cases + +When using the Snowflake AI Data Connector and want to implement Conversational UI for Snowflake Cortex Analyst one can use the SnowflakeConversational UI Bridge module to easily implement Conversational UI for Cortex Analyst. + +* Authentication: + + * Authentication with an RSA key pair according to PKCS #8 standard + * Authentication with OAUTH through an OIDC provider or PAT -> You will need to add your OAuth token or PAT and optionally its expiration date to the BearerToken created in the "ChatCompletions_CallLLM" microflow. + +* Functionality: Easily implement chat interfaces for Cortex Analyst using Conversational UI: + + * Test page "SnowflakeConfig_TestingPage" for the different chat interfaces provided by conversational UI. Acts a a quick testing page and an Example of how one could set up a chat interface for Cortex Analyst using ConversationalUI. Simply add the page to your project navigation and start exploring. + * CortexAnalystDeployedModel overview page "CortexAnalystDeployedModel_Overview". Used to configure your Contex Analyst implementations by creating CortexAnalystDeployedModels. Needs SnowflakeAIDataConnector.ConnectionDetails object. + * Snippet for Cortex Analyst Model configuration page 'Snippet_ModelConfig'. Needs SnowflakeAIDataConnector.ConnectionDetails object. + * Example page "FullScreenChat_HistoryAndProviderSelection" for full screen chat with history bar and provider selection. + * Action Microflow: 'ChatCompletions_CallLLM' for the "CortexAnalystDeployedModel" which is set in 'CortexAnalystDeployedModel_Create'. Handels calls to Cortex Analyst and maps GenAICommons request to Cortex Analyst request and Cortex Analyst response to GenAICommons response. + * Action Microflow: 'ChatContext_ChatWithHistory_ActionMicroflow' for the "ConversationalUI.ProviderConfig" which is set in 'SnowflakeConversationalUIBridge.ProviderConfig_GetCreate'. Does some pre and post processing creating Conversational UI Messages, References, etc. + + +### Prerequisites {#prerequisites} + +The Snowflake Conversational UI Bridge Module requires Mendix Studio Pro version 10.24.13 or above. + +To use the Snowflake Conversational UI Bridge Module, you must also install and configure the following modules from the Mendix marketplace: + +* [Snowflake AI Data Connector](https://marketplace.mendix.com/link/component/225717) – This module and its dependencies are a required dependency for Snowflake Conversational UI Bridge Module. +* [Conversational UI](https://marketplace.mendix.com/link/component/239450) – This module and its dependencies are a required dependency for Snowflake Conversational UI Bridge Module. + +### Licensing and Cost + +This connector is available as a free download from the Mendix Marketplace, but the services in Snowflake to which is connects may incur a usage cost. For more information, refer to the [Snowflake documentation](https://www.snowflake.com/en/data-cloud/pricing-options/). + +Depending on your use case, your deployment environment, and the type of app that you want to build, you may also need a license for your Mendix app. For more information, refer to [Licensing Apps](/developerportal/deploy/licensing-apps-outside-mxcloud/). + +## Installation + +Follow the instructions in [How to Use Marketplace Content in Studio Pro](/appstore/general/app-store-content/) to import the Snowflake Conversational UI Bridge module into your app. + +## Configuration + +After you install the Snowflake Conversational UI Bridge Module, you can find it in the **App Explorer**, in the **Marketplace modules** section. The connector provides a domain model and several Action microflows and snippets that you can use. + + +### Example Implementation + + The [Snowflake showcase app](https://marketplace.mendix.com/link/component/225845) contains example implementations of the Cortex Analyst Conversational UI chat implementations.For more information, see [Snowflake Cortex Analyst](/appstore/modules/genai/snowflake-cortex/#functionalities). \ No newline at end of file From d21b66c8f3f1260fa390bafa1a2feebd2b938328 Mon Sep 17 00:00:00 2001 From: katarzyna_koltun Date: Thu, 4 Jun 2026 17:50:57 +0200 Subject: [PATCH 2/3] draft --- .../snowflake/snowflake-convui-bridge.md | 51 ++++++++++--------- 1 file changed, 26 insertions(+), 25 deletions(-) diff --git a/content/en/docs/marketplace/platform-supported-content/modules/snowflake/snowflake-convui-bridge.md b/content/en/docs/marketplace/platform-supported-content/modules/snowflake/snowflake-convui-bridge.md index 67864b12237..479f5907abb 100644 --- a/content/en/docs/marketplace/platform-supported-content/modules/snowflake/snowflake-convui-bridge.md +++ b/content/en/docs/marketplace/platform-supported-content/modules/snowflake/snowflake-convui-bridge.md @@ -8,28 +8,9 @@ weight: 20 ## Introduction -The [Snowflake ConversationalUI Bridge module](https://marketplace.mendix.com/link/component/225717) provides a way to implement the Conversational UI for Snowflake Cortex Analyst. +The [Snowflake ConversationalUI Bridge module](https://marketplace.mendix.com/link/component/202837) provides a way to easily implement the Conversational UI for Snowflake Cortex Analyst when using the Snowflake AI Data Connector. -### Typical Use Cases - -When using the Snowflake AI Data Connector and want to implement Conversational UI for Snowflake Cortex Analyst one can use the SnowflakeConversational UI Bridge module to easily implement Conversational UI for Cortex Analyst. - -* Authentication: - - * Authentication with an RSA key pair according to PKCS #8 standard - * Authentication with OAUTH through an OIDC provider or PAT -> You will need to add your OAuth token or PAT and optionally its expiration date to the BearerToken created in the "ChatCompletions_CallLLM" microflow. - -* Functionality: Easily implement chat interfaces for Cortex Analyst using Conversational UI: - - * Test page "SnowflakeConfig_TestingPage" for the different chat interfaces provided by conversational UI. Acts a a quick testing page and an Example of how one could set up a chat interface for Cortex Analyst using ConversationalUI. Simply add the page to your project navigation and start exploring. - * CortexAnalystDeployedModel overview page "CortexAnalystDeployedModel_Overview". Used to configure your Contex Analyst implementations by creating CortexAnalystDeployedModels. Needs SnowflakeAIDataConnector.ConnectionDetails object. - * Snippet for Cortex Analyst Model configuration page 'Snippet_ModelConfig'. Needs SnowflakeAIDataConnector.ConnectionDetails object. - * Example page "FullScreenChat_HistoryAndProviderSelection" for full screen chat with history bar and provider selection. - * Action Microflow: 'ChatCompletions_CallLLM' for the "CortexAnalystDeployedModel" which is set in 'CortexAnalystDeployedModel_Create'. Handels calls to Cortex Analyst and maps GenAICommons request to Cortex Analyst request and Cortex Analyst response to GenAICommons response. - * Action Microflow: 'ChatContext_ChatWithHistory_ActionMicroflow' for the "ConversationalUI.ProviderConfig" which is set in 'SnowflakeConversationalUIBridge.ProviderConfig_GetCreate'. Does some pre and post processing creating Conversational UI Messages, References, etc. - - -### Prerequisites {#prerequisites} +## Prerequisites {#prerequisites} The Snowflake Conversational UI Bridge Module requires Mendix Studio Pro version 10.24.13 or above. @@ -38,7 +19,7 @@ To use the Snowflake Conversational UI Bridge Module, you must also install and * [Snowflake AI Data Connector](https://marketplace.mendix.com/link/component/225717) – This module and its dependencies are a required dependency for Snowflake Conversational UI Bridge Module. * [Conversational UI](https://marketplace.mendix.com/link/component/239450) – This module and its dependencies are a required dependency for Snowflake Conversational UI Bridge Module. -### Licensing and Cost +## Licensing and Cost This connector is available as a free download from the Mendix Marketplace, but the services in Snowflake to which is connects may incur a usage cost. For more information, refer to the [Snowflake documentation](https://www.snowflake.com/en/data-cloud/pricing-options/). @@ -48,11 +29,31 @@ Depending on your use case, your deployment environment, and the type of app tha Follow the instructions in [How to Use Marketplace Content in Studio Pro](/appstore/general/app-store-content/) to import the Snowflake Conversational UI Bridge module into your app. +## Authentication + +* Authentication with an RSA key pair according to PKCS #8 standard +* Authentication with OAUTH through an OIDC provider or PAT. You must add your OAuth token or PAT and optionally its expiration date to the BearerToken created in the **ChatCompletions_CallLLM** microflow. + ## Configuration -After you install the Snowflake Conversational UI Bridge Module, you can find it in the **App Explorer**, in the **Marketplace modules** section. The connector provides a domain model and several Action microflows and snippets that you can use. +After you install the Snowflake Conversational UI Bridge Module, you can find it in the **App Explorer**, in the **Marketplace modules** section. The connector provides a domain model as well as several action microflows and snippets that you can use. + +### Functionality + +Easily implement chat interfaces for Cortex Analyst using Conversational UI with the help of the following features. + +#### Pages + +* The **SnowflakeConfig_TestingPage** page is a quick testing page for the different chat interfaces provided by conversational UI, as well as an example of how you can set up a chat interface for Cortex Analyst using ConversationalUI. To use it, add the page to your project navigation and start exploring. +* The **CortexAnalystDeployedModel_Overview** overview page is used to configure your Contex Analyst implementations by creating `CortexAnalystDeployedModels`. The page requires a `SnowflakeAIDataConnector.ConnectionDetails` object. +* The **Snippet_ModelConfig** snippet for the Cortex Analyst Model configuration page. The page requires a `SnowflakeAIDataConnector.ConnectionDetails` object. +* The **FullScreenChat_HistoryAndProviderSelection** page is an example of a full screen chat with a History bar and provider selection. + +#### Microflows +* The **ChatCompletions_CallLLM** action microflow for **CortexAnalystDeployedModel**, set in **CortexAnalystDeployedModel_Create**, handles calls to Cortex Analyst and maps GenAICommons requests and responses to Cortex Analyst requests and responses. +* The **ChatContext_ChatWithHistory** action microflow for **ConversationalUI.ProviderConfig**, set in **SnowflakeConversationalUIBridge.ProviderConfig_GetCreate**, handles pre- and post-processing for the creation of Conversational UI messages, references, and other objects. -### Example Implementation +## Example Implementation - The [Snowflake showcase app](https://marketplace.mendix.com/link/component/225845) contains example implementations of the Cortex Analyst Conversational UI chat implementations.For more information, see [Snowflake Cortex Analyst](/appstore/modules/genai/snowflake-cortex/#functionalities). \ No newline at end of file + The [Snowflake showcase app](https://marketplace.mendix.com/link/component/225845) contains an example implementation of the Cortex Analyst Conversational UI.For more information, see [Snowflake Cortex Analyst](/appstore/modules/genai/snowflake-cortex/#functionalities). \ No newline at end of file From b1cbbaed3052170aec57517cc562cc31f6ff85b2 Mon Sep 17 00:00:00 2001 From: katarzyna-koltun-mx <108737161+katarzyna-koltun-mx@users.noreply.github.com> Date: Thu, 4 Jun 2026 18:13:52 +0200 Subject: [PATCH 3/3] Update snowflake-convui-bridge.md --- .../modules/snowflake/snowflake-convui-bridge.md | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/content/en/docs/marketplace/platform-supported-content/modules/snowflake/snowflake-convui-bridge.md b/content/en/docs/marketplace/platform-supported-content/modules/snowflake/snowflake-convui-bridge.md index 479f5907abb..7c398048e01 100644 --- a/content/en/docs/marketplace/platform-supported-content/modules/snowflake/snowflake-convui-bridge.md +++ b/content/en/docs/marketplace/platform-supported-content/modules/snowflake/snowflake-convui-bridge.md @@ -51,9 +51,9 @@ Easily implement chat interfaces for Cortex Analyst using Conversational UI with #### Microflows -* The **ChatCompletions_CallLLM** action microflow for **CortexAnalystDeployedModel**, set in **CortexAnalystDeployedModel_Create**, handles calls to Cortex Analyst and maps GenAICommons requests and responses to Cortex Analyst requests and responses. -* The **ChatContext_ChatWithHistory** action microflow for **ConversationalUI.ProviderConfig**, set in **SnowflakeConversationalUIBridge.ProviderConfig_GetCreate**, handles pre- and post-processing for the creation of Conversational UI messages, references, and other objects. +* The **ChatCompletions_CallLLM** action microflow for **CortexAnalystDeployedModel**, used in **CortexAnalystDeployedModel_Create**, handles calls to Cortex Analyst and maps GenAICommons requests and responses to Cortex Analyst requests and responses. +* The **ChatContext_ChatWithHistory** action microflow for **ConversationalUI.ProviderConfig**, used in **SnowflakeConversationalUIBridge.ProviderConfig_GetCreate**, handles pre- and post-processing for the creation of Conversational UI messages, references, and other objects. ## Example Implementation - The [Snowflake showcase app](https://marketplace.mendix.com/link/component/225845) contains an example implementation of the Cortex Analyst Conversational UI.For more information, see [Snowflake Cortex Analyst](/appstore/modules/genai/snowflake-cortex/#functionalities). \ No newline at end of file + The [Snowflake showcase app](https://marketplace.mendix.com/link/component/225845) contains an example implementation of the Cortex Analyst Conversational UI.For more information, see [Snowflake Cortex Analyst](/appstore/modules/genai/snowflake-cortex/#functionalities).