---
title: "Ambient Agent FAQs"
description: "1. How to know if agent has been installed properly?"
canonical_url: "https://help.brainfi.sh/articles/ambient-agent-faqs-oAxRV7VXcS"
md_url: "https://help.brainfi.sh/articles/ambient-agent-faqs-oAxRV7VXcS.md"
---
# Ambient Agent FAQs

## 1. How to know if agent has been installed properly?

An agent is installed properly when the agent button shows up in your UI.

To ensure the agent is learning, check the following items:

### Ensure that ambient learning is turned on for the agent.

1. Go to the Brainfish Platform.
2. Select Agents from the sidebar.
3. Find your agent.
4. Under `Ambient Settings`, turn on the `Enable observe and learn` setting.

![Enabling agent learning](https://help.brainfi.sh/api/attachments.redirect?id=955e1f88-cb04-4a20-8979-cdbf7bb5a532 " =538x193")

### Disable DNT from your browser.

When Do Not Track (DNT) setting is turned on, the agent will respect the setting and stop learning. To enable learning, the user should have DNT turned off. Here is an example on how to toggle this setting with Google Chrome: <https://support.google.com/chrome/answer/2790761>

### Allow Brainfish domains for CSP connection

If your application is using a **Content Security Policy (CSP)** directive, you will need to add these to your existing CSP:

* For `frame-src:`, add `https://app.brainfi.sh https://agent.brainfi.sh https://analytic.brainfi.sh`
* For `connect-src:`, add `wss://analytic.brainfi.sh`

**Example integration:**

If your current CSP is:

`<meta http-equiv="Content-Security-Policy" content="default-src 'self'; frame-src 'self' https://example.com; connect-src 'self' https://api.com;">`

Update it to:

`<meta http-equiv="Content-Security-Policy" content="default-src 'self'; frame-src 'self' https://example.com https://app.brainfi.sh https://agent.brainfi.sh https://analytic.brainfi.sh; connect-src 'self' https://api.com wss://analytic.brainfi.sh;">`

## 2. How do I verify that the agent has started ambient learning?

1. Open your browser's developer console:
   * **Chrome / Edge:** Press `F12` or `Ctrl+Shift+I` (Windows / Linux) or `Cmd+Option+I` (Mac).
   * **Firefox:** Press `F12` or `Ctrl+Shift+I` (Windows / Linux) or `Cmd+Option+I` (Mac).
   * **Safari:** Press `Cmd+Option+C` (Mac). (Safari requires the Develop menu to be enabled under Safari → Settings → Advanced.)
2. Look for the confirmation message: `Brainfish has started ambient learning`.
3. If you see this message, the installation was successful.

## 3. How much time is required to generate articles?

Articles get created once users start visiting pages from the customer’s application where the agent is installed.

An article is generated for every unique URL path that users have visited in an application.

A unique URL is a normalized URL path without dynamic strings (e.g. `/users/12345/profile` becomes `/users/id/profile`).

## 4. How quickly are articles processed?

If the agent is functioning as intended and events are flowing, learnings should appear in the Session Replays section of Settings within 2 hours of installation.

## 5. What data is captured to create articles?

Articles are created by analyzing what users see and do in the application. Nearly all visible content can be used for this analysis.

However, we exclude personal information (PII) from this process. We also hide passwords and other sensitive input fields.

## 6. Can we exclude parts of an application from analysis?

Yes, customers can opt to exclude parts of their application from analysis by doing either of the following:

### URL Path blocking

Customers can configure certain URL paths to be excluded from analysis.

1. Go to the Brainfish Platform.
2. Select Agents from the sidebar.
3. Find your agent.
4. Under `Ambient Settings` → `URL Paths Blocklist`, list down the URL path patterns you want to exclude from analysis.

![](https://help.brainfi.sh/api/attachments.redirect?id=3df9b419-ed88-4ef8-9cd9-ac41dde30356 " =729x237")

### DOM Element blocking

Customers can also control which DOM elements will be excluded for data analysis.

Customers can add the `bf-nocapture` HTML class to an element in their application so it doesn’t get included in analysis.

In the following example, the list and paragraph elements will not be included for analysis:

```markup
<div>
  <ul class="bf-nocapture">
    <li>1. a long list</li>
    <li>2. some data</li>
  </ul>
</div>
<div>
  <p class="bf-nocapture">sensitive data</p>
</div>
```

## 7. Can we disable tracking and ambient learning?

Users can disable tracking by enabling the Do Not Track (DNT) setting in their browsers.

Additionally, tracking can be disabled programmatically, which is particularly useful when deploying a consent banner for users. This feature also disables ambient learning.

### Usage

```javascript
// To disable tracking (stops recording, screenshots, etc.)
window.BrainfishAnalytics('disableTracking');

// To re-enable tracking
window.BrainfishAnalytics('enableTracking');

// To check if tracking is currently disabled
const isDisabled = window.BrainfishAnalytics('isTrackingDisabled');
console.log('Is tracking disabled?', isDisabled); // true or false
```

### Example of real-world usage

```javascript
// When user clicks "Accept All" on cookie banner
document.getElementById('accept-all').addEventListener('click', () => {
  window.BrainfishAnalytics('enableTracking');
  // Store consent preference
  localStorage.setItem('cookie-consent', 'all');
});

// When user clicks "Reject Optional" on cookie banner
document.getElementById('reject-optional').addEventListener('click', () => {
  window.BrainfishAnalytics('disableTracking');
  // Store consent preference
  localStorage.setItem('cookie-consent', 'essential-only');
});

// On page load, check existing consent
if (localStorage.getItem('cookie-consent') === 'essential-only') {
  window.BrainfishAnalytics('disableTracking');
}
```