Aller au contenu principal

FAQ

Général​

Qu'est-ce que Sinaptic® DROID+ ?​

Sinaptic® DROID+ est un moteur d'exécution d'agents IA sans interface (headless). Tout comme nginx sert des sites web, Sinaptic® DROID+ sert des agents IA. Vous définissez les agents dans des configurations YAML, et Sinaptic® DROID+ les expose via une API compatible OpenAI. Un seul binaire, n'importe quel fournisseur de LLM, sécurité intégrée.

Sinaptic® DROID+ est-il open source ?​

Sinaptic® DROID+ Community Edition est disponible en accès source sous la licence Business Source License 1.1 (BSL 1.1). Il est gratuit pour un usage interne avec jusqu'à 2 agents. La licence se transforme en Apache 2.0 après la date de changement. Les éditions Pro et Enterprise sont sous licence commerciale.

Quelle est la différence entre Community, Pro et Enterprise ?​

Consultez la Comparaison des éditions pour une matrice complète des fonctionnalités. En résumé : Community est gratuit avec jusqu'à 2 agents et une sécurité basée sur RegExp. Pro supprime les limites d'agents et ajoute la cascade complète de sécurité SinapticAI. Enterprise ajoute le multi-tenancy, des fonctionnalités de conformité et un support SLA.

Dois-je payer pour l'édition Community ?​

Non. L'édition Community est gratuite à vie pour un usage interne avec jusqu'à 2 agents. Pas d'enregistrement, pas de télémétrie, pas de limites d'utilisation sur les appels API.

Installation & Configuration​

Quelles sont les configurations système requises ?​

Sinaptic® DROID+ est un binaire Go unique sans dépendances externes. Il fonctionne sur Linux (amd64/arm64), macOS (Intel/Apple Silicon) et Windows. L'utilisation de la mémoire dépend de votre charge de travail, mais 128 Mo suffisent pour des configurations de base.

Puis-je exécuter Sinaptic® DROID+ sans Docker ?​

Oui. Sinaptic® DROID+ est un binaire autonome. Téléchargez-le depuis les releases GitHub, rendez-le exécutable et lancez droid up. Docker est optionnel.

Comment mettre à jour Sinaptic® DROID+ ?​

Pour les installations binaires, téléchargez la nouvelle version et remplacez le binaire. Pour Docker, docker pull sinapticai/droid:latest && docker compose up -d. Vos fichiers de configuration et vos données sont séparés du binaire, les mises à jour ne sont donc pas destructives.

Fournisseurs de LLM​

Quels fournisseurs de LLM sont pris en charge ?​

Les 7 fournisseurs sont disponibles dans chaque édition : OpenAI, Anthropic (Claude), Google Gemini, xAI Grok, Ollama, LM Studio et llama.cpp. Les fournisseurs cloud nécessitent des clés API. Les fournisseurs locaux (Ollama, LM Studio, llama.cpp) ne nécessitent aucune clé.

Puis-je utiliser différents modèles pour différents agents ?​

Oui. Chaque agent spécifie son propre model.provider et model.name. Vous pouvez exécuter un agent sur GPT-4o, un autre sur Claude Sonnet et un troisième sur un modèle Ollama local — le tout à partir de la même instance Sinaptic® DROID+.

Puis-je utiliser Sinaptic® DROID+ avec mes propres modèles fine-tunés ?​

Oui. Si votre modèle fine-tuné est servi via une API compatible OpenAI (ce que la plupart des fournisseurs prennent en charge), Sinaptic® DROID+ peut l'utiliser. Il suffit de configurer le bon base_url et le nom du modèle.

Sinaptic® DROID+ envoie-t-il mes données quelque part ?​

Sinaptic® DROID+ envoie vos prompts uniquement au fournisseur de LLM que vous avez configuré. Il n'y a pas de télémétrie, pas d'analyse et pas de collecte de données par Sinaptic® DROID+ lui-même. Lorsque vous utilisez des modèles locaux (Ollama, LM Studio, llama.cpp), tout reste sur votre machine.

Sécurité​

Qu'est-ce que SinapticAI ?​

SinapticAI est un pare-feu d'intention IA intégré à Sinaptic® DROID+. Il inspecte les prompts et les réponses en temps réel pour détecter et bloquer les attaques par injection de prompt, les tentatives de jailbreak et les fuites de PII (données personnelles). Voir l' aperçu de SinapticAI pour plus de détails.

Quelles attaques l'édition Community détecte-t-elle ?​

L'édition Community inclut la couche de sécurité RegExp, qui capture environ 70 % des vecteurs d'attaque connus : schémas courants d'injection de prompt, modèles de jailbreak connus, tentatives d'extraction de prompt système et schémas de PII (emails, numéros de téléphone, cartes bancaires).

Puis-je désactiver SinapticAI pour des agents spécifiques ?​

Oui. Définissez sinaptic.enabled: false dans la configuration YAML de l'agent. Le paramètre global dans droid.yaml contrôle la valeur par défaut.

Mes données sont-elles traitées localement pour les contrôles de sécurité ?​

Oui. Tous les contrôles SinapticAI sont exécutés localement à l'intérieur de votre instance Sinaptic® DROID+. Aucune donnée n'est envoyée à des services externes pour l'analyse de sécurité.

API & Intégration​

L'API est-elle vraiment compatible OpenAI ?​

Oui. Sinaptic® DROID+ implémente le point de terminaison /v1/chat/completions avec le même format de requête/réponse que l'API d'OpenAI. Vous pouvez utiliser le SDK OpenAI officiel dans n'importe quel langage — il suffit de changer le base_url pour votre instance Sinaptic® DROID+.

Comment authentifier les requêtes API ?​

Par défaut, aucune authentification n'est requise (mode développement local). Pour la production, configurez une clé API dans droid.yaml :

server:
  api_key: "votre-clé-secrète"

Puis passez-la dans les requêtes via l'en-tête Authorization: Bearer votre-clé-secrète, tout comme avec OpenAI.

Puis-je utiliser Sinaptic® DROID+ comme remplacement direct d'OpenAI ?​

Oui. Définissez le base_url sur votre instance Sinaptic® DROID+ et utilisez n'importe quel nom d'agent comme paramètre model. Le format de réponse est identique à celui d'OpenAI.

Agents​

Quelle est la limite d'agents dans l'édition Community ?​

L'édition Community prend en charge jusqu'à 2 agents. Si vous en avez besoin de plus, passez à Pro (agents illimités). La limite porte sur les agents chargés simultanément, pas sur le nombre total de configurations.

Puis-je recharger les agents à chaud sans redémarrer ?​

Oui. Sinaptic® DROID+ surveille le répertoire des agents pour détecter les changements. Lorsque vous modifiez la configuration YAML d'un agent, il est automatiquement rechargé sans redémarrer le serveur ni interrompre les connexions actives.

Quels outils les agents peuvent-ils utiliser ?​

Les agents peuvent utiliser des outils intégrés (current_time, etc.), des outils d'API REST (appel de n'importe quel point de terminaison HTTP) et des outils MCP (Model Context Protocol pour des intégrations extensibles comme la recherche web, l'accès aux fichiers, les bases de données). Voir le guide MCP.

Déploiement​

Quels ports Sinaptic® DROID+ utilise-t-il ?​

Le port 8080 pour l'API compatible OpenAI et le port 8081 pour l'API de gestion et l'interface Agent Builder. Les deux sont configurables dans droid.yaml.

Dois-je exposer l'API de gestion publiquement ?​

Non. Le port 8081 fournit des fonctionnalités d'administration et l'interface Agent Builder. Gardez-le sur un réseau interne ou derrière une authentification en production.

Puis-je exécuter plusieurs instances de Sinaptic® DROID+ ?​

Oui. Chaque instance est sans état (au-delà de ses fichiers de configuration et de son répertoire de données). Vous pouvez exécuter plusieurs instances derrière un équilibreur de charge. Pour les déploiements coordonnés multi-instances, l'édition Enterprise propose des fonctionnalités de clustering et de haute disponibilité (HA).

Dépannage​

Sinaptic® DROID+ démarre mais les agents ne se chargent pas​

Vérifiez que vos fichiers YAML d'agent se trouvent dans le répertoire spécifié par agents_dir dans droid.yaml (par défaut : ./configs/agents/). Exécutez droid agents pour voir les agents chargés.

"Connection refused" lors de l'appel à l'API​

Assurez-vous que Sinaptic® DROID+ est en cours d'exécution (droid health) et que vous utilisez le bon port (par défaut 8080). Si vous utilisez Docker, assurez-vous que les ports sont correctement mappés.

Les appels LLM échouent avec des erreurs d'authentification​

Vérifiez que votre clé API est correctement définie. Vérifiez avec echo $OPENAI_API_KEY (ou la variable correspondante). La configuration prend en charge la syntaxe ${VAR} — assurez-vous que la variable d'environnement est disponible pour le processus Sinaptic® DROID+.