Documentation
Journal des modifications

8 mai 2026

Déployez des agents IA de manière programmatique, sans interface utilisateur — Mise à jour Mai 2026

Vous pouvez désormais créer et gérer des agents IA directement depuis votre application via notre API REST. Au lieu de configurer les agents via l’interface, envoyez une seule requête API avec le nom de l’agent, sa description, son prompt système et ses messages d’accueil. Votre agent est créé, configuré et prêt à l’emploi instantanément.

Cette fonctionnalité est idéale pour les plateformes intégrant Swiftask, les produits SaaS proposant des agents en marque blanche, ou les équipes gérant un grand nombre d’agents sur différents projets.

API de création d’agent

Le nouvel endpoint de création d’agent vous permet d’automatiser le déploiement des agents. Définissez toutes les propriétés requises (nom, description en anglais et français, prompt système, messages d’accueil), envoyez une requête POST à https://api.swiftask.fr/admin/agent/create et recevez en réponse l’ID, le slug et le statut de votre agent.

  • Endpoint : POST https://api.swiftask.fr/admin/agent/create

  • Champs obligatoires : 6 propriétés (name, description, descriptionFR, systemPrompt, greetingMessage, greetingMessageFR)

  • Contraintes : Nom de l’agent limité à 100 caractères ; description limitée à 500 caractères

  • Réponse : ID de l’agent, slug, statut et timestamps de création

  • Compatibilité SDK : Compatible avec OpenAI SDK (Python, JavaScript, TypeScript, Node.js)

  • Streaming : Support complet des réponses en temps réel via Server-Sent Events (SSE)

  • Disponibilité : Tous les plans payants (Pro, Team Starter, Team Growth, Tailored) sans limites d’usage

  • Accès UI : Paramètres de l’agent → Onglet API

Comment tester :

  1. Créez une clé API : Paramètres du compte → API → Créer une nouvelle clé. Copiez-la immédiatement (affichée une seule fois).

  2. Ouvrez votre agent → Paramètres (icône roue dentée) → Onglet API → Copiez le slug de l’agent.

  3. Installez le SDK OpenAI : pip install openai (Python) ou npm install openai (JavaScript).

  4. Testez avec cet exemple Python :

    from openai import OpenAI client = OpenAI(api_key="VOTRE_CLE_API", base_url="https://api.swiftask.fr/v1") response = client.chat.completions.create( model="votre-agent-slug", messages=[{"role": "user", "content": "Message de test"}] ) print(response.choices[0].message.content)

  5. Vérifiez que l’agent répond correctement en utilisant sa base de connaissances et ses compétences configurées.

Cas d’usage :

  • Intégration plateforme : Intégrez la création d’agents Swiftask dans votre produit SaaS

  • Agents en marque blanche : Permettez à vos clients de déployer des agents IA brandés sans accès direct à Swiftask

  • Gestion de flotte : Automatisez la création et la configuration d’agents à l’échelle de votre organisation

  • Workflows personnalisés : Construisez des agents par programmation dans votre logique métier

Écrire un commentaire...