Conseils
Une page de conseils courts, tous vérifiables dans le produit ou dans le code.
Parlez en langage naturel
Il n'y a pas de syntaxe spéciale. Décrivez la tâche comme à un collègue : Chatbotaurus choisit l'outil du connecteur qui y répond. Plus la demande nomme l'objet (un client, une facture, un rendez-vous), plus le choix de l'outil est sûr.
Étendez avec des connecteurs
Chatbotaurus parle le protocole MCP. Chaque
service métier est un connecteur décrit par un fichier connectors/<id>.yaml.
Le dépôt en contient 195 (mesure du 2026-10-03 : ls connectors/*.yaml | wc -l).
Le chapitre Vue d'ensemble des connecteurs
présente le catalogue. Pour en écrire un, voir
Fichiers de configuration.
Les modèles tournent chez vous
L'inférence passe par Ollama, sur votre infrastructure. La liste des modèles
retenus est fixée dans crates/forge-core/src/model_governance.rs :
| Rôle | Modèle |
|---|---|
Traduction (rôle Main du code, jamais d'appel d'outil) | cas/eurollm-1.7b-instruct-q8 |
Génération : repli et défaut de OLLAMA_MODEL | ministral-3:3b |
Embeddings (calculés en local par fastembed) | paraphrase-multilingual-MiniLM-L12-v2 (vecteurs de 384 dimensions) |
Changer cette liste est une décision de souveraineté, pas un réglage : elle se
modifie avec une justification de licence. Le modèle de génération se choisit
avec OLLAMA_MODEL et le modèle d'embeddings du pipeline RAG avec
EMBEDDING_MODEL (voir
Variables d'environnement).
Gardez les sessions courtes
Une conversation longue remplit la fenêtre de contexte du modèle, et les réponses perdent en précision. Si elles deviennent moins pertinentes, ouvrez une nouvelle conversation. C'est un conseil d'usage, pas une mesure de ce dépôt.
Itérez sur vos demandes
Vous n'avez pas à trouver la bonne formulation du premier coup. Reformulez, précisez l'objet, relancez.
Profils du catalogue
Le catalogue regroupe ses serveurs en quatre profils :
| Profil | Contenu |
|---|---|
solo | 1 serveur : Odoo |
starter | 5 serveurs |
business | 12 serveurs |
enterprise | tous les serveurs du catalogue |
GET /api/v1/mcp/catalog-business/profiles les liste. La route
POST /api/v1/mcp/catalog-business/profiles/{name}/deploy existe, mais elle répond
aujourd'hui 503 FEATURE_PENDING : le pilotage de Podman par le backend n'est pas
branché, elle ne déploie rien. Le tutoriel
Parcourir le catalogue de services et préparer un déploiement
explique ce qui marche et ce qui est en sommeil.
Protégez vos données
- Les points d'accès de la voix doivent être dans l'UE : le code refuse les
autres (
validate_eu_endpoint,crates/forge-voice/src/stt.rs). - Le registre des connecteurs rejette un connecteur dont les données ne restent pas dans l'UE ou chez vous.
- Aucun secret n'est stocké dans les manifestes de connecteurs : ils lisent l'environnement.
- Les journaux masquent clés, jetons et adresses e-mail avant écriture.
Détails et limites : Sécurité.
Surveillez
Sondez GET /api/v1/readyz depuis votre supervision. Le chapitre
Supervision dit ce qui est mesuré aujourd'hui et ce qui ne
l'est pas encore.
Mettez à jour avec méthode
Si vous disposez des sources sous licence : récupérez les changements, puis reconstruisez le workspace.
git pull
cargo build --workspace --release
En développement, dx serve (lancé depuis crates/forge-ui) recharge le
frontend à chaque modification. Le backend se redémarre.
Voir aussi
- Variables d'environnement — régler le modèle, les embeddings et les points d'accès vocaux
- Fichiers de configuration — écrire ou corriger le manifeste YAML d'un connecteur
- Contribuer — construire, vérifier et livrer si vous disposez des sources
- Questions fréquentes — réponses courtes aux questions générales, techniques et de positionnement
- Glossaire — définitions des termes techniques employés dans ces conseils