Superagent | Respan Docs

Set up Respan

Sign up — Create an account at platform.respan.ai
Create an API key — Generate one on the API keys page
Add credits or a provider key — Add credits on the Credits page or connect your own provider key on the Integrations page

Use AI

Add the Docs MCP to your AI coding tool to get help building with Respan. No API key needed.

1 {
2   "mcpServers": {
3     "respan-docs": {
4       "url": "https://mcp.respan.ai/mcp/docs"
5     }
6   }
7 }

What is Superagent?

Superagent is a safety guardrails platform that provides guard, redact, scan, and test operations for LLM applications. The Respan exporter wraps these calls to capture them as tool spans.

Setup

Install packages

$ pip install safety-agent respan-exporter-superagent

Set environment variables

$ export RESPAN_API_KEY="YOUR_RESPAN_API_KEY"

Use the Respan client

1 from respan_exporter_superagent import create_client
2 
3 # Create a Respan-instrumented Superagent client
4 client = create_client(api_key="your-api-key")
5 
6 # Operations are automatically traced
7 result = await client.guard(
8     respan_params={"customer_identifier": "user-123"},
9     input="Check this content for safety",
10 )
11 print(result)

View your trace

Open the Traces page to see your safety operations.

Configuration

Parameter	Type	Default	Description
`api_key`	`str`	`RESPAN_API_KEY` env var	Respan API key.
`base_url`	`str \| None`	`None`	API base URL.

See the Superagent Exporter SDK reference for the full API.

Attributes

Pass Respan-specific params to each operation:

1 result = await client.guard(
2     respan_params={
3         "customer_identifier": "user-123",
4         "metadata": {"source": "api", "version": "2.0"},
5     },
6     input="Check this content",
7 )

Attribute	Description
`customer_identifier`	User/customer identifier.
`metadata`	Custom key-value pairs.
`disable_log`	Set `True` to skip logging this call.