Chat settings

Control how Test Companion interacts with you during a conversation and how it connects to your test automation environment.

Chat settings control how Test Companion interacts with you during a conversation and how it connects to your test automation environment. This is one of the most important configuration areas, covering the AI’s level of autonomy, your environment context, and BrowserStack cloud credentials.

How to open settings

1. Click the gear icon (⚙) in the top-right corner of the Test Companion panel.

   

2. Select the Chat Settings tab.

   

3. Make the necessary changes and click Save to apply them.
4. Click Cancel to discard any unsaved changes.

Interaction Settings

Use the following settings to control how Test Companion behaves during conversations:

Interaction Mode

The Interaction Mode determines how much independence the AI has when working on your tasks. This is one of the first things you should configure, because it fundamentally changes the experience of using Test Companion.

Default mode

When set to Default, the assistant works autonomously with minimal interruptions. It reads files, writes code, runs commands, and moves through the steps of a task on its own, only stopping when it encounters something it cannot resolve or when it needs information from you.

Default mode is best for:

• Experienced users who are comfortable with AI-generated code changes.
• Well-defined, routine tasks like generating boilerplate test files or running standard test suites.
• Situations where you want to hand off a task and review the result at the end.

Example: You ask Test Companion to “Write Selenium tests for the checkout page.” In Default mode, the AI reads your existing page objects, creates a new test file, adds assertions for each form field, and presents the finished file to you in one go.

Guided mode

When set to Guided, the assistant pauses at each major step and asks for your confirmation before proceeding. This gives you more control over every action the AI takes.

Guided mode is best for:

• New users who are still learning how Test Companion works and want to understand each step.
• Critical or sensitive projects where you need to review each file change before it happens.
• Complex tasks with ambiguous requirements where the AI might need direction at each step.
• Training and onboarding scenarios where you want to walk a colleague through the AI’s decision-making process.

Example: You ask Test Companion to “Fix the flaky login test.” In Guided mode, the AI first identifies the likely cause (a missing wait condition), shows you its analysis, and asks if you agree. Once you confirm, it shows the proposed code change and asks for approval before writing the file. Finally, it asks whether you’d like it to run the test to verify the fix.

Choose a mode

You can switch between modes at any time. The change takes effect on the next task you start (it does not affect a task that is already in progress).

Test Automation Settings

Use the following settings to configure your test automation environment:

System Instructions

System Instructions let you describe your project’s testing environment so the AI produces code and suggestions that fit your setup from the very first message. Think of this as giving the AI a “cheat sheet” about your project before any conversation starts.

Without System Instructions, the AI may default to assumptions that do not match your project — for example, it might generate Pytest-style tests when your team uses the unittest framework, or place files in a tests/ directory when your project uses spec/.

What to include

Write your System Instructions in plain language. The AI does not need formal syntax or special markup — it simply reads your description and applies it going forward.

Here are the areas you should consider covering:

1. Framework and language

We use Selenium WebDriver with Java 17. Our test runner is TestNG.

2. Folder structure

Test files go in src/test/java/com/myapp/tests/. Page objects live in src/test/java/com/myapp/pages/. Test data is stored in src/test/resources/testdata/.

3. Naming conventions

Test class names end with Test (e.g., LoginPageTest). Test methods start with test followed by a camelCase description (e.g., testSuccessfulLoginWithValidCredentials). Page object classes end with Page (e.g., LoginPage).

4. Coding standards and patterns

Always use explicit waits (WebDriverWait), never Thread.sleep(). Use the Page Object Model pattern. Each page object should have a constructor that accepts a WebDriver instance. Assertions should use TestNG’s Assert class.

5. Environment details

Our staging URL is https://staging.myapp.com. We use BrowserStack for cross-browser testing. Our CI runs on Jenkins with parallel test execution across 5 nodes.

6. What the AI should avoid

Do not modify the BaseTest.java file. Do not generate tests for the admin panel — those are handled by a separate team.

Example

Here is a complete System Instructions entry for a mid-size e-commerce project:

Our project is an e-commerce web application.

Framework: Selenium WebDriver with Python 3.11 Test runner: Pytest with pytest-html for reporting Browser: Chrome (headless in CI, headed locally)

Folder structure:

• tests/ → test files (one file per feature area)
• pages/ → Page Object classes
• utils/ → helpers (custom waits, data generators)
• conftest.py → shared fixtures

Naming:

• Test files: test_.py (e.g., `test_checkout.py`)
• Test functions: test_ (e.g., `test_guest_checkout_with_credit_card`)
• Page objects: Page class (e.g., `CheckoutPage`)

Standards:

• Use explicit waits, never time.sleep()
• All selectors should use data-testid attributes when available
• Each test must be independent and not rely on other tests’ state
• Use @pytest.mark.parametrize for data-driven tests

BrowserStack:

• Run cross-browser tests on BrowserStack using our existing conftest fixtures
• Target browsers: Chrome latest, Firefox latest, Safari latest, Edge latest

BrowserStack Username

Your BrowserStack username is displayed on your BrowserStack Account Settings page. It typically looks like yourname_A1B2CdEF.

When Test Companion generates automation code that runs on BrowserStack (for example, setting up a remote WebDriver session), it automatically inserts this username into the configuration so the code is ready to run without manual editing.

BrowserStack Access Key

The access key works alongside your username to authenticate with BrowserStack’s infrastructure. You can find it on the same Account Settings page as your username.