Version 9.1 by Aurelie Bertrand on 2025/09/30 09:32
Show last authors
1 {{toc/}}
2
3 ----
4
5 Ce document présente les étapes nécessaires pour créer, configurer et utiliser la fonction **DigDash Agent** dans **Open Web UI**. Il s’adresse principalement aux administrateurs souhaitant intégrer DigDash dans leur interface, depuis la création de la fonction dans le panneau d’administration jusqu’à la configuration des paramètres globaux, utilisateurs et d’interface.
6
7 = Création de la fonction DigDash (en tant qu’administrateur) =
8
9 Pour commencer, créez la fonction DigDash Agent dans Open Web UI en suivant les étapes ci-dessous :
10
11 1. Allez dans le panneau d’administration (en bas à droite).
12 1. Accédez à l’onglet **Fonctions**.
13 1. Cliquez sur le bouton ➕ pour créer une nouvelle fonction.
14 1. Copiez-collez le contenu du fichier agent-function.py :
15 [[https:~~/~~/gitdev.lan.digdash.com/DigDash-Dev/enterprise-core/src/branch/develop/digdash_enterprise_agent/src/tools/openwebui/functions/agent-function.py>>url:https://gitdev.lan.digdash.com/DigDash-Dev/enterprise-core/src/branch/develop/digdash_enterprise_agent/src/tools/openwebui/functions/agent-function.py]]
16 1. Nommez la fonction **DigDash Agent**.
17 1. Saisissez la description **Fonction pour interagir avec DigDash.**
18 1. Cliquez sur **Enregistrer**.
19
20 = Configuration =
21
22 Une fois la fonction créée, configurez les paramètres globaux et utilisateur, puis d'interface, comme indiqué ci-dessous. Configurez la clé API DigDash pour l’authentification et ajustez les paramètres de l’interface afin d’assurer le bon fonctionnement et l’affichage correct de la fonction DigDash Agent.
23
24 == Configuration globale de l’outil ==
25
26 1. Allez dans** **l'onglet** Fonctions** du panneau d'administration.
27 1. Cliquez sur l’icône engrenage de la carte de la fonction DigDash Agent.
28 1. Configurez le serveur MCP (par défaut : [[http:~~/~~/localhost:8086/mcp>>url:http://localhost:8086/mcp]]).
29 Définissez l’URL de base sur l’application web de l’Agent et ajoutez « /mcp » à la fin.
30 1. Définissez l'identifiant du modèle (par défaut : Meta-Llama-3_3-70B-Instruct).
31
32 == Configuration utilisateur de l’outil ==
33
34 === Activation de l’outil ===
35
36 1. Démarrez une nouvelle session de chat..
37 1. Cliquez sur **Contrôles de la conversation** (en haut à droite, à côté de votre avatar).
38 1. Allez dans **Vannes> Functions**, puis sélectionnez **DigDash Agent**.
39
40 === Clé API DigDash ===
41
42 Pour créer la clé API DigDash pour l’authentification, utilisez [[DigDash API REST>>doc:Digdash.API.DD_API.WebHome]].
43
44 1. Suivez les instructions du paragraphe [[S'authentifier via ApiKeyAuth>>doc:Digdash.API.DD_API.WebHome||anchor="ApiKeyAuth"]] et définissez les éléments de requête suivants :
45
46 {{code language="curl"}}
47 {
48 "targetUser": "<VOTRE NOM D’UTILISATEUR>",
49 "expires": "PT5M",
50 "note": "string",
51 "permissions": {
52 "agent": "rw",
53 "auth": "none",
54 "users": "rw",
55 "license": "none",
56 "system": "none",
57 "events": "none",
58 "sessions": "none",
59 "connections": "none"
60 }
61 }
62 {{/code}}
63
64 Remplacez <VOTRE NOM D’UTILISATEUR> par votre nom d'utilisateur DigDash .
65 Vous pouvez augmenter le délai d’expiration (par défaut : 5 minutes).
66
67 (% start="2" %)
68 1. Collez votre clé API DigDash dans la première vanne utilisateur.
69
70 == Configuration de l’interface ==
71
72 1. Ouvrez le menu **Paramètres**.
73 1. Accédez à la section **Interface**.
74 1. Activez les options suivantes :
75 1*. **iframe Sandbox Allow Same Origin**
76 1*. **iframe Sandbox Allow Forms**
77 Ces réglages sont nécessaires pour l’affichage correct des iframes.
78 1*. **Always Collapse Code Blocks**