1
Compte
2
Clé API
3
Intégration
4
Vérification

Connectez votre agent IA

Créez votre compte et obtenez votre clé en 60 secondes.

👤 Étape 1 — Créer votre compte

Vous avez déjà un compte ? Se connecter

Votre clé API est prête

Sauvegardez-la maintenant — elle ne sera plus visible après cette page.

🔑 Étape 2 — Votre clé API

sk_live_...
⚠️ Sauvegardez cette clé — elle ne sera plus visible après.
Collez-la dans vos variables d'environnement maintenant : SOPHRA_API_KEY=sk_live_xxx
Cette clé authentifie vos appels vers l'API Sophra. Elle lie vos agents à votre compte et leur permet d'envoyer des métriques de santé en temps réel. Traitez-la comme un mot de passe — ne la commitez pas dans votre dépôt.

Intégrez en 2 lignes

Pas de npm install. Copiez le SDK et commencez à envoyer des données.

Étape 3 — Ajouter à votre agent

  • Zéro dépendance — un seul fichier JS
  • Fonctionne en Node.js et dans le navigateur
  • Retry automatique avec backoff exponentiel
Node.js
Browser
cURL
// 1. Télécharger le SDK
// wget https://www.sophra.me/sdk/sophra-sdk.js

const sophra = require('./sophra-sdk');

// 2. Initialiser avec votre clé
sophra.init({
  apiKey: process.env.SOPHRA_API_KEY  // sk_live_xxx
});

// 3. Envoyer vos premières métriques
await sophra.reportVitals({
  agentId: 'my-first-agent',
  agentName: 'Mon Premier Agent',
  metrics: {
    tokenConsumption: 500,
    responseTime:    200,
    hallucinationRate: 0.01,
    loopCount:        0,
    conflictCount:    0
  }
});
Clé active : sk_live_xxx

Vérification

On vérifie que vos données ont bien été reçues.

📡 Étape 4 — Détection de votre agent

Dès que vous exécutez le code ci-dessus avec votre clé, votre agent apparaîtra sur le dashboard en temps réel.

✅ Agent détecté !

Vos données ont bien été reçues. Votre agent est en ligne sur le dashboard.

⏳ Pas encore reçu...

Vérifiez que votre clé est correcte et que le code a bien été exécuté, puis réessayez.

🔧 Dépannage — rien reçu ?
  • La clé dans votre code correspond-elle à sk_live_... ?
  • Vérifiez que sophra.init({ apiKey: '...' }) est appelé avant reportVitals()
  • Consultez la console Node.js pour des erreurs de réseau
  • Testez avec cURL : curl -H "Authorization: Bearer YOUR_KEY" https://www.sophra.me/api/keys/check-vitals