Risk Analysis

Risk Analysis

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

Risk Analysis guardrail

Risk Analysis is WitnessAI’s prompt risk analysis and control guardrail. Its primary purpose is to analyze user prompts to detect potential risks and assess their severity. This guardrail identifies activities that may harm the user or the business by evaluating prompts across multiple topics, such as Data Theft, Harmful Code Generation, Violence, and other high-risk areas.
When these types of activities are detected, administrators can configure the guardrail to Allow, Warn, or Block prompts and provide a customizable message to guide or inform the user.
WitnessAI Policies leverage the Risk Analysis guardrail to ensure safe, ethical, and compliant use of AI, protecting both users and organizational integrity.
 

Use Cases

Preventing Data Exfiltration

Warn or block prompts that attempt to extract sensitive information, such as proprietary algorithms or confidential business data.

Mitigating Harmful Code Risks:

Detect prompts that generate harmful or insecure code and notify the user to review their request.

Violence Prevention:

Block or warn users attempting to generate violent or harmful content, ensuring adherence to ethical and safety standards.

Risk Profiling:

Provide risk level analysis for user prompts to inform administrators about trends or emerging threats.
 

Using Risk Analysis guardrail Step-by-Step

Step 1: Create a New Policy
  1. In the left-side menu, click Policy, then Policies.
  2. Click Add New Policy.
  3. Enter a Policy Name and Policy Description (e.g., "High-Risk Prompt Monitoring Policy").
  4. Click Continue.
See Policy Creation for the full steps.
Step 2: Choose Who the Policy Applies To
  1. Open the Sources & Destinations tab.
  2. In the Source section, choose Groups or Users and pick the user groups or users.
  3. In the Destination section, choose the providers, models, applications or lists the policy covers.
Step 3: Configure the Risk Analysis guardrail
  1. Go to the Guardrails tab in the policy editor.
  2. Select Risk Analysis from the list of available guardrails.
  3. Enable the guardrail for the policy.
The Risk Analysis guardrail configured in a policy.
The Risk Analysis guardrail configured in a policy.
Step 4: Define guardrail Actions
  1. Specify the action to take when the Risk Analysis guardrail detects risky prompts:
  • Allow: Permit the prompt to proceed without restriction.
  • Warn: Display a customizable warning message to alert the user about potential risks.
  • Block: Prevent the prompt from being processed by the model and provide an explanatory message.
  1. Customize the associated message to provide relevant guidance or warnings.
  • Example Message: “The detected prompt poses a risk of harmful code generation. This activity is blocked. Please contact your administrator for more information.”
  1. Save the configuration.
Step 5: Select Risk Types
  1. Click Add Risk Type to open the Select Risk Types panel.
  2. Expand a category and choose the risk types this rule should detect, for example:
  • Malicious Intent, with child types such as Illegal Activities and Self Harm.
  • Harmful Content, with child types such as Hate Speech, Violence and Bias & Discrimination.
  • Sensitive Content.
  1. Click Save in the panel.
  2. Under Set severity to, choose the rule's severity: High, Medium or Low.
  3. To track another group of risk types at a different severity, click Add Rule and repeat. The action and message from Step 4 apply to every rule.
WitnessAI maintains the list of risk types, so the categories you see can vary by tenant.
The Select Risk Types panel, with the Malicious Intent, Harmful Content and Sensitive Content categories expanded to show their child risk types.
The Select Risk Types panel, with the Malicious Intent, Harmful Content and Sensitive Content categories expanded to show their child risk types.
Step 6: Test and Save the Policy
  1. Test the policy configuration in a controlled environment to ensure it detects and handles risky prompts as expected.
  2. Once verified, save the policy to activate the Risk Analysis guardrail for the assigned User Groups.
 

Best Practices

  • Severity Review: Regularly review the risk types and severities in your rules to match evolving organizational needs.
  • User Communication: Use customized warning messages to educate users on acceptable prompts and potential risks.
  • Comprehensive Testing: Validate the Risk Analysis guardrail configuration in test environments before deployment.
  • Policy Documentation: Keep detailed records of risk settings and policy actions for compliance purposes.
By employing the Risk Analysis guardrail, organizations can proactively monitor and control user interactions with AI, reducing potential harm and ensuring safe and ethical use. This guardrail provides the flexibility to tailor risk management strategies to organizational requirements, safeguarding both users and business assets.