Documentation
Journal des modifications

7 mai 2026

Utilisez vos agents avec n’importe quel SDK OpenAI — Mise à jour du 7 mai 2026

Compatibilité totale, sans friction

Les agents Swiftask sont désormais entièrement compatibles avec le SDK OpenAI. Vous pouvez utiliser n’importe quelle bibliothèque cliente OpenAI (Python, JavaScript, Node.js ou autres) pour envoyer des messages à vos agents et recevoir des réponses, exactement comme vous le feriez avec les modèles d’OpenAI. Aucune intégration spécifique nécessaire, il suffit de pointer le SDK vers le point d’accès API de Swiftask, de vous authentifier, et c’est parti.

Compatibilité du SDK OpenAI pour les agents

Vos agents Swiftask fonctionnent désormais parfaitement avec le SDK OpenAI. Cela signifie que vous pouvez exploiter l’interface familière d’OpenAI, celle que votre équipe connaît déjà, tout en l’alimentant avec vos agents personnalisés, vos bases de connaissances et vos compétences.

Que vous intégriez des agents dans des applications existantes, automatisiez le traitement de documents, ou construisiez des expériences de chat en temps réel, la compatibilité avec le SDK OpenAI rend cela très simple.

Base URL : https://api.swiftask.fr/v1

Authentification : Utilisez votre clé API Swiftask existante (générez-en une dans Paramètres du compte → API)

Paramètre de modèle : Spécifiez le slug de votre agent (disponible dans Paramètres de l’agent → onglet API)

SDK supportés : Python, JavaScript, TypeScript, Node.js et tout autre client compatible OpenAI

Streaming : Prise en charge complète des réponses en temps réel via Server-Sent Events (SSE)

Comment tester :

  1. Créez une clé API : Allez dans Paramètres du compte → API → Créer une nouvelle clé. Copiez-la immédiatement (affichée une seule fois). Vous pouvez définir une date d’expiration pour plus de sécurité.

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

  3. Installez le SDK d’OpenAI : Exécutez pip install openai (Python) ou npm install openai (JavaScript).

  4. Configurez et appelez votre agent : Exemple rapide en 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="SLUG_AGENT", messages=[{"role": "user", "content": "Bonjour, comment pouvez-vous m’aider ?"}] ) print(response.choices[0].message.content)

Et le même en JavaScript :

import OpenAI from 'openai'; const client = new OpenAI({ apiKey: 'VOTRE_CLE_API', baseURL: 'https://api.swiftask.fr/v1', }); const response = await client.chat.completions.create({ model: 'SLUG_AGENT', messages: [{ role: 'user', content: 'Bonjour, comment pouvez-vous m’aider ?' }] }); console.log(response.choices[0].message.content);

Activer le streaming (optionnel) : Pour des réponses en temps réel, définissez stream=True (Python) ou stream: true (JavaScript). La réponse sera diffusée caractère par caractère, offrant un retour immédiat aux utilisateurs.

Cas d’usage pratiques

  • Intégrez les agents dans des chatbots de support : Vous avez un agent support client dans Swiftask et souhaitez l’utiliser dans votre application Node.js existante. Maintenant, vous pouvez utiliser directement le SDK OpenAI, sans code personnalisé.

  • Traitement par lots de documents : Traitez des centaines de documents avec votre agent d’analyse documentaire via une simple boucle Python. L’agent traite chaque document et renvoie des résultats structurés.

  • Diffusez les réponses dans des applications web : Affichez les réponses des agents en temps réel sur votre page web. Le streaming rend l’expérience plus rapide et interactive.

Bonnes pratiques

  • Sécurisez votre clé API : Traitez-la comme un mot de passe. Stockez-la dans des variables d’environnement ou des outils de gestion des secrets, jamais en dur dans le code.

  • Définissez des dates d’expiration : Lors de la création d’une clé API, fixez une date d’expiration pour des raisons de sécurité. Renouvelez les clés périodiquement.

  • Utilisez des noms de clés descriptifs : Nommez vos clés selon leur usage (ex. « Bot Production », « Bot Test ») pour suivre leur utilisation et gérer l’accès.

  • Gérez les erreurs avec soin : Encapsulez les appels API dans des blocs try-catch et fournissez des messages d’erreur clairs aux utilisateurs.

  • Utilisez le streaming pour une meilleure expérience utilisateur : Les réponses en streaming semblent plus rapides car le contenu apparaît en temps réel, au lieu d’attendre la réponse complète.

Commencez dès maintenant

Prêt à utiliser vos agents avec le SDK OpenAI ?

Rendez-vous dans Paramètres du compte → API, créez votre clé, récupérez le slug de votre agent, et commencez à développer.

Vos agents sont désormais aussi simples à intégrer que les modèles GPT d’OpenAI. 🎯

Plus d’informations : https://docs.swiftask.ai/

Écrire un commentaire...