---
title: "AI Options"
section: "Project settings"
description: "SmartestQA AI Options: Enable AI, Smartest AI or your own Gemini, OpenAI, Anthropic or local model, Test Connection, and the AI capability switches."
url: https://docs.smartestqa.ai/en/project-settings-ai.html
audience: [customer, admin]
updated: 2026-11-08
keywords: "ai options enable ai smartest ai own account provider gemini openai anthropic claude ollama local llm base url api key max tokens temperature test connection auto-heal ai failure analysis ai report feedback document analysis share sensitive data"
---
# Project settings: AI Options

AI Options decides whether a project uses AI at all, whose AI account it uses, and which AI features are switched on: locators, assessments, auto-heal, document analysis, failure analysis and report feedback.

## In short

**On this page you can**

- Switch all AI features of the project on or off with Enable AI .
- Use the SmartestQA AI account, or your own Gemini, OpenAI, Anthropic or local model.
- Check a provider key before saving with Test Connection .
- Turn single capabilities on or off, such as Auto-Heal or AI Failure Analysis .
- Keep sensitive data out of AI requests with Share Sensitive Data off.

**How to use it**

1. Open Configuration › Project Panel › AI Options .
2. Turn on Enable AI ; the other blocks appear.
3. Under AI Account keep Smartest AI , or pick Own Account and fill provider, model and key.
4. Click Test Connection and wait for “Connection successful”.
5. Set the capability switches and click Save Changes .

## Enable AI

**Enable AI** (block **AI Features**) is the main switch. New projects have it on. When it is off, every AI feature of the project is off, the other two blocks are hidden, and AI buttons elsewhere show a tooltip such as “Enable 'Enable AI' in Project Panel → AI Options”. Tests without [AI steps](https://docs.smartestqa.ai/en/automate-steps-ai.html) still run normally.

## AI Account

| Option | What it means | You fill |
| --- | --- | --- |
| **Smartest AI** | SmartestQA’s own AI account. Model, token budget and temperature are set by SmartestQA. Default for new projects. | Nothing |
| **Own Account** | Your company’s provider account. AI requests of this project go to your provider, with your key. | Provider, model, key (see below) |

### Use your own account

| Field | What to enter | Rules |
| --- | --- | --- |
| **AI Provider** | Google Gemini, OpenAI (ChatGPT), Anthropic (Claude), or OpenAI-compatible / Local (Ollama, vLLM, LM Studio...). | New projects: Google Gemini. |
| **AI Model** | The model name exactly as the provider writes it. The grey hint (`gemini-...`, `gpt-...`, `claude-...`, `llama3.1:8b`) is only an example. | Empty = the provider’s default model. Changing the provider clears or replaces a model of the old provider; your own model name is kept. |
| **Base URL** | The provider endpoint. It is pre-filled with the provider’s default address. | Leave the default to follow the provider. Required for OpenAI-compatible / Local, for example `http://localhost:11434/v1`. |
| **API Key** | Your provider key. | Stored encrypted. After saving it shows as a fixed mask; typing replaces the whole key, leaving the mask keeps the saved key. Optional for local providers. |
| **Max Tokens** | The longest answer the model may give. | 1–8192. New projects: 2000. |
| **Temperature** | “Creativity (0-1)”: low values give steadier answers. | 0–1. New projects: 0.7. |

1. **Fill provider, model and key**

   Pick **Own Account**, then the provider. Paste the key in full.
2. **Test before saving**

   Click **Test Connection**. It uses the values on screen, saved or not (“Testing...”).

   “Connection successful”, or the model’s short reply. A failure shows one sentence and **Technical details**; see [AI connection errors](https://docs.smartestqa.ai/en/project-settings-troubleshooting.html#fix-ai-test).
3. **Save**

   Click **Save Changes**. AI features of the project pick up the new account at once; [pipelines](https://docs.smartestqa.ai/en/schedule-create.html) take it from their own copy (see [How settings reach a run](https://docs.smartestqa.ai/en/project-settings-test-management.html#how-settings-reach-runs)).

> **Note: A local model on your own network**
>
> With OpenAI-compatible / Local, the SmartestQA server must be able to reach the Base URL. `localhost` means the server itself, not your laptop. Use an address that the SmartestQA server (or your on-premise installation) can reach.

## AI Capabilities

Each switch turns one AI feature on or off. All are on in new projects. They count only while **Enable AI** is on.

| Switch | Screen text | What it turns on |
| --- | --- | --- |
| **AI for Locators** | Use AI to find element locators | AI help in the browser extension while recording: naming controls and choosing locators. |
| **AI for Assessment** | Use AI to evaluate [assertions](https://docs.smartestqa.ai/en/automate-steps-assertions.html) | AI Insights on the [Dashboard](https://docs.smartestqa.ai/en/insight.html). |
| [**Auto-Heal**](https://docs.smartestqa.ai/en/maintenance-how-healing-works.html#settings) | Auto-heal locators | The runner repairs a locator that stopped matching; repairs wait for review in **Maintenance**. |
| **AI Document Analysis** | Auto-generate test cases from uploaded analysis documents | Document analysis in **[Analyze](https://docs.smartestqa.ai/en/analyze.html)**, [AI steps](https://docs.smartestqa.ai/en/automate-steps-ai.html) and the AI assistant (prompt to steps, expand) in **Automate**. |
| **Share Sensitive Data** | Send sensitive data to the AI | Off: sensitive values are masked before a request leaves for the AI. |
| **Collect for Templates** | Save repeated actions to build reusable templates | Collects repeated action sequences so they can be suggested as templates. |
| **AI Failure Analysis** | Auto-analyze failed steps with AI | The AI analysis of failed steps in reports. |
| **AI Report Feedback** | AI review of this run's results on the report summary | The AI review card on the report summary. |

Code generation in JavaScript and [Python steps](https://docs.smartestqa.ai/en/automate-steps-code.html) needs only **Enable AI**.

## What is sent to the AI

- Only what the feature needs: for example a failed step and its error for [failure analysis](https://docs.smartestqa.ai/en/report-ai-analysis.html), page descriptions and notes for test generation.
- With **Own Account** the data goes to your provider under your agreement with them.
- With **Share Sensitive Data** off, values recognised as sensitive are masked first.
- Use test environments and test data in any case; [screenshots](https://docs.smartestqa.ai/en/report-steps.html#screenshots) and texts may reach the AI.

## If something goes wrong

- [Test Connection fails](https://docs.smartestqa.ai/en/project-settings-troubleshooting.html#fix-ai-test)
- [An AI button is greyed out with “Enable … in Project Panel → AI Options”](https://docs.smartestqa.ai/en/project-settings-troubleshooting.html#fix-ai-disabled-tooltip)
- [The API Key field is empty after saving](https://docs.smartestqa.ai/en/project-settings-troubleshooting.html#fix-ai-key-empty)
