Activer et paramétrer l'IA
Activer et paramétrer l'IA
Tant que l'IA n'est pas activée, vos utilisateurs ne la voient pas : pas d'assistant dans l'interface, pas de flux exécuté, pas de donnée envoyée à un fournisseur de modèles. Vous l'activez une fois dans les Paramètres de l'IA, puis vous ouvrez chaque capacité séparément.
Prérequis
- L'application Dokos AI est installée sur le site.
- Vous avez le rôle System Manager ou Gestionnaire d'IA.
- Vous avez un compte chez un fournisseur de modèles.
Activer l'IA
- Ouvrez Paramètres de l'IA (tapez le nom dans la barre de recherche).
- Cochez Activer les intégrations d'IA.
- Enregistrez.
Connecter un fournisseur de modèles
Dokos ne fabrique pas de modèle : il utilise ceux d'un fournisseur. Chaque fournisseur connecté est une Connexion de fournisseur d'IA.
- Ouvrez l'application Dokos AI (
/dokosai), puis ses Paramètres. - Ouvrez l'onglet Fournisseurs.
- Choisissez un fournisseur et cliquez sur Connecter.
- Collez la clé API. Le lien Obtenez une clé auprès de… ouvre la page du fournisseur qui crée la clé.
- Validez. Dokos teste la clé, puis importe le catalogue des modèles du fournisseur en arrière-plan.
Vous pouvez aussi créer la connexion depuis la liste Connexion de fournisseur d'IA du Desk. Le bouton Tester la connexion vérifie la clé. Le bouton Synchroniser les modèles relit le catalogue.
| Fournisseur | Connexion |
|---|---|
| Claude (Anthropic), OpenAI, Google Gemini, Mistral AI, OpenRouter | Clé API |
| Infomaniak AI Tools | Connexion OAuth ou clé API |
| Scaleway Generative APIs | Clé API. L'option Gérée par Dokos sera bientôt disponible sur Dokos Cloud. |
| Google Vertex AI | Application connectée créée par l'administrateur |
| Personnalisé (compatible OpenAI) | Clé API et adresse de l'API à saisir |
La consommation est facturée par le fournisseur, à l'usage. Dokos compte les jetons consommés à chaque exécution et les affiche dans le suivi, ce qui permet de rattacher une dépense à un flux précis.
Choisir les modèles selon la tâche
Dokos distingue trois usages. Dans les Paramètres de l'IA, associez chacun à un modèle :
| Champ | À quoi il sert |
|---|---|
| Modèle logique et agent (appel de fonction) | Le modèle principal : raisonner, enchaîner des outils, préparer une écriture. Il répond dans l'assistant et exécute les flux. |
| Modèle rapide (tâches simples) | Les tâches courtes et répétitives : reformuler, classer, compléter un champ de texte. Il coûte moins cher que le modèle principal. |
| Modèle OCR et Vision | La lecture d'images et de PDF : factures scannées, justificatifs, documents non structurés. |
Chaque fournisseur connecté importe son catalogue de modèles. Vous pouvez désactiver un modèle, en ajouter un à la main et changer d'affectation à tout moment.
Ouvrir les capacités sensibles, une par une
Ces capacités élargissent ce que l'IA peut atteindre. Elles sont toutes désactivées par défaut. Chacune s'active séparément dans les Paramètres de l'IA.
| Case à cocher | Effet |
|---|---|
| Activer la recherche web | L'assistant interroge le web quand la documentation Dokos et votre base de connaissances ne répondent pas. |
| Activer les appels d'API externes | L'assistant et les flux peuvent appeler des services externes, mais seulement vers les Hôtes autorisés. Sans hôte listé, aucun appel ne part. Exemple : un flux qui récupère un taux de change. |
| Activer les outils MCP | L'assistant utilise les outils d'autres applications. Voir Connecter des outils externes. |
| Activer le serveur MCP | Un assistant externe peut travailler sur votre site. Autoriser les modifications par MCP lui permet aussi d'écrire. Voir Dokos Connect. |
| Activer le pont de discussion Raven | Vos utilisateurs envoient un message direct au bot indiqué dans Raven, sans quitter leur messagerie d'équipe. |
Limiter l'IA à certains types de documents
Par défaut, l'IA voit les mêmes documents que l'utilisateur. Pour la limiter davantage :
- Cochez Restreindre l'IA à certains DocTypes.
- Dans Règles d'accès, ajoutez une ligne par type de document. Pour chaque ligne, choisissez un DocType, un Rôle facultatif et un niveau d'Accès : Lecture seule, Lecture et écriture ou Pipelines uniquement.
Exemple fictif : une ligne Sales Invoice, rôle Accounts User, accès Lecture seule. L'assistant peut lire les factures de vente pour ces utilisateurs, mais pas les modifier.
Suivre ce que l'IA a fait
Le Journal d'audit IA enregistre chaque événement notable : qui a agi, sur quel flux et quelle exécution, depuis quelle origine et quelle adresse, avec quel résultat et combien de jetons consommés. Une décision refusée y figure avec son motif, comme une action réussie.
Ouvrez-le en premier quand quelqu'un demande « qu'est-ce que l'IA a modifié hier ? ».
Assistant Flow de Dodock
L'assistant Flow est un autre assistant, intégré à Dodock. Ses réglages ne sont pas dans les Paramètres de l'IA, mais dans le document Flow Settings du Desk. Seul le rôle Responsable système peut les modifier. Les utilisateurs qui peuvent lire Flow Settings les trouvent aussi dans la page Général des paramètres de Flow (/flow). Voir Assistant Flow.
| Champ | Rôle |
|---|---|
| Modèle d'assistance | Le modèle des petites tâches annexes, comme le titre des conversations. Un modèle moins cher et plus rapide économise des crédits. S'il est vide, chaque conversation utilise son propre modèle. Ce réglage ne concerne pas les réponses suggérées : elles sont toujours produites par le modèle de la conversation. |
| Fournisseur de recherche | Le moteur de la recherche web, dans la section Recherche web : DuckDuckGo (par défaut, sans clé, mais il peut refuser les recherches en cas d'usage intensif), Brave, Tavily ou Exa. |
| Clé API de recherche | La clé du moteur choisi. Le champ n'apparaît que si le moteur n'est pas DuckDuckGo, et il est obligatoire pour Brave, Tavily et Exa. |
Dans la page /flow, ces réglages s'affichent en anglais, car leurs libellés n'ont pas encore de traduction française : Helper model (le modèle d'assistance), Web search (le moteur) et Search API key (la clé).
Choisir le modèle d'assistance
Le modèle d'assistance écrit le titre des conversations. Seuls les modèles activés sont pris en compte : un modèle désactivé est ignoré et la conversation retombe sur son propre modèle.
- Ouvrez Flow Settings dans le Desk.
- Dans Modèle d'assistance, choisissez un Flow Model peu coûteux et rapide.
- Enregistrez.
Les conversations suivantes écrivent leur titre avec ce modèle. Le modèle choisi peut venir d'un autre fournisseur que celui de la conversation : il utilise ses propres identifiants.
Exemple fictif : Dokompany garde un modèle puissant pour ses agents et choisit un petit modèle du même fournisseur, petit-modele-demo, comme Modèle d'assistance. Les titres de conversation sont écrits par ce petit modèle, ce qui réduit la dépense.
Autoriser la recherche web de l'assistant Flow
La recherche web de l'assistant Flow est l'outil web_search. Il renvoie les 10 premiers résultats d'une recherche, chacun avec son titre, son adresse et un court extrait. Le moteur et la clé que vous réglez ici servent à toutes les conversations du site, quel que soit l'utilisateur.
- Ouvrez Flow Settings dans le Desk.
- Dans la section Recherche web, choisissez le Fournisseur de recherche.
- Pour Brave, Tavily ou Exa, saisissez la Clé API de recherche fournie par ce service.
- Enregistrez. Sans clé pour l'un de ces trois moteurs, l'enregistrement est refusé avec le titre « Clé API manquante » et le message « {moteur} nécessite une clé API de recherche. ».
- L'agent système Assistant a déjà l'outil
web_search. Pour un agent que vous avez créé, ajoutezweb_searchdans son tableau Tools.
Exemple fictif : le site de Dokompany reste sur DuckDuckGo pour ses essais. Après un usage intensif, DuckDuckGo refuse les recherches et l'assistant reçoit une erreur qui recommande de renseigner une clé. L'administrateur choisit alors Brave, colle la clé brave-demo-1234 dans Clé API de recherche et enregistre : les conversations suivantes interrogent Brave.