How to
How to Use Future AGI Protect
Step 1: Setting API Key
Set up your Future AGI account and get started with Future AGIβs robust SDKs. Follow the QuickStart guide:
π Quickstart Guide
Step 2: Installation and Setup
To begin using Protect, initialize the Future AGI evaluation client along with the Protect client. These clients handle communication with the API and apply defined safety checks.
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 ProtectClient
accepts several arguments and rules to configure your protection checks.
π§ Arguments
Argument | Type | Default Value | Description |
---|---|---|---|
input | string | β | Input text to be evaluated. This may be simple text, an audio url or a local audio file path |
protect_rules | List[Dict] | β | Rules to apply on input |
action | string | Custom failure message | Message shown on failure |
reason | bool | False | Include failure reason in output |
timeout | int | 0.3 | Max 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.
Key | Required | Type | Values | Description |
---|---|---|---|---|
metric | β | string | Toxicity , Tone , Sexism , Prompt Injection , Data Privacy | Which metric to apply |
contains | Tone only | list[string] | Depends on metric | Values to check for (e.g., ["anger", "sadness"] ) |
type | Tone only | string | any , all | Match if any or all values match |
Example Rule Set:
Evaluation stops as soon as one rule fails.
Understanding the Outputs
When a check is run, a response dictionary is returned with detailed results.
Key | Type | Description |
---|---|---|
status | string (passed / failed ) | Result of rule evaluation |
messages | string | Final message or original input. |
completed_rules | list[string] | Successfully completed rules |
uncompleted_rules | list[string] | Rules skipped due to early failure or timeout |
failed_rule | string / None | Which rule caused failure |
reason | string | Explanation of failure |
time_taken | float | Time taken (seconds) |
Examples by Metric
Multiple Rules Example
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