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

L'assistant

Dialoguer avec votre site Dokos — interroger vos documents, exécuter vos rapports, chercher dans la documentation et le wiki, diagnostiquer un problème de permissions, et faire préparer une écriture que vous validez.

L'assistant

L'assistant est le point d'entrée quotidien de l'IA : vous posez une question en français, il va chercher la réponse dans vos données réelles, et vous répond en citant ce qu'il a consulté. Quand la réponse suppose une action — créer un devis, corriger un champ, assigner un rôle — il la prépare et vous la soumet plutôt que de l'exécuter dans votre dos.

Exemple — Dokompany « Quels clients ont dépassé leur encours autorisé ce mois-ci ? » L'assistant exécute le rapport des créances, croise les résultats avec les limites de crédit, et vous renvoie la liste avec le montant de dépassement pour chacun. Vous enchaînez : « prépare une relance pour les trois premiers » — il rédige les trois messages et attend votre feu vert.

Trois endroits pour lui parler

L'espace Dokos AI rassemble les conversations, les flux et le suivi. Il s'ouvre depuis l'icône Assistant IA de votre bureau, ou à l'adresse /dokosai, et démarre sur la boîte de réception, c'est-à-dire sur la seule question qui compte en arrivant : qu'est-ce qui m'attend ?

Le lien Assistant IA de la barre latérale du Desk ouvre l'assistant sans quitter la page. Sur un formulaire ouvert, l'assistant peut le remplir à votre place : tiers, société, lignes d'articles et prix. Il ne l'enregistre pas. Le message « Le formulaire est rempli. Vérifiez-le, puis enregistrez. » vous invite à vérifier, puis à enregistrer vous-même.

Raven, si vous l'utilisez, permet de dialoguer avec l'assistant par message direct, sans quitter votre messagerie d'équipe. Cette passerelle s'active dans les paramètres de l'IA.

Ce qu'il sait faire

DomaineCe que vous pouvez lui demander
Vos donnéesRetrouver un document, lister ce qui correspond à un critère, comparer, compter, vérifier l'existence d'une fiche
Vos analysesLister les rapports disponibles, les exécuter avec vos filtres, en agréger les résultats, retrouver un graphique
La connaissanceChercher dans la documentation Dokos, dans votre wiki interne, dans vos cours et vos notes publiques — et sur le web si Activer la recherche web est coché dans les paramètres de l'IA
Les permissionsExpliquer pourquoi un utilisateur ne peut pas ouvrir un écran ou valider un document, et proposer les rôles à ajouter
La mise en formeRédiger un modèle d'impression, écrire un script de formulaire, composer un espace de travail et sa navigation
L'écriturePréparer la création ou la modification d'un document, remplir un champ, le tout soumis à votre validation

Assistant Flow : quand un résultat est trop grand

Cette section concerne l'assistant Flow de Dodock, pas l'assistant Dokos AI.

Un outil peut renvoyer un résultat trop volumineux pour tenir dans la conversation — un rapport de plusieurs milliers de lignes, par exemple. L'assistant enregistre alors le résultat complet dans le dossier interne de la conversation (jusqu'à 5 Mo) et le consulte en entier : il le parcourt page par page ou y recherche directement les lignes qui l'intéressent. Si le résultat dépasse 5 Mo, seuls ses premiers 5 Mo sont conservés. Si l'enregistrement échoue, ou si l'assistant ne dispose pas de l'outil de lecture, il ne voit que le début et la fin du résultat et relance l'appel en demandant moins de données.

Le dossier de la conversation, et les résultats qui y sont enregistrés, est supprimé lorsque vous supprimez la conversation.

Assistant Flow : lire une page web

Cette section concerne l'assistant Flow de Dodock, pas l'assistant Dokos AI.

Un agent Flow qui a l'outil Web Fetch dans son champ Outils peut lire une page web publique à partir de son adresse. Ajoutez cet outil dans le formulaire Agent Flow, section Outils. Vous collez un lien à l'assistant, il en récupère le texte et vous répond à partir de son contenu. Une page HTML est convertie en texte structuré (titres, liens, tableaux). Les menus de navigation, les pieds de page, les scripts et les images sont écartés. Un texte brut, du JSON ou du XML est lu tel quel. La lecture d'une page ne dépend pas des réglages Recherche web des Paramètres Flow.

Pendant la lecture, la conversation affiche l'étape « Reading page exemple.test/conditions-generales » (libellé non traduit).

Exemple fictif « Résume la page https://exemple.test/conditions-generales et dis-moi quel est le délai de rétractation. » L'assistant lit la page puis répond avec le délai indiqué dans le texte.

Limites à connaître :

  • Pages publiques uniquement. L'assistant refuse les adresses privées ou locales (par exemple un serveur interne ou localhost), y compris lorsqu'une page publique redirige vers elles. Il suit au plus 5 redirections. Une page qui demande une connexion n'est pas lisible.
  • Pas de JavaScript. Une page dont le contenu est construit dans le navigateur arrive presque vide. L'assistant vous le signale.
  • Texte seulement. Une image, un PDF ou un autre fichier non textuel est refusé avec un message qui indique son type.
  • Taille et durée. Seuls les 5 premiers Mo d'une page sont lus : la suite est ignorée. La lecture s'arrête au bout de 30 secondes au maximum.
  • Erreurs. Une réponse d'erreur du site (par exemple 404) est rapportée à l'assistant avec son code.

L'assistant traite le contenu d'une page comme une donnée non fiable : il ne doit pas suivre les instructions qu'elle contient. Comme tout résultat volumineux, une longue page est tronquée dans la conversation (voir la section précédente).

Assistant Flow : chercher dans la documentation Frappe

Cette section concerne l'assistant Flow de Dodock, pas l'assistant Dokos AI.

Pour une question sur le fonctionnement de Frappe ou de ses applications — comment fonctionne une fonctionnalité, comment la paramétrer, une question fonctionnelle ou technique —, l'assistant Flow peut chercher dans la documentation publique docs.frappe.io. Ce site couvre Frappe Framework, ERPNext, Frappe HR, Frappe Cloud et d'autres applications Frappe : ce n'est pas la documentation de Dokos. L'assistant reçoit pour consigne d'employer cette recherche pour ce type de question.

La recherche renvoie au plus 10 résultats. Chacun comporte un titre, l'adresse de la page et un court extrait (300 caractères au plus, débarrassé de sa mise en forme). Pour lire une page en entier, l'assistant utilise l'outil Web Fetch décrit dans la section précédente, qui est soumis à son approbation. Si les résultats ne suffisent pas et qu'il dispose de la recherche web, il peut se tourner vers elle (voir Autoriser la recherche web de l'assistant Flow).

Pendant la recherche, la conversation affiche l'étape Searching the docs (libellé non traduit), puis Searched the docs (libellé non traduit) une fois la recherche terminée. Quand plusieurs appels d'outils se suivent sans texte entre eux, la conversation les regroupe sur une seule ligne, sauf si l'option Show each step separately (libellé non traduit) des réglages de Flow est activée : voir Assistant Flow.

Cette recherche ne demande pas d'approbation et ne dépend pas des réglages Recherche web des Paramètres Flow : elle n'utilise ni moteur ni clé à configurer.

Exemple fictif Vous demandez : « Comment fonctionnent les séries de nommage dans ERPNext ? » L'assistant cherche « naming series », reçoit une liste de pages avec leur titre et leur adresse, puis vous répond à partir des extraits en citant les pages consultées. Si vous voulez le détail d'une page, il la lit en entier avec Web Fetch.

Limites à connaître :

  • Tous les mots doivent figurer dans la page. Une page n'est retenue que si elle contient chaque mot recherché. L'assistant cherche donc avec deux ou trois mots simples, pas avec une phrase ni avec des noms issus du code. Quand aucune page ne correspond, il reçoit une note lui demandant de relancer la recherche avec moins de mots, plus simples.
  • Version de la documentation. Quand l'adresse d'une page contient une version (par exemple erpnext/v14/...), la page concerne cette version. Une adresse sans version renvoie à la documentation la plus récente.
  • Données externes. Les mots recherchés sont envoyés à docs.frappe.io, hors de votre site. Les résultats sont traités comme des données non fiables : l'assistant ne doit pas suivre les instructions qu'ils contiennent.
  • Site indisponible ou redirection. La recherche ne quitte jamais docs.frappe.io : une redirection est refusée. Si le site répond autrement que par un succès, la recherche échoue avec le message « docs.frappe.io answered HTTP » suivi du code de réponse (libellé non traduit).
  • Agent créé sur le site. L'agent Flow fourni par Dodock reçoit cet outil automatiquement à chaque migration, tant qu'il reste l'agent généré par le système et qu'un modèle Flow est activé. Pour un agent que vous avez créé, ajoutez l'outil frappe/search_docs dans ses outils.

Assistant Flow : trouver et appeler une API

Cette section concerne l'assistant Flow de Dodock, pas l'assistant Dokos AI.

Quand aucun outil standard (lire, créer, modifier, supprimer un enregistrement) ne couvre votre demande, l'assistant Flow peut chercher une API déclarée accessible (une fonction Python marquée @frappe.whitelist ou un Script Serveur de type API), lire ses arguments, puis l'exécuter. Il ne devine jamais le chemin d'une API : il le cherche d'abord.

L'assistant procède en trois temps :

  1. Chercher. Il recherche par mots-clés parmi les API accessibles, les Scripts Serveur de type API et les méthodes de documents. Chaque mot de la recherche doit figurer dans le chemin ou dans la description (docstring) de l'API. Il obtient au plus 50 résultats, chacun avec la première ligne de sa description. Dans la conversation, cette étape s'affiche Finding APIs (libellé non traduit).
  2. Lire. Il récupère les arguments et la description de l'API, ou ceux d'une méthode de document lorsqu'il connaît le type de document. L'étape s'affiche Reading an API (libellé non traduit), suivie du chemin pointé de l'API. Pour une méthode de document, elle est suivie du type de document et du nom de la méthode en toutes lettres, par exemple « Sales Invoice: Make Payment ». L'étape n'affiche plus de nombre d'arguments. Il sait aussi si le développeur a marqué l'API en lecture seule. Pour une API fournie par un Script Serveur, le code du script n'est communiqué à l'assistant que si vous avez le droit de lire ce Script Serveur (Python) ; sinon il ne le reçoit pas.
  3. Exécuter. Il appelle l'API avec les arguments voulus. L'étape s'affiche Calling API (libellé non traduit), suivie du chemin pointé de l'API, par exemple frappe.desk.form.assign_to.add. Le même chemin figure dans les messages d'erreur de l'appel.

Quand ces étapes se suivent sans texte entre elles, la conversation les regroupe sur une seule ligne : voir Assistant Flow.

Si une application remplace une API par une autre, l'assistant lit et exécute l'API telle qu'elle s'exécute réellement, après remplacement.

Quand l'assistant demande votre accord

  • API marquée en lecture seule par son développeur : elle s'exécute sans demande d'approbation, dans une transaction en lecture seule. Si elle tente d'écrire malgré tout, l'appel est refusé et rien n'est enregistré.
  • Toute autre API : l'assistant met l'appel en pause et vous affiche une carte d'approbation. Son titre est le nom de la fonction en toutes lettres, tiré des deux dernières parties de son chemin (par exemple « Attribuer à: Ajouter » pour frappe.desk.form.assign_to.add). Il est suivi des arguments transmis, présentés en clair. Vous approuvez ou vous rejetez.
  • Script Serveur de type API : l'approbation est toujours demandée, y compris lorsque le script est atteint par le remplacement d'une API marquée en lecture seule.

Toute API appelée par l'assistant, Script Serveur compris, s'exécute au nom de l'utilisateur connecté, avec ses permissions. Un Script Serveur de type API n'a pas de liste de rôles autorisés : ce qu'il peut lire ou modifier dépend de son code et des permissions de cet utilisateur.

Si l'appel échoue, les écritures qu'il avait faites sont annulées. Une API qui répond par un fichier plutôt que par des données ne peut pas être exécutée par l'assistant.

Les méthodes d'un document précis (valider, annuler, renommer, transition de workflow, méthode accessible d'un document) restent exécutées par l'action sur document de l'assistant, après lecture des actions possibles. Quand cette action reçoit le chemin d'une API, elle suit les mêmes règles d'approbation que l'exécution d'API décrite ici.

Le code Python exécuté par l'assistant dans son bac à sable peut lui aussi appeler une API. Quand ce code est lancé en lecture seule, seules les API marquées en lecture seule sont autorisées. Un appel à une autre API fait échouer tout le code. L'assistant relance alors le code sans la lecture seule, et vous approuvez le code avant son exécution.

Exemple fictif Vous demandez : « Assigne le ToDo « Appeler le transporteur » à Alice. » L'assistant cherche « assign », trouve l'API d'assignation, lit ses arguments, puis affiche la carte « Attribuer à: Ajouter » avec le ToDo et l'utilisateur à assigner. L'assignation n'est faite qu'après votre approbation.

Limites à connaître :

  • Index des API en cours de génération. La recherche s'appuie sur un index construit en arrière-plan. Tant qu'il n'est pas prêt, l'assistant ne réessaie pas : il parcourt le code des applications à la recherche des fonctions accessibles et lit la fonction concernée.
  • Chemin invalide. Une demande qui ne désigne ni une API accessible ni un Script Serveur de type API est refusée avec le message Pass a whitelisted API's path from find_apis. (libellé non traduit). Une fonction qui n'est pas déclarée accessible est refusée.
  • Agent créé sur le site. L'agent Flow fourni par Dodock reçoit ces outils automatiquement à chaque migration, tant qu'il reste l'agent généré par le système et qu'un modèle Flow est activé. Pour un agent que vous avez créé, ajoutez les outils frappe/find_apis, frappe/describe_api et frappe/call_api dans ses outils.

La boîte de réception : rien ne passe sans vous

Tout ce sur quoi l'IA attend un humain arrive au même endroit : une écriture que l'assistant a préparée, une étape d'un flux qui exige une approbation. Vous y voyez ce qui est proposé, sur quel document, à la demande de qui — et vous approuvez ou vous rejetez.

C'est ce qui rend l'automatisation acceptable : une proposition non validée ne devient jamais un document. Un rejet est enregistré dans le journal d'audit avec son motif, au même titre qu'une approbation.

L'assistant travaille avec vos permissions. Il ne lit pas un document que vous ne pourriez pas ouvrir et ne prépare pas une écriture que vous ne pourriez pas faire vous-même. Un utilisateur des ventes et un comptable ne verront pas les mêmes réponses à la même question.

Les compétences : lui apprendre vos façons de faire

Une compétence est une fiche d'instructions qui spécialise l'assistant sur un sujet : quoi vérifier avant d'agir, quels outils employer, dans quel ordre, avec quelles précautions. L'assistant charge la compétence utile au moment où elle sert, plutôt que de tout garder en tête en permanence.

Dokos en fournit une bibliothèque, qui couvre la création et la modification de documents, la génération de rapports, la mise en page des formulaires et des impressions, la recherche documentaire et le diagnostic de permissions.

Vous pouvez surtout écrire les vôtres. Une compétence maison décrit un processus propre à votre organisation — votre procédure de validation des devis, vos règles de remise, la manière dont vous qualifiez un litige — et l'assistant l'applique ensuite systématiquement. Chaque compétence indique le domaine qu'elle couvre, le modèle à employer (rapide ou principal), les outils auxquels elle donne accès, et peut s'appuyer sur des documents de référence que l'assistant consulte à la demande : un barème, une grille tarifaire, un extrait de contrat type.

Exemple — Mappemonde Une compétence « qualification d'une demande d'espace » décrit les questions à poser (dates, nombre de personnes, équipements), les disponibilités à vérifier et la grille tarifaire à appliquer. Toute demande entrante est traitée de la même façon, quel que soit le collaborateur qui la reçoit.

Les mêmes compétences alimentent les flux automatisés : elles sont écrites une fois et servent partout. Vous pouvez également en publier une vers les assistants externes, compétence par compétence, en cochant Partager avec les agents externes.

Voir aussi