Documentation développeur DefendAI

Créez, signez et publiez des agents IA qui s'intègrent automatiquement au Defender Core et au Defender Store, sans modifier le cœur de la plateforme.

1. Le manifeste d'agent

Un agent DefendAI est décrit par un manifeste. Les capabilities sont lues par le Defender Core : c'est grâce à elles qu'il mobilise automatiquement votre agent lorsqu'une demande utilisateur y correspond. Aucune inscription manuelle dans le noyau n'est nécessaire.

import { defineAgent } from "@defenderai/sdk";

export default defineAgent({
  slug: "energie-verte",
  name: "Énergie Verte",
  tagline: "Réduit votre facture d'électricité",
  description: "Analyse vos factures d'énergie et compare les offres du marché.",
  category: "maison",
  mode: "home",
  icon: "Zap",
  version: "1.0.0",
  permissions: ["documents", "reminders"],
  capabilities: [
    "Analyser une facture d'électricité ou de gaz",
    "Comparer deux offres fournisseur",
    "Préparer une lettre de résiliation",
  ],
  credit_cost: 3,
  pricing_model: "free",
});

2. Le SDK officiel

Le SDK est isomorphe (navigateur, Node, edge) et sans dépendance.

import {
  defineAgent,        // valide et normalise un manifeste
  validateManifest,   // idem, lève ManifestError
  inspectManifest,    // retourne la liste des problèmes
  normalizeManifest,  // applique les valeurs par défaut
  createDefenderClient,
  SDK_VERSION,
} from "@defenderai/sdk";

const client = createDefenderClient();
const { items } = await client.listAgents({ mode: "home", limit: 20 });
const { agent } = await client.getAgent("energie-verte");
const schema = await client.getManifestSchema();

3. API publique

Lecture seule, sans clé, CORS ouvert, réponses mises en cache 5 minutes.

Endpoint	Description
GET /api/public/agents	Catalogue publié. Paramètres : `mode`, `category`, `limit` (max 200).
GET /api/public/agents/:slug	Fiche détaillée d'un agent publié.
GET /api/public/agents/schema	Schéma du manifeste et version du SDK.

curl https://mydefendai.com/api/public/agents?mode=business&limit=5

Codes de retour : 200 succès · 400 slug invalide · 404 agent introuvable · 503 catalogue temporairement indisponible.

4. Publier votre agent

Créez votre profil développeur dans le portail Marketplace.
Déposez votre manifeste : il est signé côté serveur (SHA-256) et horodaté.
Notre équipe vérifie les permissions demandées et la description des capacités.
Après validation, l'agent apparaît dans le Defender Store et devient installable ; le Defender Core le prend en compte immédiatement pour le routage des demandes.

5. Bonnes pratiques

Demandez le minimum de permissions : chaque permission est validée par l'utilisateur.
Décrivez des capacités concrètes et distinctes : elles conditionnent la qualité du routage multi-agents.
Respectez le versionnage semver : chaque version publiée est historisée.
N'annoncez jamais une action réelle (appel, paiement, envoi) : le Core exige la validation explicite de l'utilisateur pour les actions sensibles.