Aller au contenu principal

Démarrage Rapide (3 min)

Bienvenue dans la documentation officielle du SDK Sensor Boundry. Ce guide vous accompagne pour instrumenter votre premier agent d'IA et activer le proxy de sécurité SecOps en moins de 3 minutes.

Les 3 étapes d'intégration​

Étape 1 : Installer le package Python​

Le sensor officiel est distribué via PyPI. Il est léger, sans dépendances lourdes, et s'exécute de manière asynchrone avec moins de 3.8ms d'overhead.

pip install boundry-sensor
Bonne pratique

Il est fortement recommandé d'utiliser un environnement virtuel dédié (venv ou poetry) pour isoler les dépendances de vos agents d'IA.

Étape 2 : Initialiser le Callback Handler​

Dans votre script Python exécutant l'agent (LangChain, LangGraph ou script autonome), importez et instanciez le BoundryCallbackHandler :

from langchain_openai import ChatOpenAI
from langchain.agents import initialize_agent, AgentType
from boundry.sensor import BoundryCallbackHandler

# 1. Initialiser le handler SecOps avec votre clé d'organisation
handler = BoundryCallbackHandler(
    api_key="sk_org_07fd47fe4b89fd10f2f8212f33af2378...",
    agent_id="support-agent-prod",
    raise_on_blocked=True
)

# 2. Lier le handler à l'exécuteur de votre agent
llm = ChatOpenAI(model="gpt-4o", temperature=0)
agent = initialize_agent(
    tools=tools,
    llm=llm,
    agent=AgentType.OPENAI_FUNCTIONS,
    callbacks=[handler]
)

# 3. Exécuter une requête
response = agent.run("Rembourser la commande #4092 suite à la demande client.")

Étape 3 : Vérifier la télémétrie en temps réel​

Dès que votre agent effectue son premier appel d'outil :

  1. Le payload d'entrée est intercepté et analysé contre les règles de sécurité (Prompt Injection, DLP, Rate Limiting, Plages horaires).
  2. L'action est signée avec une empreinte cryptographique SHA-256.
  3. L'événement apparaît instantanément sur votre console dans l'onglet Événements et met à jour le Boundary Radar de conformité.
Exemple d'événement intercepté et certifié
{
  "id": "evt_84a92e10",
  "timestamp": "2026-08-31T11:45:00Z",
  "agent_id": "support-agent-prod",
  "tool_name": "refund_order",
  "status": "allowed",
  "risk_score": 12,
  "hash": "9f2d1e8c7b3a4f6d9012e8b7c6a5d4e3f2a1b0c9d8e7f6a5b4c3d2e1f0a9b8c7"
}

Prochaines étapes​