## Opening the AI Providers Settings
Before you change any AI provider settings in Atloria, make sure you have **Project Administrator** access for the workspace you are managing. AI provider settings affect how AI-powered features work across the project, so this is not something regular contributors should change casually in a shared documentation workspace.

In Atloria, open your project or administration area and go to the screen where **AI provider settings** are managed. If your team also uses broader AI controls, you may want to review related guidance in [Configuring AI Settings for Your Organization](doc:configuring-ai-settings-for-your-organization) and [Managing Organization and Admin Settings](doc:managing-organization-and-admin-settings). Once you reach the AI provider screen, look for three main parts of the page:

- A **provider list** showing the AI providers already configured
- A **settings form** where you can view or edit provider details
- Action controls such as **Import**, **Export**, and **Reset**

[SCREENSHOT: AI Providers settings page showing the provider list, settings form, and Import, Export, and Reset actions]

Take a moment to review what is already there before you add or change anything. This matters most when several administrators share responsibility for the same project. A provider may already be active, a previous import may have added multiple entries, or someone may have adjusted connection details for a specific documentation workflow.

If you skip this review, you can easily overwrite a working setup with incomplete details. Start by checking the provider list, then open the current entry and read through the visible fields before making edits. That quick review helps you understand whether you are updating an existing setup, replacing an older one, or preparing to add another provider alongside the current one.

## Reviewing Current Provider Configuration
On the AI Providers screen, begin with the **current provider list**. This list shows which provider entries already exist in the project. If your team has tested more than one AI service, you may see several entries instead of just one. Review each visible entry name carefully so you do not create a duplicate with slightly different details.

After selecting a provider, inspect the fields shown in the settings area. Atloria may display details such as the provider name, a connection address such as a **base URL** or **endpoint**, model-related options, and authentication values. If any credential fields are hidden or masked, that usually means a value is already stored. Treat masked values as a sign that the provider was previously configured, even if you cannot see the full value on screen.

Use the current configuration view to answer these questions before editing:

- Which providers are already available?
- Which one appears to be the active or default choice for AI features?
- Do the visible values look like a standard setup, a custom setup, or an imported configuration?
- Have recent changes already been made by another administrator?

A quick review is especially helpful after an **Import** or **Reset** action. Imported settings may add or replace several provider entries at once, while a reset may remove custom values and return fields to a simpler state. If you are unsure whether the current setup is intentional, compare what you see on screen with your team’s expected provider list before saving any changes.

[SCREENSHOT: Selected provider entry with visible fields such as provider name, base URL, model options, and masked credentials]

If you need a broader understanding of how AI features are being used in your workspace, related documents such as [Monitoring AI Usage and Request History](doc:monitoring-ai-usage-and-request-history) and [Creating and Managing AI Support Agents](doc:creating-and-managing-ai-support-agents) can help you connect provider settings to day-to-day use.

## Configuring and Updating AI Providers
Once you have reviewed the current setup, you can update an existing provider or add another one from the AI Providers page.

1. Open the **AI Providers** settings screen and select an existing provider from the list, or choose the option to add a new provider if one is available on the page.
2. In the provider form, enter or update the fields shown by Atloria. These typically include the **provider name or identifier**, connection details such as a **base URL** or **endpoint**, model-related settings, and any credential fields required for access.
3. Review each field before saving. Pay close attention to connection details and credential entries, since small mistakes in these fields can stop AI features from working correctly.
4. Click **Save** to apply your changes.
5. Watch for the page to reflect the update. In Atloria, this may appear as the updated provider remaining in the list, the edited values reappearing when you reopen the entry, or the intended provider showing as the selected option.

[SCREENSHOT: Editing a provider entry and clicking Save]

If your project needs more than one AI backend, repeat the same process for each provider entry. For example, your team may keep one provider for general documentation generation and another for testing or specialized workflows. The important part is keeping each entry clearly named so administrators can tell them apart in the list.

When updating an existing provider, avoid changing several entries at once unless you are working from a verified configuration. It is easier to confirm one successful change at a time than to troubleshoot multiple edits later. If your workspace relies heavily on AI-generated content, you may also want to review [Setting Up and Maintaining AI Providers](doc:setting-up-and-maintaining-ai-providers) alongside [Managing Support Agent Knowledge Sources and Project Linking](doc:managing-support-agent-knowledge-sources-and-project-linking) to keep provider setup aligned with how your team uses AI across projects.

## Importing and Exporting Provider Settings
Atloria includes **Import** and **Export** actions on the AI configuration screen so administrators can move provider settings more safely than retyping every field by hand.

1. Open the **AI Providers** settings page.
2. Click **Import** to load provider settings from a saved configuration file or settings payload.
3. After the import finishes, review the page immediately. Check the provider list, confirm the expected entries appear, and verify which provider is now active or selected by default.
4. Open each imported provider entry and inspect important fields such as the provider name, connection details, and any masked credential fields.
5. If everything looks correct, keep the imported configuration. If not, compare it with a known-good export before making manual corrections.

Import is useful when you are setting up a similar project, restoring a previous configuration, or applying a standard provider setup across multiple workspaces. It can also save time when several providers need to be added together.

To create a backup, use **Export** from the same screen.

1. Click **Export** on the AI Providers page.
2. Save the exported configuration in your team’s approved storage location.
3. Use that export when you need a backup, when you are preparing to reset the current setup, or when another project needs the same provider configuration.

[SCREENSHOT: Import and Export actions on the AI Providers screen]

Export is usually safer than manual copy-and-paste when your setup includes multiple providers or several detailed fields. A manual copy can miss hidden values, default selections, or small connection details. An export gives you a cleaner baseline to restore from later. If you are moving settings between projects, pair this process with the guidance in [Connecting and Managing External Integrations](doc:connecting-and-managing-external-integrations) when your AI setup depends on related connected tools.

## Resetting AI Configuration Safely
The **Reset** action on the AI Providers screen is meant for situations where you need to clear out a broken, outdated, or unwanted configuration. Because reset can affect the full AI provider setup shown on that page, use it carefully in shared projects.

1. Open the **AI Providers** settings screen and locate **Reset**.
2. Before clicking it, use **Export** to create a backup of the current configuration.
3. Confirm with your team that no one is actively updating provider settings at the same time.
4. Click **Reset** and complete any confirmation step Atloria shows.
5. After the reset finishes, review the provider list and settings form to confirm the result.

Depending on how your workspace is configured, reset may return the page to default values, remove custom provider entries, or clear settings that were previously imported. The exact result should be visible on the screen after the action completes. For example, you may see fewer provider entries, blank fields, or a default provider state instead of your earlier custom setup.

[SCREENSHOT: Reset action with confirmation prompt on the AI Providers page]

The safest time to use reset is when you already have an exported backup and you know the current configuration should no longer be used. If you are troubleshooting a single provider, try reviewing and updating that entry first instead of resetting everything.

After a reset, do not assume the page is ready for use until you verify the visible values. Open the remaining provider entries, if any, and check whether the intended default still exists. If the reset removed a working setup, you can usually recover more quickly by importing your last exported configuration than by rebuilding each provider manually.

## Verifying Your Setup
After saving, importing, or resetting AI provider settings, take a few minutes to confirm that Atloria is showing the configuration you intended.

1. Return to the **AI Providers** screen and check the provider list.
2. Confirm that the correct provider appears in the list and is marked as the active or selected option if your project uses a default provider.
3. Reopen the provider entry you just changed and make sure the values still appear as expected.
4. Review required fields for anything incomplete, especially connection details, model-related settings, and credential fields.
5. If you recently imported settings, compare the imported entries with an exported baseline if something looks different.

This verification step matters because some problems are easy to miss during editing. A provider may save with a missing field, a connection address may be entered incorrectly, or an import may overwrite a value you expected to keep. Reopening the screen helps you catch those issues before your team notices AI features behaving differently.

Common things to look for include:

- A provider entry is missing from the list
- The wrong provider appears to be selected
- A required field is blank
- A connection value does not match your approved setup
- Credential fields no longer appear stored after an import or reset

[SCREENSHOT: Verified provider list with the intended default provider selected]

If imported settings do not behave as expected, compare the current entries against a previously exported configuration. That side-by-side check is often the fastest way to spot mismatched values. For related setup checks, you may also want to review [Configuring AI Settings for Your Organization](doc:configuring-ai-settings-for-your-organization) and [Monitoring AI Usage and Request History](doc:monitoring-ai-usage-and-request-history) to confirm the provider changes support the AI features your team relies on.

## Overview
Use the **AI Providers** settings in Atloria when you need to control which AI services are available to a project and how those services are configured. This screen is most relevant for project administrators who manage documentation generation, AI support agents, or other AI-assisted workflows inside a shared workspace.

The AI Providers area is built around a few core tasks:

- Reviewing the current list of configured providers
- Opening a provider entry to inspect or update its details
- Saving changes to an existing provider or adding another one
- Importing a saved configuration into the current project
- Exporting the current configuration for backup or reuse
- Resetting the provider setup when you need to clear custom changes

Most teams use this screen during initial workspace setup, when moving a known-good AI configuration into another project, or when troubleshooting a provider that is no longer behaving as expected. It is also helpful after a team handoff, since the provider list and settings form let you quickly see whether the project is using a standard setup or a custom one.

Because these settings can affect multiple AI features across the project, always review the current configuration before making changes. In Atloria, a small update to the selected provider, connection details, or imported settings can change how documentation and AI-assisted tools behave for everyone in the workspace.

[SCREENSHOT: Full AI Providers page in Atloria]

If your team is working across several AI-related areas, this guide fits alongside [Configuring AI Settings for Your Organization](doc:configuring-ai-settings-for-your-organization), [Creating and Managing AI Support Agents](doc:creating-and-managing-ai-support-agents), and [Monitoring AI Usage and Request History](doc:monitoring-ai-usage-and-request-history). Those documents help you connect provider setup with the rest of your AI workflow in Atloria.

## Prerequisites
Before you update AI providers in Atloria, make sure the following conditions are in place. These checks help you avoid accidental changes, incomplete setups, or lost configuration details.

- You have **Project Administrator** access for the workspace where the provider settings are managed.
- You can open the **AI Providers** settings page in the project or administration area.
- You know whether you are updating an existing provider, adding a new one, importing a saved configuration, or resetting the current setup.
- You have the provider details your team intends to use, such as the provider name, connection information, model-related values, and any required credentials.
- If you plan to use **Import**, you already have the saved configuration file or settings payload available.
- If you plan to use **Reset**, you have exported the current configuration first so you can restore it if needed.

It also helps to confirm who else manages AI settings in the same workspace. In shared projects, another administrator may already be editing the same provider entries or may have recently changed the default provider. A quick check with your team can prevent duplicated work or overwritten settings.

Before making major changes, review related Atloria guidance if your provider setup connects to broader AI or admin workflows:

- [Configuring AI Settings for Your Organization](doc:configuring-ai-settings-for-your-organization)
- [Managing Organization and Admin Settings](doc:managing-organization-and-admin-settings)
- [Monitoring AI Usage and Request History](doc:monitoring-ai-usage-and-request-history)

[SCREENSHOT: AI Providers page access from the project or admin area]

If any of these items are missing, gather them before you start. Having the correct access, the right provider details, and a current export makes provider maintenance much easier and reduces the chance of interrupting AI features your team already depends on.