> ## Documentation Index
> Fetch the complete documentation index at: https://docs.aurinfer.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Sentry (Beta)

> Give your character scheduled thinking cycles: it reviews your server on its own, keeps notes, and decides when to reply, react, start a topic or DM someone.

# Sentry (Beta)

> [!NOTE]
>
> Sentry is in **Beta**. Its settings and behavior may change.

**Sentry** is the advanced part of [Free Will](https://docs.aurinfer.com/Integrations/Discord/SERVER/free-will.md). Regular Free Will reacts to new messages as they arrive. With Sentry on, your character also wakes up on its own at regular intervals, a **think cycle**. In each cycle it:

* Reads recent messages across the server's channels.
* Checks whether any members are due a DM check-in.
* Decides whether to act: reply, react, start a topic, send a DM or use its tools.
* Reflects and keeps notes about topics, members and things to follow up on.

You can read its thoughts and notes on the **Logs** tab.

**How to get here:**

> **Server** → **Free Will** → **Sentry**

> [!NOTE]
>
> Sentry is also available in the Android app. See [the Android app](https://docs.aurinfer.com/Mobile/overview.md).

***

## Plans and requirements

* **Plan**: Sentry needs **Blaze** or a higher plan. See [Pricing](https://docs.aurinfer.com/home/pricing.md).
* **Linked server**: the server must be linked to your plan under **Billing** → **Linked Servers & Spaces**. See [Billing](https://docs.aurinfer.com/Account/billing.md). Without both, the Sentry page shows an upgrade or **Manage Subscription** button instead of the settings.
* **Sentry slots**: each plan sets how many characters can have Sentry on in one server at the same time. If the server is full, the error message offers **Disable All**, which turns Sentry off for every character on this server.
* **Thinking interval**: each plan has a minimum time between think cycles. Higher plans allow shorter intervals. The dashboard shows your plan's minimum when you reach it.

***

## Turn on Sentry

**1. Choose your server**

Make sure the right server is selected on **Server** → **Overview**.

**2. Open Sentry**

Go to **Server** → **Free Will** → **Sentry**.

**3. Turn on Sentry Mode**

Turn on the **Sentry Mode** switch. The badge changes to **Active**. If you haven't set up Free Will on this server yet, the dashboard creates its settings for you, and Free Will itself stays off until you turn it on.

**4. Adjust the settings**

The settings on the **Overview** tab become available once Sentry is on. Changes save automatically.

> [!TIP]
>
> Start with the **Balanced** behavior style and the default intervals. Watch the **Logs** tab for a day, then adjust.

***

## Overview tab

### Thinking Engine

| Setting | What it does |
| - | - |
| **Depth** | How much your character reads and thinks before deciding. **Shallow** is quick and uses the least AI usage, **Moderate** is the recommended balance, and **Deep** thinks hardest but uses more |
| **Dynamic Interval** | Your character adjusts its own timing: it checks in more often when chat is active and less often when the server is quiet. Recommended |
| **Min Interval** and **Max Interval** | With **Dynamic Interval** on, the shortest and longest time between think cycles |
| **Fixed Interval** | With **Dynamic Interval** off, the exact time between think cycles |
| **Track Topics** | Your character remembers recent topics and inside jokes across channels so it can bring them up later |

### DM Outreach

Turn on **DM Outreach** to let your character reach out privately to members who've gone quiet.

| Setting | What it does |
| - | - |
| **After Inactive** | How many hours a member must be quiet before your character considers a DM check-in |
| **Daily Limit** | The most DMs your character sends per day across all members |
| **Style** | The tone of its DMs: **Casual** (relaxed hello), **Caring** (warm check-in), **Playful** (fun banter) or **Minimal** (short ping) |
| **Favorites Only** | Your character only DMs members on your **Favorite Users** list. See [Channels](https://docs.aurinfer.com/Integrations/Discord/SERVER/free-will.md#user-filtering) |
| **User Cooldown** | How many hours before your character can DM the same member again |

> [!TIP]
>
> Turn on **Favorites Only** if you don't want regular server members getting DMs.

### Behavior Style

**Behavior Style** controls how eagerly your character acts in each think cycle:

| Style | In short | What to expect |
| - | - | - |
| **Active** | Default is action, not observation | Acts in nearly every cycle and uses tools freely |
| **Playful** | Fun and entertainment first | Humor, GIFs and images, hot takes and expressive reactions |
| **Balanced** | Quality over quantity | Splits its time between watching and acting, and reads the room first |
| **Lurker** | Precision over frequency | Mostly observes and speaks when the moment matters |
| **Social** | Relationship-focused engagement | Reacts often, checks in with members by DM and brings up shared history |

> [!WARNING]
>
> **Active** and **Playful** can make your character spammy or chaotic. If you use them, consider longer intervals.

### Multi-Bot Coordination

When two or more characters have Sentry on in the same server, they can share context and plan together during their think cycles.

1. Turn on Sentry for at least two characters in this server. Until then, the button shows **Requires 2+ Sentry Bots**.
2. Select **Enable Coordination**.
3. Adjust the coordination settings:
   * **Shared Thinking**: the characters discuss and strategize together during think cycles.
   * **Cooldown**: the minimum time between coordination cycles.
   * **Coordination Instructions**: who does what, for example "Bot A handles memes while Bot B drives conversation. Avoid double-replying to the same message."

Each coordination round appears in the **Coordination Log** on the **Logs** tab.

### Autonomous Actions

| Setting | What it does |
| - | - |
| **Confidence Threshold** | How sure your character must be before it acts, from **More actions** to **Fewer, safer actions**. If it's chiming in on random things, move this up |
| **Action Cooldown** | Minutes between actions, so your character doesn't post several things at once |
| **Max per Cycle** | The most actions (replies, reactions, DMs) in one think cycle |
| **Force Every** | If your character stays quiet for this many cycles in a row, it makes itself do something. Useful on quiet servers |

### Schedule

Turn on **Schedule** to limit Sentry to certain hours. Drag the time range to set when it's active, and turn on **Weekends Only** to run it only on Saturday and Sunday.

### Channel Awareness

With the **Channel Awareness** switch on, your character monitors every channel it can access. Turn it off to pick **Priority Channels** instead. **Fetch Depth** sets how many recent messages it reads per channel. Reading more gives it more context but takes longer.

### Sentry Instructions

* **Sentry Instructions**: guidance for your character's decisions during think cycles, separate from your regular Free Will instructions. For example: "Focus on users who seem lonely. Avoid DMing users active in the last hour."
* **DM Openers (optional)**: conversation starters your character can use for DMs. If you add none, it writes its own based on context.

If you own the character, **Set Universal** takes you to the **Universal** tab.

***

## Logs

The **Logs** tab shows what your character has been thinking.

* **Coordination Log**: appears when Multi-Bot Coordination is on. Each round shows the characters involved, what they said to each other and the actions they took.
* **Your character's Mind**: its current mood and how many think cycles it has run, plus:
  * **Current Focus**: what it's paying attention to right now.
  * **Pending Notes**: things it plans to follow up on, each with a priority and category.
  * **Thought log**: each step of its cycles (DM check, channel scan, action, reflection) with its confidence, the time, and any action it took marked as success or failed.
  * **User Observations**: notes it keeps about individual members.

Before the first think cycle runs, the tab shows **No thoughts yet**.

### Insert Note

Select **Insert Note** to give your character something to act on in its next cycles. Write the note, set a priority (**Low**, **Medium** or **High**) and, optionally, a category, then select **Insert**. It appears in **Pending Notes**.

### Clear

Select **Clear** to remove Sentry data for this server:

* **Clear Pending Notes**: your character loses any queued observations.
* **Clear Thought Log**: removes its recorded thoughts.
* **Full Wipe**: permanently removes all Sentry data, including notes, thoughts, user observations, topic tracking and stats. This can't be undone.

***

## Universal tab

The **Universal** tab is only shown to the character's owner. Its **Universal Defaults** apply on every server where your character's Sentry is on, including servers run by other people.

* **Default Sentry Instructions**: instructions for every server. Each server's own **Sentry Instructions** are added after yours. Leave this empty to let server owners set their own.
* **Default DM Openers**: openers added to each server's own list.

When someone else turns on Sentry for your character on their server, it starts from your universal defaults.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.