> This page location: /docs.md > /docs/agentengine.md

> For the complete MongoDB documentation index, see www.mongodb.com/docs/llms.txt

<!--
Tab options on this page. Append to the .md URL to filter:
  ?tabs=<id,...>   select specific tabs (e.g. ?tabs=nodejs,shell)
  ?allTabs=true    include every tab
  (no param)       default: one tab per tabset

Available tabs:
  other tabs: ui, api
-->

# Use Content Guardrails

MongoDB Atlas Agent Engine is in Public Preview and intended for evaluation and prototyping purposes only. We do not recommend production deployments during preview and expect to communicate breaking changes with you periodically. To learn more about preview feature considerations, see [Preview Features](https://www.mongodb.com/docs/preview-features/).

## Overview

Atlas Agent Engine guardrails allow project administrators to control the content that passes into and out of an agent's model calls. Administrators set guardrails within a project, and the Orchestration Engine (OE) enforces the guardrails by blocking or modifying matching input and output content.

To apply a guardrail to one or more workspaces, specify the workspaces in the guardrail's `workspace_ids` field. If you don't specify this field, the guardrail applies to every workspace in the project.

Guardrails complement the [Policy Engine](https://www.mongodb.com/docs/agentengine/manage/governance/policy-engine.md#std-label-agent-engine-policy-engine). Guardrails control the *content* that passes into and out of a model, while the Policy Engine controls the *actions* an agent can take, such as which tools and models it can call.

## Guardrail Types

Each guardrail has a **type**, which determines what content it evaluates, and an **action**, which determines what happens when the guardrail triggers.

Currently, the Atlas Agent Engine supports only the `output_validation` guardrail type. You can use guardrails of this type to evaluate an agent's output against a set of regular expression patterns. Define these patterns in the guardrail's `config.match_patterns` field.

Each guardrail specifies one of the following actions:

| Action | Description |
| --- | --- |
| `block` | Denies the call. The execution halts and returns an error to the caller. |
| `modify` | Removes or transforms the matched content and allows the execution to proceed with the modified content. |
| `log_only` | Records that the guardrail triggered and allows the execution to proceed with the original content. |
| `require_review` | Suspends the execution for human review. The execution proceeds only after a reviewer approves it. |

## Guardrail Stages

A guardrail's stage filter determines whether it evaluates content going into the model, coming out of the model, or both. A guardrail with no stage filter applies to all stages.

The following table describes the available stages:

| Stage | Evaluates What | Triggers When |
| --- | --- | --- |
| `llm_input` | The user content reaching the model | Before a model call |
| `llm_output` | The model's response | Before the response returns to the user |

## Guardrail Fields

The following table describes the fields that define a guardrail. You can set these fields in the Atlas Agent Engine UI, or in the JSON request body of a `create` or `update` API request.

| Field | Possible values | Description |
| --- | --- | --- |
| `name` | Any string | *(Required)* Display name for the guardrail. |
| `description` | Any string | Description of the guardrail's purpose. |
| `type` | `output_validation` | *(Required)* Guardrail type. |
| `action` | `block`, `modify`, `log_only`, `require_review` | *(Required)* Action to take when the guardrail triggers. |
| `status` | `active`, `inactive` | Whether the Atlas Agent Engine enforces the guardrail. The Atlas Agent Engine enforces guardrails whose status is `active`. |
| `stage_filter` | `llm_input`, `llm_output` | Array of the stages at which the guardrail evaluates content. To evaluate both stages, list both `llm_input` and `llm_output`. |
| `workspace_ids` | Array of workspace IDs | Array of the workspaces that the guardrail applies to. To apply the guardrail to every workspace in the project, leave this array empty. |
| `config.match_patterns` | Array of regex patterns | Array of the patterns that the guardrail matches content against. Each pattern sets a `type` of `regex` and a `value` that contains the regular expression. |
| `config.on_fail` | `fix`, `noop`, `log_only`, `block` | Behavior to apply to content that matches a pattern. This field applies only when `action` is set to `modify`. |

To view an example request body that sets these fields, see the REST API tab in the [following section.](https://www.mongodb.com/docs/agentengine/manage/governance/guardrails.md#std-label-agent-engine-guardrail-create)

## Create and Edit Guardrails

You can create and edit guardrails by using the Atlas Agent Engine UI or the REST API. To view instructions, select the tab for your preferred method:

### Atlas Agent Engine UI

Navigate to Manage → Policies, and then select the Guardrails tab.

Then, create a guardrail by clicking the Create guardrail button and configuring the fields in the Create guardrail dialog. To update a guardrail, click the guardrail's Edit icon. To delete a guardrail, click its Delete icon.

### Guardrail Propagation

After you create, update, or delete a guardrail, the change takes effect on the next execution that the OE handles. A guardrail write reloads the OE's cached guardrails, so the change is effective on the next request.

Guardrail changes do not affect in-flight executions.

## Enforcement

During each execution, the OE evaluates the content at each stage against the guardrails that apply to the current project. The following table describes the stages and the corresponding evaluated content:

| Stage | Content evaluated |
| --- | --- |
| `llm_input` | The user content is evaluated before a model call. |
| `llm_output` | The model's response is evaluated before it returns to the user. |

When a guardrail with a `block` action triggers, the OE halts the execution and returns an error to the caller. The error identifies the guardrail that caused the block. When a guardrail with a `modify` action triggers, the execution proceeds with the modified content.

When more than one guardrail matches the same content, the most restrictive action applies. The actions rank in the following order, from most to least restrictive:

1. `block`

2. `require_review`

3. `modify`

4. `log_only`

For example, if one guardrail returns `modify` and another returns `block`, the OE blocks the call.

## Limitations

Guardrails have the following limitations:

- **Future executions only**: Guardrail changes apply only to executions that start after the change takes effect. Executions already in progress continue with the guardrails they started with.

- **Content controls only**: Guardrails control content that passes into and out of a model. To control the actions an agent can take, such as which tools and models it can call, use the [Policy Engine.](https://www.mongodb.com/docs/agentengine/manage/governance/policy-engine.md#std-label-agent-engine-policy-engine)
