You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: content/en/docs/appstore/use-content/platform-supported-content/modules/genai/using_genai/start_from_blank_app.md
+32-7Lines changed: 32 additions & 7 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -48,6 +48,8 @@ The [Blank GenAI App Template](https://marketplace.mendix.com/link/component/227
48
48
49
49
Selecting the infrastructure for integrating GenAI into your Mendix application is the first step. Depending on your use case and preferences, you can choose from the following options:
50
50
51
+
*[Mendix Cloud GenAI Resources Packs](/appstore/modules/genai/MxGenAI/): Part of the [Mendix Cloud GenAI Resources Packs](https://marketplace.mendix.com/link/component/229305), integrates LLMs by dragging and dropping common operations from its toolbox in Studio Pro.
52
+
51
53
*[OpenAI](/appstore/modules/genai/openai/): The [OpenAI Connector](https://marketplace.mendix.com/link/component/220472?_gl=1*1gbywo4*_gcl_au*NjUwMzI0NzA0LjE3MzI2MjkxMTI.) supports both OpenAI’s platform and Azure’s OpenAI service.
52
54
53
55
{{% alert color="info" %}}
@@ -116,6 +118,20 @@ You may encounter an error about allowed roles. To resolve this, go to the page
116
118
117
119
### Infrastructure Configuration
118
120
121
+
#### Mendix Cloud GenAI Configuration
122
+
123
+
Follow these steps to configure the Mendix Cloud GenAI Resources Packs for your application and for more background information, look at the [Mendix Cloud GenAI Configuration]() documentation:
124
+
125
+
1. Run the application locally.
126
+
127
+
2. Configure the Mendix Cloud GenAI Settings:
128
+
* In the chatbot-like application interface, go to **Administration** icon, and find the **Mendix Cloud GenAI Configuration**.
129
+
* Select **Import key** and paste the key from the Mendix Portal given to you.
130
+
131
+
3. Test the Configuration:
132
+
* Find the configuration you created, and select **Test Key** on the right side of the row.
133
+
* If an error occurs, check the **Mendix Console** for more details on resolving the issue.
134
+
119
135
#### OpenAI Configuration
120
136
121
137
Follow the steps below to configure OpenAI for your application. For more information, see the [Configuration](/appstore/modules/genai/openai/#configuration) section of the *OpenAI*.
@@ -124,21 +140,30 @@ Follow the steps below to configure OpenAI for your application. For more inform
124
140
125
141
2. Configure OpenAI Settings:
126
142
127
-
* In the chatbot-like application interface, go to the **Settings** ({{% icon name="cog" %}}) icon, and find the **OpenAI Configuration**.
143
+
* In the chatbot-like application interface, go to the **Administration** ({{% icon name="cog" %}}) icon, and find the **OpenAI Configuration**.
128
144
* Click **New** and provide the following details:
129
145
***Display Name**: A reference name to identify this configuration (for example, "My OpenAI Configuration").
130
146
***API Type**: Choose between **OpenAI** or **Azure OpenAI**.
131
147
***Endpoint**: Enter the endpoint URL for your selected API type.
132
-
***Token**: Provide the API key for authentication.
133
-
* If using Azure OpenAI, add:
134
-
***Deployment Name**: Specify the deployed model (for example, *gpt-4o*, *gpt-3.5-turbo*, etc.)
135
-
***API Version**: Provide the version of the API you are using (for example, *2024-06-01*, *2024-10-21*, etc.)
148
+
***API key**: Provide the API key for authentication.
149
+
* If using Azure OpenAI, add the **Azure key type** by choosing between **OpenAI** or **Azure OpenAI**.
150
+
151
+
* After saving the changes, a new pop-up will appear to add the deployment models. Select **Add deployed model** and provide the following details (optional for the OpenAI API Type):
152
+
***Display name**: A reference name for the deployed model (e.g., "GPT-4 Conversational").
153
+
***Deployment Name**: Specify the deployed model (for example, *gpt-4o*, *gpt-3.5-turbo*, etc.)
154
+
***Output modality**: Indicate the type of output (e.g., Text, Embeddings, Image).
155
+
***Support system prompt**: Indicate whether the model supports system prompts.
156
+
***Support conversations with history**: Indicate whether the model can remember and utilize previous interactions in a conversation by referring back to earlier messages in the chat.
157
+
***Support function calling**: Indicate whether the model can invoke different functions during the conversation based on the user input.
158
+
***Azure API Version**: Provide the version of the API you are using (for example, *2024-06-01*, *2024-10-21*, etc.)
159
+
***Is active**: Indicate whether the deployment model should be active to be used in the app.
136
160
137
161
* Click **Save** to store your configuration.
138
162
139
163
3. Test the Configuration:
140
164
141
-
* Select the configuration you created, and click **Test Configuration**.
165
+
* Find the configuration you created, click the three dots on the right side, and select **Test**.
166
+
* In the **Test configuration**, select the deployed model and press **Test**.
142
167
* If an error occurs, check the **Mendix Console** for more details on resolving the issue.
143
168
144
169
#### Bedrock Configuration
@@ -171,7 +196,7 @@ If you encounter any issues while using the Amazon Bedrock connector, see the [T
171
196
172
197
## Testing and Troubleshooting
173
198
174
-
Before testing your app, complete the OpenAI or Bedrock configuration.
199
+
Before testing your app, complete the Mendix Cloud GenAI, OpenAI or Bedrock configuration.
175
200
176
201
To test the Chatbot, navigate to the **Home** icon to open the chatbot interface. Start interacting with your chatbot by typing in the chat box.
0 commit comments