AI configuration at a glance
AI Configuration controls the AI provider and response preferences used by Atloria's AI documentation engine. The surface lets you choose a default provider, set response length and randomness, control streaming, and save a copy of the settings.
| If you need to… | Go to |
|---|---|
| Choose which provider handles AI operations | Configure the provider and AI settings |
| Adjust response length or randomness | Configure the provider and AI settings |
| Understand the tabs and available controls | Understand the configuration surface |
| Recover from an unavailable provider or import failure | When configuration goes wrong |
| Read the wider AI Configuration reference | AI configuration reference |
| Read the wider AI workspace overview | AI Configuration overview |
Before you start
Before changing a setting, have access to the AI Configuration route and know which provider your organization intends to use.
Prerequisites
- Know the provider you want to make the default.
- Have the JSON settings file available if you plan to import settings.
- Be ready to check the provider's availability before testing its connection.
The provider list and the initial setting values depend on the environment and the saved browser settings. Check the values shown on screen before changing them.
Open AI Configuration
Use the AI settings route to reach the configuration surface.
Prerequisites
- You have access to the Atloria application.
Steps
- Open AI Configuration in Atloria.
Result: The AI Configuration surface is open.
Understand the configuration surface
AI Configuration groups provider selection and advanced response preferences into separate tabs.
The tabs are:
| If you need to… | Select |
|---|---|
| Choose or test an AI provider | Providers |
| View current-month AI usage | Usage |
| Review recent AI requests | History |
| Change response preferences or manage settings files | Settings |
The Providers tab shows one provider choice for each provider returned to the surface. The selected choice is the default provider. Each provider also has a Test Connection control; that control is disabled while the provider is unavailable or while its test is running.
The Settings tab contains these controls:
| Control | What it changes |
|---|---|
| Max Tokens | The maximum number of tokens generated in a response. |
| Temperature | The randomness of AI responses. |
| Enable Streaming | Whether responses stream in real time. |
| Auto-Save Settings | Whether changes are saved automatically to browser storage. |
| 📥 Export Settings | Downloads the current settings as JSON. |
| 📤 Import Settings | Opens a file chooser for a JSON settings file. |
| 🔄 Reset to Defaults | Replaces the current settings with the default settings. |
Prompts is not one of the available tabs. The page does not provide required markers or
validation rules for these configuration fields, and it does not provide a separate save button.
Configure the provider and AI settings
Use this procedure when you need to select the provider or change how AI responses are generated.
Prerequisites
- You are on the AI Configuration surface.
- The provider you want to use appears in Providers.
Steps
- Select Providers.
- Select the radio control beside the provider you want to make the default.
- Select Test Connection for that provider.
- Select Settings.
- Set Max Tokens within the displayed range from
100to4000in increments of100. - Set Temperature within the displayed range from
0to1in increments of0.1. - Select or clear Enable Streaming.
- Select or clear Auto-Save Settings.
Changes are saved to browser storage when you change a setting; no separate save control is provided.
Result: The selected provider and the changed response preferences remain displayed on the configuration surface.
Handle provider and settings branches
The provider branch you see depends on the provider list and its availability. The settings branch you see depends on whether an imported file can be read as JSON.
| If you see… | Do this |
|---|---|
No AI providers configured. and Please configure your environment variables. | Arrange for the required provider configuration, then return to Providers. |
● Unavailable | Choose an available provider before selecting Test Connection. |
Testing... | Wait for the test to finish. |
● Available | The provider is available for testing. |
✓ Test Passed | Continue with the provider as the default choice if it is the provider you need. |
✗ Test Failed | Choose another available provider or correct the provider configuration before trying again. |
| A settings file is ready to use | Select 📤 Import Settings, then choose the JSON file. |
| You need to discard the current settings | Select 🔄 Reset to Defaults. |
Result: The surface displays the provider state or import/reset outcome associated with the action you selected. If a message indicates an error, use the troubleshooting table next.
When configuration goes wrong
Use the message on screen to choose the matching recovery action.
| What you see | Meaning | What to do |
|---|---|---|
Failed to import settings: | The error detail follows this fixed text. | Select 📤 Import Settings and choose a valid JSON settings file. |
Invalid settings file | The selected file could not be parsed as settings JSON. | Select 📤 Import Settings and choose a valid JSON settings file. |
Failed to read file | The file could not be read. | Select 📤 Import Settings and choose a readable JSON settings file. |
Failed to load AI settings: | The browser could not load saved AI settings. | Reload the AI Configuration surface. |
Failed to save AI settings: | The browser could not save the changed AI settings. | Retry the change on the AI Configuration surface. |
Failed to reset AI settings: | The browser could not reset the saved AI settings. | Retry 🔄 Reset to Defaults. |
The route can also display 404 instead of the configuration surface. In that case, the AI
configuration controls are not available on the screen.
Result: You have matched the message on screen to its recovery action and can confirm the configuration outcome in the next section.
After you configure AI
After changing a setting, check the selected provider and displayed values on the Settings tab. Use 📥 Export Settings if you need a portable copy of the browser-stored settings.
For related guidance, continue to AI Configuration overview or AI configuration reference.
Result: The configuration surface shows the provider and response preferences you selected.
Was this page helpful?