Get started

Configure Quasentra safely.

Create a scoped API key in Dashboard → API keys. Copy it once and keep it on the server—never in browser JavaScript, source control or an agent prompt.

1. Install the matching package extra

pip install quasentra
# Choose one framework extra when required:
pip install 'quasentra[langgraph]'
pip install 'quasentra[crewai]'
pip install 'quasentra[openai-agents]'

2. Set environment variables

# .env — do not commit this file
QUASENTRA_API_KEY=ask_live_replace_me
QUASENTRA_URL=https://quasentra.com
AGENT_MODEL=provider:model-name

Load these values through your deployment platform or secret manager. The Python SDK reads the values you pass to Quasentra; it does not need the key inside tool arguments.

3. Create one reusable client

import os
from quasentra import Quasentra

security = Quasentra(
    api_key=os.environ["QUASENTRA_API_KEY"],
    base_url=os.environ["QUASENTRA_URL"],
    timeout_seconds=5,
    max_retries=2,
)

API-key scopes

  • agent:register registers discovered agents and tools.
  • policy:sync synchronizes code-declared permissions.
  • decision:create authorizes each intercepted tool call.
  • tool:execute is required only for server-side gateway connectors.

Keep keys narrow

Restrict a key to the agent IDs used by that service. Use separate keys for development, staging and production, and revoke a key immediately if it is exposed.