Code source wiki de Configuration dans Open Web UI

Version 18.1 par Aurelie Bertrand le 2025/12/18 14:12
Afficher les derniers auteurs
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**.
6
7 = Installation d’OpenWebUI =
8
9 L'agent DigDash peut fonctionner avec n’importe quel chatbot compatible grâce au MCP (Model Context Protocol). Ce protocole permet aux modèles LLM d’utiliser des « outils » externes.
10 OpenWebUI a été retenu comme exemple, car il s’agit d’un chatbot open source installable facilement.
11
12 == Pré-requis ==
13
14 * Serveur Linux (Ubuntu/Debian recommandé)
15 * Python 3.11
16 * //pip// et //virtualenv//
17
18 Installez les packages requis :
19
20 {{code}}
21 sudo apt update
22 sudo apt install -y python3 python3-venv python3-pip build-essential
23 {{/code}}
24
25 == Installation ==
26
27 1. Créez l'utilisateur openwebui:(((
28 {{code}}
29 sudo useradd -m -s /bin/bash openwebui
30 {{/code}}
31 )))
32
33 (% start="2" %)
34 1. Dirigez-vous vers le dossier d'installation: (((
35 {{code}}
36 cd /home/openwebui
37 {{/code}}
38 )))
39 1. (((
40 Créez et activez un environnement virtuel dans ce dossier:
41
42 (((
43 {{code language="shell"}}
44 python3 -m venv openwebui-venv
45 source openwebui-venv/bin/activate
46 {{/code}}
47 )))
48 )))
49 1. (((
50 Mettez à jour pip pour éviter les problèmes de compatibilité :
51
52 (((
53 {{code}}
54 pip install --upgrade pip
55 {{/code}}
56 )))
57 )))
58
59 (% start="5" %)
60 1. (((
61 Installez le package open-webui:
62
63 (((
64 {{code}}
65 pip install open-webui
66 {{/code}}
67
68 Notez que le téléchargement peut durer plusieurs minutes.
69
70 (% class="box warningmessage" %)
71 (((
72 ⚠ Ne pas utiliser le package Python uv.
73 L’agent DigDash (fonction OpenWebUI) nécessite l’installation de bibliothèques Python supplémentaires à l’exécution, ce qui n’est pas compatible avec uv.
74 )))
75 )))
76 )))
77
78 (% start="6" %)
79 1. (((
80 (((
81 Déployez le serveur:
82
83 {{code}}
84 nohup open-webui serve --port 5000 &
85 {{/code}}
86
87 L’interface web devrait être disponible sur http:~/~/localhost:5000.
88 )))
89 )))
90
91 = Création de la fonction DigDash (en tant qu’administrateur) =
92
93 Pour commencer, créez la fonction DigDash Agent dans Open Web UI en suivant les étapes ci-dessous :
94
95 1. Allez dans le panneau d’administration (en bas à droite).
96 1. Accédez à l’onglet **Fonctions**.
97 1. Cliquez sur le bouton ➕ pour créer une nouvelle fonction.
98 1. Copiez-collez le contenu du fichier [[agent-function.py>>attach:agent-function.py]].
99 1. Nommez la fonction **DigDash Agent**.
100 1. Saisissez la description **Fonction pour interagir avec DigDash.**
101 1. Cliquez sur **Enregistrer**.
102
103 = Configuration =
104
105 Une fois la fonction créée, configurez les paramètres globaux et utilisateur, puis d'interface, comme indiqué ci-dessous.
106
107 == Configuration globale de l’outil ==
108
109 1. Allez dans** **l'onglet** Fonctions** du panneau d'administration.
110 1. Cliquez sur l’icône engrenage de la carte de la fonction DigDash Agent.
111 1. Configurez le serveur MCP (par défaut : [[http:~~/~~/localhost:8086/mcp>>url:http://localhost:8086/mcp]]).
112 Définissez l’URL de base sur l’application web de l’Agent et ajoutez « /mcp » à la fin.
113 1. Définissez l'identifiant du modèle (par défaut : Meta-Llama-3_3-70B-Instruct).
114
115 == Configuration utilisateur de l’outil ==
116
117 === Activation de l’outil ===
118
119 1. Démarrez une nouvelle session de chat..
120 1. Cliquez sur **Contrôles de la conversation** (en haut à droite, à côté de votre avatar).
121 1. Allez dans **Vannes> Functions**, puis sélectionnez **DigDash Agent**.
122
123 === Clé API DigDash ===
124
125 Pour créer la clé API DigDash pour l’authentification, utilisez [[DigDash API REST>>doc:Digdash.API.DD_API.WebHome]].
126
127 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 :
128
129 {{code language="curl"}}
130 {
131 "targetUser": "<VOTRE NOM D’UTILISATEUR>",
132 "expires": "PT5M",
133 "note": "string",
134 "permissions": {
135 "agent": "rw",
136 "auth": "none",
137 "users": "rw",
138 "license": "none",
139 "system": "none",
140 "events": "none",
141 "sessions": "none",
142 "connections": "none"
143 }
144 }
145 {{/code}}
146
147 Remplacez <VOTRE NOM D’UTILISATEUR> par votre nom d'utilisateur DigDash .
148 Vous pouvez augmenter le délai d’expiration (par défaut : 5 minutes).
149
150 (% start="2" %)
151 1. Collez votre clé API DigDash dans la première vanne utilisateur.
152
153 == Configuration de l’interface ==
154
155 1. Ouvrez le menu **Paramètres**.
156 1. Accédez à la section **Interface**.
157 1. Activez les options suivantes :
158 1*. **iframe Sandbox Allow Same Origin**
159 1*. **iframe Sandbox Allow Forms**
160 Ces réglages sont nécessaires pour l’affichage correct des iframes.
161 1*. **Always Collapse Code Blocks**
162
163
164 = Pour en savoir plus... =
165
166 * [[Guide d'installation de DigDash Agent>>]]
167 * [[Création d'un graphique avec DigDash Agent>>doc:Digdash.Agent.create_chart_Agent.WebHome]]