Guide de démarrage

Commencer avec Zileo Chat

Ce guide vous accompagne pas à pas dans la configuration initiale de Zileo Chat, de l'installation à la création de votre premier workflow intelligent.

Prérequis

Avant d'utiliser Zileo Chat, assurez-vous d'avoir les éléments suivants installés sur votre ordinateur. Ces outils sont nécessaires pour profiter de toutes les fonctionnalités de l'application.

Docker Desktop

Requis pour les serveurs MCP. Docker permet d'exécuter les serveurs MCP (Model Context Protocol) de manière isolée et sécurisée. Ces serveurs étendent les capacités de vos agents avec des outils spécialisés (analyse de code, recherche web, etc.).

1 Télécharger Docker Desktop depuis docker.com

2 Installer l'application et redémarrer si nécessaire

3 Lancer Docker Desktop (il doit tourner en arrière-plan)

4 Vérifier l'installation : docker --version dans un terminal

Fournisseurs LLM (choisir au moins un)

Zileo Chat nécessite un fournisseur de modèles de langage (LLM) pour fonctionner. Vous pouvez utiliser Ollama (local ou cloud) ou Mistral (cloud, API payante).

Ollama Local Cloud

Modèles en local ou via Ollama Cloud. Ollama exécute les modèles directement sur votre machine ou les délègue automatiquement à son infrastructure cloud pour les modèles volumineux. Vos données ne sont pas conservées sur les serveurs cloud.

Gratuit Données locales Hors ligne Cloud

1 Télécharger depuis ollama.ai

2 Installer et lancer l'application

3 Télécharger un modèle : ollama run deepseek-v3.2:cloud

4 Vérifier : ollama list pour voir les modèles installés

Modèle recommandé : deepseek-v3.2:cloud

Ollama Cloud Exécuter des modèles volumineux sans matériel puissant. Authentification requise via ollama signin. Plans : Gratuit ($0), Pro ($20/mois), Max ($100/mois). Documentation

Mistral AI Cloud API

Entreprise française, modèles performants via API. Mistral propose des modèles de pointe accessibles via une clé API. Pas besoin de matériel puissant, les calculs sont effectués sur leurs serveurs. Facturation à l'usage (tokens consommés).

Haute performance Pas de GPU requis Entreprise française

1 Créer un compte sur console.mistral.ai

2 Générer une clé API dans la console

3 Ajouter du crédit (paiement à l'usage)

4 Configurer la clé dans Zileo Chat (Paramètres > Providers)

Modèle recommandé : mistral-large-latest

Quel fournisseur choisir ?
Ollama : l'abonnement cloud permet d'utiliser des modèles open source performants (DeepSeek, futurs modèles) sans contrainte matérielle.
Mistral : nécessaire pour le modèle d'embedding. Mistral Large est adapté aux tâches nécessitant précision et fiabilité.

Premier lancement

Au premier démarrage de Zileo Chat, un assistant de configuration vous guide à travers les étapes essentielles pour personnaliser votre expérience. Cet assistant apparaît automatiquement et ne prend que quelques minutes.

Zileo Chat - Bienvenue

Bienvenue dans Zileo Chat

Configurons ensemble votre assistant IA

Français

Interface en français

English

English interface

Choix de la langue

Sélectionnez votre langue préférée entre le français et l'anglais. L'interface complète ainsi que les messages système s'adapteront à votre choix. Vous pourrez modifier ce paramètre à tout moment dans les réglages.

Thème visuel

Choisissez entre le mode clair et le mode sombre selon vos préférences. Le mode sombre réduit la fatigue oculaire lors d'une utilisation prolongée. L'option "Automatique" suit les paramètres de votre système d'exploitation.

Clé API

Configurez votre clé API pour connecter Zileo Chat aux modèles d'intelligence artificielle. Mistral AI nécessite une clé API (embedding et modèles performants). Ollama fonctionne en local sans clé, ou via Ollama Cloud avec authentification (ollama signin).

Astuce : Si vous disposez déjà d'une configuration Zileo Chat (fichier d'export), vous pouvez l'importer à cette étape pour retrouver tous vos agents et paramètres.

Configuration initiale

Après l'assistant de bienvenue, vous devez configurer Zileo Chat en trois étapes : d'abord un provider (fournisseur de modèles IA), puis sélectionner un modèle, et enfin créer votre premier agent.

Étape 1

Configurer un Provider

Allez dans Paramètres > Providers pour connecter un fournisseur de modèles IA. Vous avez le choix entre Ollama (local, gratuit) ou Mistral (cloud, API).

Paramètres > Providers

Ollama Connecté

Mistral AI Non configuré

Ollama (local) Lancez Ollama sur votre machine. Zileo Chat le détecte automatiquement sur localhost:11434.

Mistral (cloud) Entrez votre clé API obtenue sur console.mistral.ai. Testez la connexion.

Étape 2

Ajouter un Modèle

Allez dans Paramètres > Modèles pour ajouter les modèles que vous souhaitez utiliser. Vous devez entrer manuellement le nom exact du modèle.

Paramètres > Modèles > Ajouter

Nom du modèle

deepseek-v3.2:cloud

Provider

Ollama

Context Window

128000

Max Output

8192

Température

0.7

Thinking (raisonnement)

Ajouter

Pour Ollama Recherchez votre modèle sur ollama.com/library pour trouver le context window et les spécifications. Exemple : deepseek-v3.2.

Pour Mistral Consultez la documentation des modèles Mistral pour les spécifications (context window, max tokens, tarifs).

Option Thinking Cochez uniquement pour les modèles de raisonnement. deepseek-v3.2 est un modèle thinking (cocher). mistral-large n'est pas un modèle thinking (ne pas cocher).

Ollama : Si ollama list est vide, téléchargez d'abord un modèle avec ollama run deepseek-v3.2:cloud.

Étape 3

Créer votre premier Agent

Allez dans Paramètres > Agents et cliquez sur "Créer un agent". Un agent combine un modèle avec des instructions spécifiques.

Créer un agent

Nouvel agent

Informations de base

Nom de l'agent

Mon Assistant

Cycle de vie

Permanent Conservé entre sessions

Temporaire Supprimé à la fermeture

Configuration LLM

Fournisseur

Mistral API Cloud

Ollama Local / Cloud

Modèle

DeepSeek V3.2 Cloud Thinking

deepseek-v3.2:cloud

128K ctx 8K out T: 0.7

Max itérations outils

Outils

Mémoire Stocke des informations

Todo Gère les tâches

Question utilisateur Pose des questions

Calculatrice Calculs mathématiques

Serveurs MCP

Serena Analyse de code

Prompt système

Instructions système

Tu es un assistant utile. Tu réponds de manière claire et structurée.

Nom : Identifie l'agent (ex: "Assistant Code", "Rédacteur")
Cycle de vie : Permanent (conservé entre sessions) ou Temporaire (supprimé à la fermeture)
Fournisseur : Mistral (API Cloud) ou Ollama (Local/Cloud)
Modèle : Sélection du LLM avec affichage des spécifications (context, output, température)
Max itérations outils : Limite le nombre d'appels outils consécutifs (défaut: 50)
Outils : Mémoire (stockage), Todo (gestion tâches), Question utilisateur, Calculatrice
Serveurs MCP : Connexion a des services externes (ex: Serena pour l'analyse de code)
Instructions système : Définit le comportement, la personnalité et les contraintes de l'agent

Prêt à démarrer : Une fois ces trois étapes complétées, vous pouvez créer votre premier workflow et commencer à utiliser Zileo Chat.

Interface principale

L'interface de Zileo Chat est divisée en trois zones principales : la barre latérale des workflows, la zone de conversation centrale, et le panneau d'activité à droite.

Zileo Chat

Analyse projet

En cours

Rédaction email

Terminé

Recherche docs

En attente

Nouveau workflow

Peux-tu analyser la structure de mon projet et me faire un résumé ?

Je vais analyser votre projet. Laissez-moi examiner la structure des fichiers et les dépendances...

Lecture fichiers...

Il y a 2s

Mémoire consultée

Il y a 5s

Agent démarré

Il y a 8s

Tokens: 1,247 / 4,096

Outils: 3 actifs

Coût: 0.012 EUR

Barre latérale des workflows

Gérez tous vos workflows actifs et passés. Chaque workflow représente une session de travail avec un agent. Les indicateurs de statut montrent en temps réel l'état de chaque tâche : en cours (vert), en attente, ou terminé.

Zone de conversation

Interagissez avec votre agent via une interface de chat intuitive. Les messages sont affichés avec une distinction claire entre vos requêtes et les réponses de l'agent. Le streaming permet de voir les réponses en temps réel. Si vous avez des prompts préenregistrés, cliquez sur l'icône livre à droite du champ de saisie (avant le bouton Envoyer) pour accéder à votre bibliothèque de prompts (raccourci : Ctrl+P).

Panneau d'activité

Suivez en temps réel toutes les actions de l'agent : outils utilisés, mémoires consultées, sous-agents activés. Cette transparence vous permet de comprendre exactement comment l'IA travaille pour vous.

Raccourcis clavier

CtrlT Nouveau workflow

CtrlW Fermer workflow

CtrlTab Workflow suivant

CtrlEnter Approuver validation

Premier workflow

Un workflow représente une session de travail complète avec un agent. Voici comment créer et exécuter votre premier workflow en quelques étapes simples.

Zileo Chat - Nouveau workflow

Étape 1 : Créer le workflow

Cliquez sur "+ Nouveau workflow" dans la barre latérale. Une fenêtre modale s'ouvre pour vous permettre de sélectionner l'agent et de nommer votre workflow.

Étape 2 : Envoyer votre message

Rédigez votre requête dans la zone de saisie et appuyez sur Entrée ou cliquez sur "Envoyer". L'agent commence immédiatement à traiter votre demande.

Zileo Chat - Workflow en cours

Explique-moi comment fonctionne le machine learning

MemoryTool : Recherche de contexte...

Statut: En cours

Tokens: 342 / 4,096

Durée: 4.2s

Étape 3 : Observer l'exécution

Pendant l'exécution, observez les indicateurs en temps réel : le statut du workflow, l'utilisation des tokens, les outils activés, et le coût estimé. L'animation de streaming indique que l'agent rédige sa réponse.

Validation Human-in-the-Loop : Si vous avez activé le mode de validation manuel ou sélectif, l'agent peut vous demander d'approuver certaines opérations (accès fichiers, requêtes base de données, etc.) avant de les exécuter.

Streaming temps réel : Les réponses s'affichent progressivement, sans attendre la fin de la génération complète.
Suivi des outils : Visualisez quels outils (MemoryTool, TodoTool, etc.) sont utilisés par l'agent pour accomplir votre tâche.
File d'attente : Vous pouvez envoyer plusieurs messages pendant qu'un workflow est en cours. Ils seront traités dans l'ordre.
Persistance : Tous vos workflows sont sauvegardés automatiquement. Retrouvez-les à tout moment dans la barre latérale.

Félicitations ! Vous avez maintenant toutes les bases pour utiliser Zileo Chat efficacement. Explorez les paramètres avancés pour configurer des serveurs MCP, la mémoire vectorielle, et créer des agents spécialisés.