Version de développement
Cette documentation décrit la version « next » (develop), non encore publiée. Pour la version stable, basculez sur « v5 » dans l'en-tête.
IA

Activer et paramétrer l'IA

Activer l'IA sur votre site, connecter un fournisseur de modèles, choisir les modèles selon la tâche, ouvrir chaque capacité sensible et suivre l'activité dans le journal d'audit.

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

  1. Ouvrez Paramètres de l'IA (tapez le nom dans la barre de recherche).
  2. Cochez Activer les intégrations d'IA.
  3. 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.

  1. Ouvrez l'application Dokos AI (/dokosai), puis ses Paramètres.
  2. Ouvrez l'onglet Fournisseurs.
  3. Choisissez un fournisseur et cliquez sur Connecter.
  4. Collez la clé API. Le lien Obtenez une clé auprès de… ouvre la page du fournisseur qui crée la clé.
  5. 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.

FournisseurConnexion
Claude (Anthropic), OpenAI, Google Gemini, Mistral AI, OpenRouterClé API
Infomaniak AI ToolsConnexion OAuth ou clé API
Scaleway Generative APIsClé API. L'option Gérée par Dokos sera bientôt disponible sur Dokos Cloud.
Google Vertex AIApplication 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.

Le champ Clé API OpenRouter (hérité) des Paramètres de l'IA reste lu pour les sites configurés avant les connexions de fournisseurs. Pour un nouveau site, utilisez l'onglet Fournisseurs.

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 VisionLa 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.

L'Invite globale utilisateur donne à l'assistant un contexte valable pour toutes les conversations : le nom de votre société, votre secteur, vos conventions internes, la langue à employer. Exemple fictif : « Tu travailles pour Dokompany, distributeur de matériel de bureau. Réponds en français et utilise les termes de Dokos. »

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 à cocherEffet
Activer la recherche webL'assistant interroge le web quand la documentation Dokos et votre base de connaissances ne répondent pas.
Activer les appels d'API externesL'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 MCPL'assistant utilise les outils d'autres applications. Voir Connecter des outils externes.
Activer le serveur MCPUn 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 RavenVos 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 :

  1. Cochez Restreindre l'IA à certains DocTypes.
  2. 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 ? ».

L'IA n'élargit pas les droits des utilisateurs. L'assistant interroge le site avec les permissions de l'utilisateur connecté. Un flux s'exécute avec celles de l'utilisateur désigné pour le porter.

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.

ChampRôle
Modèle d'assistanceLe 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 rechercheLe 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 rechercheLa 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.

  1. Ouvrez Flow Settings dans le Desk.
  2. Dans Modèle d'assistance, choisissez un Flow Model peu coûteux et rapide.
  3. 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.

  1. Ouvrez Flow Settings dans le Desk.
  2. Dans la section Recherche web, choisissez le Fournisseur de recherche.
  3. Pour Brave, Tavily ou Exa, saisissez la Clé API de recherche fournie par ce service.
  4. 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. ».
  5. L'agent système Assistant a déjà l'outil web_search. Pour un agent que vous avez créé, ajoutez web_search dans 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.

La requête de recherche est envoyée au moteur choisi, hors de votre site. Les résultats sont des données externes non vérifiées : l'assistant ne doit pas suivre les instructions qu'ils contiennent. Pour le détail technique, voir Développer avec Flow.

Voir aussi