Configuration dans Open Web UI

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

Ce document présente les étapes nécessaires pour créer, configurer et utiliser la fonction DigDash Agent dans Open Web UI.

Installation d’OpenWebUI

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.
OpenWebUI a été retenu comme exemple, car il s’agit d’un chatbot open source installable facilement. 

Pré-requis

  • Serveur Linux (Ubuntu/Debian recommandé)
  • Python 3.11
  • pip et virtualenv

Installez les packages requis :

sudo apt update
sudo apt install -y python3 python3-venv python3-pip build-essential

Installation

  1. Créez l'utilisateur openwebui:
    sudo useradd -m -s /bin/bash openwebui
  1. Dirigez-vous vers le dossier d'installation: 
    cd /home/openwebui

  2. Créez et activez un environnement virtuel dans ce dossier:

    python3 -m venv openwebui-venv
    source openwebui-venv/bin/activate

  3. Mettez à jour pip pour éviter les problèmes de compatibilité :

    pip install --upgrade pip

  1. Installez le package open-webui:

    pip install open-webui

    Notez que le téléchargement peut durer plusieurs minutes.

    ⚠ Ne pas utiliser le package Python uv.
    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.

  1. Déployez le serveur: 

    nohup open-webui serve --port 5000 &

     L’interface web devrait être disponible sur http://localhost:5000.

Création de la fonction DigDash (en tant qu’administrateur)

Pour commencer, créez la fonction DigDash Agent dans Open Web UI en suivant les étapes ci-dessous :

  1. Allez dans le panneau d’administration (en bas à droite).
  2. Accédez à l’onglet Fonctions.
  3. Cliquez sur le bouton ➕ pour créer une nouvelle fonction.
  4. Copiez-collez le contenu du fichier agent-function.py.
  5. Nommez la fonction DigDash Agent.
  6. Saisissez la description Fonction pour interagir avec DigDash.
  7. Cliquez sur Enregistrer.

Configuration

Une fois la fonction créée, configurez les paramètres globaux et utilisateur, puis d'interface, comme indiqué ci-dessous.

Configuration globale de l’outil

  1. Allez dans l'onglet Fonctions du panneau d'administration.
  2. Cliquez sur l’icône engrenage de la carte de la fonction DigDash Agent.
  3. Configurez le serveur MCP (par défaut : http://localhost:8086/mcp).
    Définissez l’URL de base sur l’application web de l’Agent et ajoutez « /mcp » à la fin.
  4. Définissez l'identifiant du modèle (par défaut : Meta-Llama-3_3-70B-Instruct).

Configuration utilisateur de l’outil

Activation de l’outil

  1. Démarrez une nouvelle session de chat..
  2. Cliquez sur Contrôles de la conversation (en haut à droite, à côté de votre avatar).
  3. Allez dans Vannes> Functions, puis sélectionnez DigDash Agent.

Clé API DigDash

Pour créer la clé API DigDash pour l’authentification, utilisez DigDash API REST.

  1. Suivez les instructions du paragraphe S'authentifier via ApiKeyAuth et définissez les éléments de requête suivants :
{
"targetUser": "<VOTRE NOM D’UTILISATEUR>",
"expires": "PT5M",
"note": "string",
"permissions": {
"agent": "rw",
"auth": "none",
"users": "rw",
"license": "none",
"system": "none",
"events": "none",
"sessions": "none",
"connections": "none"
}
}

Remplacez <VOTRE NOM D’UTILISATEUR> par votre nom d'utilisateur DigDash .
Vous pouvez augmenter le délai d’expiration (par défaut : 5 minutes).

  1. Collez votre clé API DigDash dans la première vanne utilisateur.

Configuration de l’interface

  1. Ouvrez le menu Paramètres.
  2. Accédez à la section Interface.
  3. Activez les options suivantes :
    • iframe Sandbox Allow Same Origin
    • iframe Sandbox Allow Forms
      Ces réglages sont nécessaires pour l’affichage correct des iframes.
    • Always Collapse Code Blocks

Pour en savoir plus...