Skip to navigation
IntegrationIntegrationsAgent Frameworks

Superagent (gateway)

Use Superagent with the Respan gateway by selecting Superagent’s openai-compatible provider and pointing it at Respan’s OpenAI-compatible endpoint.

Setup

1

Install packages

pip install safety-agent python-dotenv
2

Set environment variables

export RESPAN_API_KEY="YOUR_RESPAN_API_KEY"
export SUPERAGENT_API_KEY="YOUR_SUPERAGENT_API_KEY"
export OPENAI_COMPATIBLE_API_KEY="$RESPAN_API_KEY"
export OPENAI_COMPATIBLE_BASE_URL="https://api.respan.ai/api"
export OPENAI_COMPATIBLE_SUPPORTS_STRUCTURED_OUTPUT="true"
3

Run a gateway-backed safety check

import asyncio
import os
from safety_agent import create_client
client = create_client(api_key=os.environ["SUPERAGENT_API_KEY"])
async def main() -> None:
    result = await client.guard(
        input="Check this message for prompt injection.",
        model="openai-compatible/gpt-5.5",
    )
    print(result)
asyncio.run(main())

guard and redact are coroutines, so call them with await. The model call goes from your process straight to the Respan gateway; only usage reporting goes to Superagent.

Switch models

Change the model after the openai-compatible/ provider prefix.

await client.guard(input=message, model="openai-compatible/gpt-5.5")
await client.redact(input=message, model="openai-compatible/gpt-5-mini")

See the full model list.