​
Step 1: Setting API Key

Set up your Future AGI account and get started with Future AGI’s robust SDKs. Follow the QuickStart guide:

Click here to learn how to access your API key.

​
Step 2: Installation and Setup

To begin using Protect initialize the Protect instance. This will handle the communication with the API and apply defined safety checks.

import os
from fi.evals import Protect

protector = Protect(fi_api_key=os.getenv("FI_API_KEY"),
                    fi_secret_key=os.getenv("FI_SECRET_KEY")) 
# Optional, if you want to set the API key and secret key manually

Replace "FI_API_KEY" and "FI_SECRET_KEY" with your actual credentials before executing the code.

The Protect Client let’s you initialize protect.

​
Step 3: Define Protect Rules

The Protect accepts several arguments and rules to configure your protection checks.

​
🔧 Arguments

ArgumentTypeDefault ValueDescription
inputstring—Input text to be evaluated. This may be simple text, an audio url or a local audio file path
protect_rulesList[Dict]—Rules to apply on input
actionstringCustom failure messageMessage shown on failure
reasonboolFalseInclude failure reason in output
timeoutint0.3Max time (in seconds) allowed for checks

​
Defining Rules

Rules are defined as a list of custom Protect metrics. Each metric is a dictionary with fixed keys.

KeyRequiredTypeValuesDescription
metric✅stringToxicity, Tone, Sexism, Prompt Injection, Data PrivacyWhich metric to apply
containsTone onlylist[string]"neutral", "joy", "love", "fear", "surprise", "sadness", "anger", "annoyance", "confusion"Values to check for (e.g., ["anger", "sadness"])
typeTone onlystringany, allMatch if any or all values match

Example Rule Set:

rules = [
    {
        "metric": "Tone",
        "contains": ["anger", "fear"],
        "type": "any"
    },
    {
        "metric": "Toxicity"
    }
]

Evaluation stops as soon as one rule fails.

​
Understanding the Outputs

When a check is run, a response dictionary is returned with detailed results.

KeyTypeDescription
statusstring (passed / failed)Result of rule evaluation
messagesstringFinal message or original input.
completed_ruleslist[string]Successfully completed rules
uncompleted_ruleslist[string]Rules skipped due to early failure or timeout
failed_rulestring / NoneWhich rule caused failure
reasonstringExplanation of failure
time_takenfloatTime taken (seconds)
{
    'status': 'passed',
    'completed_rules': ['Toxicity', 'Tone'],
    'uncompleted_rules': [],
    'messages': 'I like apples',
    'reason': 'All checks passed',
    'time_taken': 0.00001
}

​
Examples by Metric

rules = [{'metric': 'Toxicity'}]
action = "This message cannot be displayed"

result = protector.protect(
    "This is a test message",
    protect_rules=rules,
    action=action,
    reason=True,
    timeout=25
)
print(result)

Optionally You can directly use the protect function

from fi.evals import protect

result = protect(
    "This is my input string",
    protect_rules=rules,
    action="I cannot process this request",
    reason=True,
    timeout=50
)
print(result)

The protect function is a shortcut for the Protect class. Please configure the FI_API_KEY and FI_SECRET_KEY environment variables before using the protect function.

​
Multiple Rules Example

rules = [
    {'metric': 'Toxicity'},
    {'metric': 'Prompt Injection'},
    {
        'metric': 'Tone',
        'contains': ['anger', 'annoyance'],
        'type': 'all'
    },
    {'metric': 'Data Privacy'},
    {'metric': 'Sexism'}
]

result = protector.protect(
    "This is my input string",
    protect_rules=rules,
    action="I cannot process this request",
    reason=True,
    timeout=50
)
print(result)

​
Audio support in Protect

Our Protect feature also supports audio inputs, without making any additional changes. To run protect for audio inputs users send audio urls or local audio file paths as simple strings. Our system automatically identifies audio inputs and processes them accordingly

​
Toxicity (audio)

rules = [{'metric': 'Toxicity'}]
action = "This message cannot be displayed"

result = protector.protect(
    "AUDIO URL / LOCAL AUDIO FILE PATH",
    protect_rules=rules,
    action=action,
    reason=True,
    timeout=25
)
print(result)