Behavioral Activity

Behavioral Activity

WitnessAI Documentation
List
Start Here
Home
Discovery
Analytics
Conversations
Users
Alerts
Policy
Administration
Apps & Resources
Tutorials
Release Notes
Release Notes
November 3, 2026 WitnessAI Release
October 27, 2026 WitnessAI Release
October 20, 2026: WitnessAI Release
October 13, 2026: WitnessAI Release
September 29, 2026: WitnessAI Release
September 22, 2026: WitnessAI Release
September 15, 2026: WitnessAI Release
September 8, 2026: WitnessAI Release
September 1, 2026: WitnessAI Release
August 25, 2026: WitnessAI Release
August 18, 2026 WitnessAI Release
August 4, 2026 WitnessAI Release
July 21, 2026 WitnessAI Release
July 14, 2026 WitnessAI Release
July 9, 2026 WitnessAI Release
June 30, 2026 WitnessAI Hotfix
June 23, 2026 WitnessAI Release
June 16, 2026 WitnessAI Release
June 11, 2026 WitnessAI Release
June 4, 2026 WitnessAI Hotfix
June 2, 2026 WitnessAI Update
May 19, 2026 WitnessAI Update
April 30, 2026 WitnessAI Update
April 28, 2026 WitnessAI Update
April 23, 2026 WitnessAI Update
April 16, 2026 WitnessAI Update
April 14, 2026 WitnessAI Update
April 9, 2026 WitnessAI Update
April 2, 2026 WitnessAI Update
March 31, 2026 WitnessAI Update
March 24, 2026 WitnessAI Update
March 19, 2026 WitnessAI Update
March 17, 2026 WitnessAI Update
March 12, 2026 WitnessAI Update
March 5, 2026 WitnessAI Update
February 26, 2026 WitnessAI Update
February 24, 2026 WitnessAI Update
February 10, 2026 WitnessAI Update
January 27, 2026 WitnessAI Update
January 20, 2026 WitnessAI Update
January 13, 2026 WitnessAI Update
December 18, 2025 WitnessAI Update
December 9, 2025 WitnessAI Update
November 18, 2025 WitnessAI Update
November 25, 2025 WitnessAI Update
November 11, 2025 WitnessAI Update
October 28, 2025 WitnessAI Update
October 23, 2025 WitnessAI Update
October 9, 2025 WitnessAI Update
April 11, 2025: WitnessAI Release v2.0
Draft: November 10, 2026 WitnessAI Release
June 9, 2025: WitnessAI Update
June 23, 2025: WitnessAI Update
July 18, 2025: WitnessAI Update
September 30, 2025: WitnessAI Update
July 31, 2025: WitnessAI Update
August 12, 2025: WitnessAI Update
September 23, 2025: WitnessAI Update
October 2, 2025 WitnessAI Update
Integrations
API Reference
Administrator Guide
 

Behavioral Activity guardrail

Behavioral Activity is the WitnessAI user behavior and intention guardrail. Its purpose is to monitor user behavior during interactions with AI models, determine the user’s intentions, and provide control over these activities.
When this guardrail detects a behavior you defined, it can Allow, Warn, Block, or Route the prompt to another model.
For example, technical support-related behaviors can be automatically routed to an internal model designed to assist employees, ensuring appropriate handling and alignment with internal policies.
WitnessAI Policies enable organizations to manage and control AI usage effectively. By using the Behavioral Activity guardrail, administrators can define rules that enhance compliance, productivity, and ethical AI use.
 

How it works

Behavioral Activity looks at the intention behind each user prompt, such as asking for programming help or comparing competitors, and applies the outcome you set for that behavior.
You shape the guardrail with rules. Each rule has two parts:
  • A condition, shown as User Behavior: one or more behaviors the rule looks for. Each behavior has an editable Definition that describes what it means.
  • A THEN outcome: a severity (High, Medium or Low) and an action (Allow, Warn, Block or Route).
The last rule, For all other behaviors, covers any prompt that none of your rules match, so the guardrail always has a defined outcome.
You can add rules by hand, have WitnessAI draft them from a Purpose you describe, or refine existing rules with AI.
 

Use Case Examples

Ethical AI Usage

Warn or block users attempting to engage in unethical or non-compliant behavior.

Secure AI Usage:

Block users generating prompts that might lead to security or compliance risks.
Behavioral Activity guardrails are integrated into policies to provide granular control over user behaviors.

Technical Support Queries

Route prompts requesting technical support to an internal model specialized for technical assistance.
 

Using Behavioral Activity Step-by-Step

This section covers how to add a Behavioral Activity guardrail to a policy. See Policy Creation for how to create a policy.

Adding a Behavioral Activity guardrail

After creating a Policy
  1. Click the Guardrails tab in the policy editor.
  2. Select the Behavioral Activity guardrail from the available options.
  3. Click the slide button to enable the guardrail.
  4. Optionally, describe what the policy is for in the Purpose field. WitnessAI uses the Purpose when it drafts or refines rules for you.
The Behavioral Activity tab with the guardrail enabled, showing the Purpose field and a list of collapsed IF/THEN rules.
The Behavioral Activity tab with the guardrail enabled, showing the Purpose field and a list of collapsed IF/THEN rules.
With the guardrail enabled, build its rules with any of the methods below.

Add a rule manually

  1. Click Manually Add Rule. Once the guardrail has at least one rule, the button reads Add Rule.
  2. Under User Behavior, select a behavior. You can search the list or type a new behavior name.
  3. Review the behavior's Definition and edit it if needed. A precise definition helps the guardrail detect the behavior.
  4. Under THEN, set the severity (High, Medium or Low) and choose the action:
    • Allow: Permit the behavior without restriction.
    • Warn: Display a customizable warning message to the user.
    • Block: Block the behavior, with an optional message to the user.
    • Route: Redirect the prompt to a specific model for specialized handling (e.g., route technical queries to an internal support model).
  5. Type a message or pick a saved one, or choose the destination model for Route.
  6. Save the configuration.
  7. Test the policy in a controlled environment to ensure it behaves as expected.

Generate rules from a Purpose

When the guardrail has no rules yet, WitnessAI can draft a starting set for you.
  1. In the Purpose field, describe the policy: the industry or domain, who it applies to, and the behavior you want to control.
  2. Click Create it for Me. The button appears only while there are no rules, and it stays disabled until you enter a Purpose.
  3. Review the summary of the proposed rules, then click Keep to accept them or Undo to discard them.
  4. Adjust any rule by hand, then save.

Refine rules with AI

Once you have rules, click Refine All Rules to have WitnessAI improve the whole set against your Purpose. Review the proposed changes, then click Keep, Undo or Try Again.

Add more than one behavior to a rule

In an open rule, click Add Behavior, choose the behavior and review its Definition. All behaviors in a rule share that rule's severity and action. To give behaviors different outcomes, add separate rules.

The For all other behaviors rule

The last rule, For all other behaviors, applies to prompts that no other rule matches. Set it to Allow to let everything else through, or to Block to stop everything you did not explicitly allow.
Note: When a rule lists more than one behavior, they have an implied “OR” relationship: a prompt that matches any of them gets that rule's outcome.
 

Best Practices

  • Rule order: when a guardrail has several rules, it evaluates the prompt against each rule from top to bottom, and the first rule that matches applies its action. Rules lower down the list are not evaluated for that prompt.
  • Behavior Routing: Define clear rules for routing prompts to appropriate models based on detected behaviors.
  • Customization: Use the customizable warning feature to provide context-specific guidance.
  • Testing: Always test policies and guardrails in a controlled environment before deploying them organization-wide.