Guide de configuration

Guide de configuration du fournisseur

Consultez les étapes de configuration et le dépannage par outil.

Guide de configuration du fournisseur/Configuration d'Open WebUI

Configuration d'Open WebUI

Open WebUI ressemble davantage à un backend de chat web conçu par une équipe ou un particulier. Il est idéal pour intégrer plusieurs services compatibles OpenAI dans une même interface web et peut également être utilisé avec des modèles locaux.

Pour quels scénarios est-il adapté

Chat WebPartage d'équipeModèles locauxCompatibilité OpenAI

Distinguer d'abord connexions directes personnelles et backend administrateur

Point d'entréePour qui est-ce adaptéComment déterminer
Connexions directes personnellesLes utilisateurs réguliers souhaitant configurer un fournisseur uniquement pour eux-mêmesDans la page des paramètres, vous pouvez voir les connexions personnelles, Direct Connections ou des points d'entrée similaires
Admin Panel - ConnectionsLes administrateurs souhaitant configurer des fournisseurs pour l'ensemble du site ou de l'équipeNécessite des privilèges administrateur ; après enregistrement, les autres utilisateurs peuvent voir le modèle correspondant
Docker / Variables d'environnementPour ceux qui déploient Open WebUI eux-mêmesLa configuration est écrite dans la commande de démarrage, le fichier compose ou les variables d'environnement du serveur

Comment renseigner les connexions du backend

Élément de configurationMéthode de saisie
Point d'entréeAdmin Panel / Settings - Connections
ConnexionOpenAI API / Compatible OpenAI
API Base URLL'adresse API complète fournie par le backend du fournisseur ; peut inclure /v1 ou non.
API KeyClé API du fournisseur
ModèlesSynchroniser la liste ou spécifier manuellement
Référence pour la page des connexions Cette image sert à comparer l'URL, la méthode d'authentification, le Provider Type et les champs de modèle dans la page des connexions du backend Open WebUI.
Connection settings in the official Open WebUI documentation
  1. Si vous êtes un simple utilisateur, vérifiez d'abord s'il existe une entrée Direct Connections ou similaire dans vos paramètres personnels.
  2. Si vous êtes administrateur, accédez à la page Connections dans l'Admin Panel.
  3. Ajoutez une nouvelle connexion compatible OpenAI et renseignez la Base URL ainsi que l'API Key.
  4. Après avoir enregistré, synchronisez la liste des modèles ; si la synchronisation échoue, saisissez d'abord manuellement un modèle connu pour tester.
  5. Lorsque l'équipe partage l'utilisation, n'envoyez pas de clés personnelles directement aux autres ; privilégiez une configuration centralisée dans le backend.

Comment tester après l'enregistrement

  1. Créez d'abord une conversation normale ; n'envoyez pas de longs documents ni d'images pour commencer.
  2. Sélectionnez le modèle nouvellement configuré dans le menu déroulant des modèles.
  3. Envoyez « Répondez uniquement : Configuration Open WebUI réussie ».
  4. Si la liste des modèles est vide, saisissez manuellement un ID/nom de modèle confirmé comme disponible dans le backend du fournisseur.
  5. Si la configuration administrateur dans le backend a réussi mais que les utilisateurs ordinaires ne la voient pas, vérifiez les autorisations utilisateur, la visibilité du modèle et si la connexion est bien activée.

Exemple de variables d'environnement Docker

Si vous effectuez un auto-déploiement, de nombreuses configurations seront définies dans les commandes de démarrage ou les variables d'environnement. L'exemple suivant est indicatif ; l'adresse et la clé réelles doivent être celles fournies par votre fournisseur.

Exemple de connexion compatible OpenAI dans Open WebUI
OPENAI_API_BASE_URL=YOUR_PROVIDER_API_URL OPENAI_API_KEY=YOUR_API_KEY