> For the complete documentation index, see [llms.txt](https://docs.blusapphire.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.blusapphire.io/older-releases/09_casehub/input-configuration/agents.md).

# Agents

Case-Hub Agents are responsible for polling data produced by configured Inputs (see [Inputs ](/older-releases/09_casehub/input-configuration.md)if you have not yet configured these). Agents will poll your Input for the necessary data before processing it into a format the Case-Hub API understands. 

There are several roles that will allow Agents to perform a variety of different functions (see [Agent Roles](#default-roles) for these roles and their functions).

## Creating Agents

To create new Agents in Case-Hub, the following steps can be used:

1. Navigate to the **System -> Agents** page from Dashboard
2. Click **"New Agent"**, copy the generated command with the agent pairing token, and execute it on the Case-Hub Server.

   **Note:** Agent creation and deployment require Administrative privileges 

## Agent Roles <a href="#default-roles" id="default-roles"></a>

Agents must take on at least one of the following roles in order to be functional:

<table><thead><tr><th width="154">Agent Roles</th><th>Description</th></tr></thead><tbody><tr><td>poller</td><td>Pulls data from defined Inputs and pushes it to Case-Hub in the form of an Event</td></tr><tr><td>detector</td><td>Runs Detection Rules against defined Inputs</td></tr><tr><td>runner (beta)</td><td>Executes ad-hoc and playbook actions against defined resources</td></tr></tbody></table>