> For the complete documentation index, see [llms.txt](https://help.highlight.net/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.highlight.net/admin/admin-general-details/agent-selection.md).

# Agent Selection

### Overview

To use an agent or agent group in Highlight requires two separate actions - creating the agent/group, then telling Highlight where to use that agent/group to do a particular job. This gives you a lot of flexibility in how agents are used.

To assign an agent or group to a folder, select the folder in Admin and select the cog to edit. Settings are inherited, so if you select an agent in one folder, those settings will apply to all folders beneath it unless locally overridden.

You can tell Highlight to use a given agent for any combination of Poller & WiFi, Flow and Controller collection.

{% hint style="info" icon="square-check" %}
More than one agent or group may be selected on each tab.

Only those agents which have been selected are available from Edit Watch.
{% endhint %}

### Poller & WiFi and Controller tabs

<figure><picture><source srcset="/files/6jSq4r0uVJeg3pvpwPY2" media="(prefers-color-scheme: dark)"><img src="/files/JZLA5pABKOO4L4mK6lON" alt="Poller &#x26; WiFi Agent selection popup"></picture><figcaption></figcaption></figure>

<table data-header-hidden><thead><tr><th width="153"></th><th></th></tr></thead><tbody><tr><td>No collection</td><td>Don't poll any watches under this folder.</td></tr><tr><td>Defined locally</td><td>Select this option to override any inherited settings and specify one (or more) agents/agent groups to be available for use as the Poller.</td></tr><tr><td>Inherited from [folder]</td><td>This is the default and means this folder will inherit the settings from a folder somewhere above it in the tree. The inherited settings will be shown in the list below for information. To change it, select Defined locally.</td></tr></tbody></table>

{% hint style="info" icon="circle-dot" %}
The radio button in the Default column indicates this is the default poller to be used for each watch in this folder. This can be overridden for individual bearer watches using Edit watch. Click another poller to change the default.&#x20;
{% endhint %}

{% hint style="danger" %}
Changing the default poller could cause Highlight to stop collecting data. Only make changes which are fully understood. [Contact us](/getting-started/contact-us.md) for assistance if required.
{% endhint %}

### Flow tab

<figure><picture><source srcset="/files/TFySDaOyqhKYuoLViFFA" media="(prefers-color-scheme: dark)"><img src="/files/lI6QymYP0kZGIk59mVZ5" alt="Flow Agent selection popup"></picture><figcaption></figcaption></figure>

<table data-header-hidden><thead><tr><th width="153"></th><th></th></tr></thead><tbody><tr><td>No collection</td><td>Don't collect Flow data for this folder - any Flow watches that are configured under this folder will not be notified to the agent, so flows received by the agent are ignored.</td></tr><tr><td>Defined locally</td><td>Select this option to override any inherited settings and specify which agents and/or groups can collect Flow. These agents will be notified by Highlight of any Flow watches configured beneath this folder and process Flow data received.</td></tr><tr><td>Inherited from [folder]</td><td>This is the default and means this folder will inherit the settings from a folder somewhere above it in the tree. The inherited settings (i.e. the selected agent, if there is one) will be shown in the list below for information. To change it, select Defined locally.</td></tr></tbody></table>


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://help.highlight.net/admin/admin-general-details/agent-selection.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
