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