Wiki source code of Configuration dans Open Web UI

Version 18.1 by Aurelie Bertrand on 2025/12/18 14:12

version	line-number	content
8.1	1	{{toc/}}
	2
	3	----
	4
18.1	5	Ce document présente les étapes nécessaires pour créer, configurer et utiliser la fonction DigDash Agent dans Open Web UI.
1.1	6
18.1	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
1.1	91	= Création de la fonction DigDash (en tant qu’administrateur) =
	92
4.1	93	Pour commencer, créez la fonction DigDash Agent dans Open Web UI en suivant les étapes ci-dessous :
	94
3.1	95	1. Allez dans le panneau d’administration (en bas à droite).
	96	1. Accédez à l’onglet Fonctions.
1.1	97	1. Cliquez sur le bouton ➕ pour créer une nouvelle fonction.
11.1	98	1. Copiez-collez le contenu du fichier [[agent-function.py>>attach:agent-function.py]].
1.1	99	1. Nommez la fonction DigDash Agent.
3.1	100	1. Saisissez la description Fonction pour interagir avec DigDash.
1.1	101	1. Cliquez sur Enregistrer.
	102
	103	= Configuration =
	104
12.1	105	Une fois la fonction créée, configurez les paramètres globaux et utilisateur, puis d'interface, comme indiqué ci-dessous.
6.1	106
1.1	107	== Configuration globale de l’outil ==
	108
3.1	109	1. Allez dans l'onglet Fonctions du panneau d'administration.
1.1	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.
3.1	113	1. Définissez l'identifiant du modèle (par défaut : Meta-Llama-3_3-70B-Instruct).
1.1	114
2.1	115	== Configuration utilisateur de l’outil ==
1.1	116
4.1	117	=== Activation de l’outil ===
1.1	118
3.1	119	1. Démarrez une nouvelle session de chat..
2.1	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.
1.1	122
3.1	123	=== Clé API DigDash ===
1.1	124
6.1	125	Pour créer la clé API DigDash pour l’authentification, utilisez [[DigDash API REST>>doc:Digdash.API.DD_API.WebHome]].
1.1	126
4.1	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 :
3.1	128
5.1	129	{{code language="curl"}}
1.1	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	}
3.1	145	{{/code}}
1.1	146
3.1	147	Remplacez <VOTRE NOM D’UTILISATEUR> par votre nom d'utilisateur DigDash .
1.1	148	Vous pouvez augmenter le délai d’expiration (par défaut : 5 minutes).
	149
3.1	150	(% start="2" %)
	151	1. Collez votre clé API DigDash dans la première vanne utilisateur.
1.1	152
6.1	153	== Configuration de l’interface ==
1.1	154
3.1	155	1. Ouvrez le menu Paramètres.
9.1	156	1. Accédez à la section Interface.
1.1	157	1. Activez les options suivantes :
9.1	158	1. iframe Sandbox Allow Same Origin*
	159	1. iframe Sandbox Allow Forms*
1.1	160	Ces réglages sont nécessaires pour l’affichage correct des iframes.
9.1	161	1. Always Collapse Code Blocks*
17.1	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]]

Wiki source code of Configuration dans Open Web UI

Sommaire