[{"data":1,"prerenderedAt":547},["ShallowReactive",2],{"\u002Fv5\u002Fdodock\u002Fdeveloppeurs\u002Fdokos-ai-llm-complete":3,"section:\u002Fv5\u002Fdodock\u002Fdeveloppeurs\u002Fdokos-ai-llm-complete":546},{"id":4,"title":5,"body":6,"description":531,"extension":532,"meta":533,"navigation":91,"path":542,"seo":543,"stem":544,"__hash__":545},"docs\u002F1.v5\u002F3.dodock\u002F10.developpeurs\u002Fdokos-ai-llm-complete.md","Appeler un modèle d'IA depuis une application (llm.complete)",{"type":7,"value":8,"toc":523},"minimark",[9,13,33,38,43,65,69,141,234,237,240,287,299,303,322,327,331,342,388,391,394,398,405,487,504,508,519],[10,11,5],"h1",{"id":12},"appeler-un-modèle-dia-depuis-une-application-llmcomplete",[14,15,16,17,22,23,27,28,32],"p",{},"L'application ",[18,19,21],"a",{"href":20},"\u002Fv5\u002Fapplications\u002Fdokos-ai","Dokos AI"," fournit la fonction ",[24,25,26],"code",{},"complete()"," pour qu'une autre application obtienne une réponse de texte d'un modèle, en un seul échange : un prompt en entrée, le texte du modèle en sortie. La fonction réutilise la configuration du site : niveaux de modèles, connexions aux fournisseurs et clés d'accès sont ceux des paramètres de l'IA. Voir ",[18,29,31],{"href":30},"\u002Fv5\u002Fintegrations\u002Fia\u002Fconfiguration","Activer et paramétrer l'IA",".",[14,34,35,37],{},[24,36,26],{}," est une API Python. Elle n'est pas exposée en HTTP : on ne peut pas l'appeler depuis l'API REST ni depuis un script client.",[39,40,42],"h2",{"id":41},"prérequis","Prérequis",[44,45,46,50,58],"ul",{},[47,48,49],"li",{},"L'application Dokos AI est installée sur le site.",[47,51,52,53,57],{},"L'IA est activée sur le site (case ",[54,55,56],"strong",{},"Activer les intégrations d'IA"," des paramètres de l'IA) et un fournisseur de modèles est connecté.",[47,59,60,61,64],{},"Votre application importe ",[24,62,63],{},"dokos_ai"," : déclarez-la comme dépendance ou protégez l'import si elle peut être absente.",[39,66,68],{"id":67},"signature","Signature",[70,71,76],"pre",{"className":72,"code":73,"language":74,"meta":75,"style":75},"language-python shiki shiki-themes material-theme-lighter material-theme material-theme-palenight","from dokos_ai.dokos_ai.api.llm import AIDisabledError, complete\n\ncomplete(\n    prompt: str,\n    *,\n    system: str | None = None,\n    tier: ModelTier | str = ModelTier.FAST,\n    max_tokens: int = 800,\n    purpose: str | None = None,\n) -> str\n","python","",[24,77,78,86,93,99,105,111,117,123,129,135],{"__ignoreMap":75},[79,80,83],"span",{"class":81,"line":82},"line",1,[79,84,85],{},"from dokos_ai.dokos_ai.api.llm import AIDisabledError, complete\n",[79,87,89],{"class":81,"line":88},2,[79,90,92],{"emptyLinePlaceholder":91},true,"\n",[79,94,96],{"class":81,"line":95},3,[79,97,98],{},"complete(\n",[79,100,102],{"class":81,"line":101},4,[79,103,104],{},"    prompt: str,\n",[79,106,108],{"class":81,"line":107},5,[79,109,110],{},"    *,\n",[79,112,114],{"class":81,"line":113},6,[79,115,116],{},"    system: str | None = None,\n",[79,118,120],{"class":81,"line":119},7,[79,121,122],{},"    tier: ModelTier | str = ModelTier.FAST,\n",[79,124,126],{"class":81,"line":125},8,[79,127,128],{},"    max_tokens: int = 800,\n",[79,130,132],{"class":81,"line":131},9,[79,133,134],{},"    purpose: str | None = None,\n",[79,136,138],{"class":81,"line":137},10,[79,139,140],{},") -> str\n",[142,143,144,157],"table",{},[145,146,147],"thead",{},[148,149,150,154],"tr",{},[151,152,153],"th",{},"Paramètre",[151,155,156],{},"Rôle",[158,159,160,171,181,210,220],"tbody",{},[148,161,162,168],{},[163,164,165],"td",{},[24,166,167],{},"prompt",[163,169,170],{},"Le message de l'utilisateur envoyé au modèle.",[148,172,173,178],{},[163,174,175],{},[24,176,177],{},"system",[163,179,180],{},"Une consigne système facultative. Si elle est renseignée, elle est placée avant le prompt.",[148,182,183,188],{},[163,184,185],{},[24,186,187],{},"tier",[163,189,190,191,194,195,198,199,202,203,206,207,209],{},"Le niveau de modèle : ",[24,192,193],{},"default",", ",[24,196,197],{},"fast"," ou ",[24,200,201],{},"vision"," (ou l'énumération ",[24,204,205],{},"ModelTier","). Par défaut ",[24,208,197],{},". Le modèle réel est celui que les paramètres de l'IA associent à ce niveau.",[148,211,212,217],{},[163,213,214],{},[24,215,216],{},"max_tokens",[163,218,219],{},"La longueur maximale de la réponse. Par défaut 800.",[148,221,222,227],{},[163,223,224],{},[24,225,226],{},"purpose",[163,228,229,230,233],{},"Le nom de la fonctionnalité appelante, repris dans le journal d'audit (par exemple ",[24,231,232],{},"monapp.resume_ticket",").",[14,235,236],{},"La fonction renvoie le texte de la réponse, ou une chaîne vide si le modèle ne renvoie aucun contenu. L'appel est synchrone : il attend la réponse du fournisseur.",[14,238,239],{},"Chaque niveau correspond à un champ des paramètres de l'IA :",[142,241,242,252],{},[145,243,244],{},[148,245,246,249],{},[151,247,248],{},"Niveau",[151,250,251],{},"Champ des paramètres de l'IA",[158,253,254,265,276],{},[148,255,256,260],{},[163,257,258],{},[24,259,193],{},[163,261,262],{},[54,263,264],{},"Modèle logique et agent (appel de fonction)",[148,266,267,271],{},[163,268,269],{},[24,270,197],{},[163,272,273],{},[54,274,275],{},"Modèle rapide (tâches simples)",[148,277,278,282],{},[163,279,280],{},[24,281,201],{},[163,283,284],{},[54,285,286],{},"Modèle OCR et Vision",[14,288,289,291,292,294,295,198,297,32],{},[24,290,26],{}," envoie seulement du texte : elle ne peut pas transmettre d'image. Avec ",[24,293,201],{},", le prompt texte est envoyé au modèle OCR et Vision. Pour une simple réponse de texte, préférez ",[24,296,197],{},[24,298,193],{},[39,300,302],{"id":301},"erreurs","Erreurs",[44,304,305,319],{},[47,306,307,308,310,311,314,315,318],{},"Si l'IA est désactivée sur le site, ",[24,309,26],{}," lève ",[24,312,313],{},"AIDisabledError",", une sous-classe de ",[24,316,317],{},"frappe.ValidationError",". Son message est « L'IA est désactivée dans les paramètres IA. » dans l'interface en français.",[47,320,321],{},"Les erreurs du fournisseur (service indisponible, clé refusée…) ne sont pas interceptées : elles remontent telles quelles à l'appelant, après l'écriture de la ligne d'audit.",[14,323,324,326],{},[24,325,26],{}," ne vérifie pas les permissions de l'utilisateur connecté. Contrôlez-les dans votre code avant de l'appeler, surtout si le prompt contient des données du site.",[39,328,330],{"id":329},"journal-daudit","Journal d'audit",[14,332,333,334,337,338,341],{},"Chaque appel écrit une ligne dans le ",[54,335,336],{},"Journal d'audit IA"," (type d'événement ",[24,339,340],{},"llm_completion","), qu'il réussisse ou non :",[142,343,344,354],{},[145,345,346],{},[148,347,348,351],{},[151,349,350],{},"Information",[151,352,353],{},"Contenu",[158,355,356,369,377],{},[148,357,358,361],{},[163,359,360],{},"Statut",[163,362,363,198,366,32],{},[24,364,365],{},"Success",[24,367,368],{},"Failed",[148,370,371,374],{},[163,372,373],{},"Jetons",[163,375,376],{},"La somme des jetons d'entrée et de sortie, si le fournisseur les renvoie.",[148,378,379,382],{},[163,380,381],{},"Détails",[163,383,384,385,387],{},"Le ",[24,386,226],{},", l'identifiant du modèle, une empreinte du prompt et la durée en millisecondes.",[14,389,390],{},"Le prompt lui-même n'est jamais enregistré : seule son empreinte l'est. L'acteur de la ligne est l'utilisateur de la session.",[14,392,393],{},"L'écriture de l'audit ne fait jamais échouer l'appel. La ligne est insérée dans la transaction en cours, sans validation (commit) : si l'appelant annule la transaction, par exemple après une exception, la ligne est annulée avec elle.",[39,395,397],{"id":396},"exemple","Exemple",[14,399,400,401,404],{},"Exemple fictif : une application ",[24,402,403],{},"monapp"," résume le texte d'un ticket pour l'afficher dans un champ.",[70,406,408],{"className":72,"code":407,"language":74,"meta":75,"style":75},"import frappe\nfrom dokos_ai.dokos_ai.api.llm import AIDisabledError, complete\n\n\ndef resumer_ticket(ticket: str) -> str | None:\n    texte = frappe.db.get_value(\"Issue\", ticket, \"description\")\n    try:\n        return complete(\n            texte,\n            system=\"Résume ce message en deux phrases, en français.\",\n            max_tokens=200,\n            purpose=\"monapp.resumer_ticket\",\n        )\n    except AIDisabledError:\n        return None\n",[24,409,410,415,419,423,427,432,437,442,447,452,457,463,469,475,481],{"__ignoreMap":75},[79,411,412],{"class":81,"line":82},[79,413,414],{},"import frappe\n",[79,416,417],{"class":81,"line":88},[79,418,85],{},[79,420,421],{"class":81,"line":95},[79,422,92],{"emptyLinePlaceholder":91},[79,424,425],{"class":81,"line":101},[79,426,92],{"emptyLinePlaceholder":91},[79,428,429],{"class":81,"line":107},[79,430,431],{},"def resumer_ticket(ticket: str) -> str | None:\n",[79,433,434],{"class":81,"line":113},[79,435,436],{},"    texte = frappe.db.get_value(\"Issue\", ticket, \"description\")\n",[79,438,439],{"class":81,"line":119},[79,440,441],{},"    try:\n",[79,443,444],{"class":81,"line":125},[79,445,446],{},"        return complete(\n",[79,448,449],{"class":81,"line":131},[79,450,451],{},"            texte,\n",[79,453,454],{"class":81,"line":137},[79,455,456],{},"            system=\"Résume ce message en deux phrases, en français.\",\n",[79,458,460],{"class":81,"line":459},11,[79,461,462],{},"            max_tokens=200,\n",[79,464,466],{"class":81,"line":465},12,[79,467,468],{},"            purpose=\"monapp.resumer_ticket\",\n",[79,470,472],{"class":81,"line":471},13,[79,473,474],{},"        )\n",[79,476,478],{"class":81,"line":477},14,[79,479,480],{},"    except AIDisabledError:\n",[79,482,484],{"class":81,"line":483},15,[79,485,486],{},"        return None\n",[14,488,489,490,493,494,496,497,499,500,503],{},"Si l'IA est désactivée, la fonction renvoie ",[24,491,492],{},"None"," et l'application continue sans résumé. Après un appel réussi, une ligne ",[24,495,340],{}," au statut ",[24,498,365],{}," apparaît dans le journal d'audit, avec ",[24,501,502],{},"monapp.resumer_ticket"," dans ses détails.",[39,505,507],{"id":506},"voir-aussi","Voir aussi",[44,509,510,515],{},[47,511,512,514],{},[18,513,31],{"href":30}," : activation, connexion d'un fournisseur et choix des modèles.",[47,516,517],{},[18,518,21],{"href":20},[520,521,522],"style",{},"html .light .shiki span {color: var(--shiki-light);background: var(--shiki-light-bg);font-style: var(--shiki-light-font-style);font-weight: var(--shiki-light-font-weight);text-decoration: var(--shiki-light-text-decoration);}html.light .shiki span {color: var(--shiki-light);background: var(--shiki-light-bg);font-style: var(--shiki-light-font-style);font-weight: var(--shiki-light-font-weight);text-decoration: var(--shiki-light-text-decoration);}html .default .shiki span {color: var(--shiki-default);background: var(--shiki-default-bg);font-style: var(--shiki-default-font-style);font-weight: var(--shiki-default-font-weight);text-decoration: var(--shiki-default-text-decoration);}html .shiki span {color: var(--shiki-default);background: var(--shiki-default-bg);font-style: var(--shiki-default-font-style);font-weight: var(--shiki-default-font-weight);text-decoration: var(--shiki-default-text-decoration);}html .dark .shiki span {color: var(--shiki-dark);background: var(--shiki-dark-bg);font-style: var(--shiki-dark-font-style);font-weight: var(--shiki-dark-font-weight);text-decoration: var(--shiki-dark-text-decoration);}html.dark .shiki span {color: var(--shiki-dark);background: var(--shiki-dark-bg);font-style: var(--shiki-dark-font-style);font-weight: var(--shiki-dark-font-weight);text-decoration: var(--shiki-dark-text-decoration);}",{"title":75,"searchDepth":82,"depth":88,"links":524},[525,526,527,528,529,530],{"id":41,"depth":88,"text":42},{"id":67,"depth":88,"text":68},{"id":301,"depth":88,"text":302},{"id":329,"depth":88,"text":330},{"id":396,"depth":88,"text":397},{"id":506,"depth":88,"text":507},"La fonction Python complete() de Dokos AI envoie un prompt au modèle configuré sur le site et renvoie le texte de la réponse, avec une ligne d'audit par appel.","md",{"icon":534,"sources":535,"generated":91,"generated_at":539,"source_mrs":540,"reviewed":91},"i-mdi-robot-outline",[536,537,538],"dokos_ai\u002Fdokos_ai\u002Fapi\u002Fllm.py","dokos_ai\u002Fdokos_ai\u002Fpipeline_audit.py","dokos_ai\u002Fdokos_ai\u002Fconfig.py","2026-11-18",[541],"https:\u002F\u002Fgitlab.com\u002Fdokos\u002Fdokos-ai\u002F-\u002Fmerge_requests\u002F562","\u002Fv5\u002Fdodock\u002Fdeveloppeurs\u002Fdokos-ai-llm-complete",{"title":5,"description":531},"1.v5\u002F3.dodock\u002F10.developpeurs\u002Fdokos-ai-llm-complete","-QNdk1D8Q243lpY9xPp42tuJzxc8q_tVYwoXkQh0nMI",{},1795162124009]