Configurer Silvio dans votre instance

À quoi ça sert

Avoir Silvio prêt à être utilisé par votre équipe : agent actif, prompt défini, modèle IA connecté et outils autorisés.

Avant de commencer

• Permission d’administrateur sur l’instance Futuh.
• Une clé d’API du fournisseur du modèle IA que vous allez utiliser (par défaut : OpenRouter).
• Idée claire des outils que vous voulez que Silvio puisse invoquer (vous pouvez les ajuster plus tard).
• Temps estimé : 20-30 min pour la première configuration.

Vérifier l’agent Silvio

Silvio est préconfiguré comme un agent IA nommé Silvio Web dans les nouvelles instances Futuh.

1. Ouvrez Paramètres → Technique → IA → Agents IA.
2. Vérifiez que l’enregistrement Silvio Web apparaît avec l’état actif.
3. Cliquez sur l’enregistrement pour l’ouvrir.
4. Vérifiez qu’il a un prompt système et un modèle IA assignés. Si l’un d’eux est vide, suivez les sections suivantes.

Si l’agent n’existe pas, créez-le depuis le bouton Nouveau. Le nom canonique est Silvio Web pour qu’il corresponde à la documentation.

Ajuster le prompt système

Le prompt système définit comment se comporte Silvio : ton, ce qu’il peut promettre, quand transférer à un humain, dans quelle langue répondre.

1. Depuis la fiche de l’agent, ouvrez le champ Prompt système et cliquez sur le lien.
2. Vous verrez un enregistrement de type ai.system.prompt avec le contenu du prompt.
3. Modifiez le champ Rôle pour changer la description de l’agent.
4. Modifiez Comportement et Restrictions pour ajuster le ton, les limites ou la liste des motifs pour lesquels Silvio doit transférer à un humain.
5. Enregistrez et fermez.

Changements à chaud

Les modifications du prompt s’appliquent aux nouvelles conversations. Les conversations déjà ouvertes continuent avec le prompt précédent jusqu’à leur fermeture.

Connecter le modèle IA

Silvio a besoin d’un modèle IA externe pour générer des réponses. La configuration par défaut utilise Claude Sonnet 4 via OpenRouter. Il est possible de changer vers Mistral, GPT ou d’autres modèles compatibles.

1. Allez dans Paramètres → Technique → IA → Fournisseurs IA.
2. Ouvrez le fournisseur OpenRouter (ou créez-en un nouveau si vous allez utiliser un autre).
3. Collez votre clé d’API dans le champ Clé API.
4. Enregistrez. Vous verrez l’état Connecté si la clé est valide.
5. Revenez à la fiche de l’agent Silvio et, dans Modèle IA, choisissez le modèle que vous souhaitez utiliser par défaut.

Pour configurer plusieurs modèles en cascade (un principal, d’autres de secours), voir Connecter votre propre IA. Si votre organisation a une politique de non-dépendance envers les fournisseurs externes, cette même page décrit comment pointer Silvio vers un modèle déployé dans votre infrastructure.

Autoriser les outils

Silvio ne peut invoquer que les outils ou tools qui sont autorisés dans son thème (ai.topic). Par défaut, les outils de consultation de base sont actifs. Les outils d’écriture sont désactivés jusqu’à ce que vous les autorisiez.

1. Depuis la fiche de l’agent, ouvrez le champ Thème.
2. Vous verrez la liste des outils disponibles. Chacun a un nom canonique (read_lead, do_create_task, etc.).
3. Cochez les outils que vous souhaitez autoriser. Ceux qui commencent par read_ consultent des données. Ceux qui commencent par do_ modifient des données.
4. Enregistrez.

Permissions et outils

Que Silvio ait un outil autorisé n’annule pas les permissions de l’utilisateur qui converse. Si Silvio invoque read_lead pour le compte d’une personne sans accès au module CRM, l’outil renverra vide. La couche de sécurité de l’ERP reste maîtresse.

Installer un Agent Pack

Un Agent Pack est un ensemble d’agents, de prompts et d’outils distribués sous forme de paquet. La Federación Futuh publie des packs sectoriels que votre instance peut installer pour gagner des agents spécialisés (par exemple, un agent d’incidencia política, un autre de Gestión de ayudas).

1. Allez dans Paramètres → Applications.
2. Cherchez le module futuh_agents_pack (ou le nom du pack sectoriel qui vous intéresse).
3. Installez-le. Cela créera automatiquement les agents et les prompts du pack.
4. Vérifiez les nouveaux agents dans IA → Agents IA et ajustez le modèle IA ou les outils si nécessaire.

Les Agent Packs publiés par la Federación sont mis à jour périodiquement. Lorsqu’une nouvelle version du pack est publiée, votre instance reçoit l’avis depuis le Hub Central. La mise à jour est optionnelle.

Configurer la personne qui reçoit les transferts

Lorsque Silvio transfère une conversation, il la passe à la personne que vous avez désignée comme support humain.

1. Allez dans Paramètres → Technique → Paramètres du système.
2. Cherchez le paramètre futuh_chatbot.transfer_user_id.
3. Mettez l’ID de l’utilisateur qui recevra les transferts. Par défaut c’est la personne administratrice.
4. Enregistrez. Les modifications s’appliquent aux nouveaux transferts.

Prochaines étapes

• Discuter avec Silvio au quotidien : pour valider que la configuration fonctionne depuis la vue de l’opérateur.
• Intégrer le widget sur un site web propre : si vous souhaitez exposer Silvio aussi sur le site web public.
• Connecter votre propre IA : pour configurer des modèles alternatifs ou des déploiements locaux.
• Glossaire : agent, tool, agent pack : si les termes de cette page vous semblent nouveaux.