Démonstration

Guide · Débutants

Créer son premier assistant en trois étapes

Connecter un modèle de langage, constituer un corpus, configurer l’assistant et le tester — le parcours de base dans EasyRag.

Découverte 15 minMis à jour le

Ce guide suit le parcours de création décrit dans la documentation utilisateur : un identifiant de modèle, un corpus, un assistant. Il suppose que vous disposez d’un compte avec le rôle Administrateur ou Propriétaire sur une instance EasyRag.

1. Ajouter un identifiant de modèle de langage

Dans l’administration, ouvrez Identifiants puis ajoutez un identifiant :

  • choisissez le fournisseur (OpenAI, Mistral, Anthropic, Google Gemini, ou un serveur Ollama, vLLM ou compatible OpenAI) ;
  • saisissez la clé d’API ou, pour un serveur interne, son adresse ;
  • donnez-lui un nom explicite (par exemple « Mistral — production »).

La clé est chiffrée dès l’enregistrement. Vous pourrez la partager avec des utilisateurs nommés sans jamais la leur montrer.

Utilisez le bouton de test du modèle pour vérifier la connexion avant d’aller plus loin.

2. Créer un corpus documentaire

Ouvrez Corpus, créez un corpus (par exemple « Procédures RH ») puis importez vos documents.

Formats pris en charge : PDF, Word (.docx), PowerPoint (.pptx), Excel (.xlsx), CSV, texte, Markdown, HTML et JSON. Les images, PDF numérisés, fichiers audio et vidéo demandent des clés supplémentaires (OCR, transcription) configurées par l’administrateur de l’instance.

Chaque document passe par l’extraction du texte, le découpage, l’enrichissement contextuel et la vectorisation. Si la validation des contenus est activée, il peut aussi être mis en quarantaine en attendant une décision.

Utilisez la recherche de test du corpus pour vérifier que vos documents sont bien retrouvés.

3. Créer et configurer l’assistant

Ouvrez Assistants et lancez l’assistant de création :

  1. décrivez l’objectif en une phrase (« Répondre aux questions des salariés sur les congés et les absences ») ;
  2. l’IA propose un nom, une description, un prompt système, un message d’accueil et des questions d’amorce ;
  3. choisissez l’identifiant et le modèle créés à l’étape 1 ;
  4. sélectionnez le corpus de l’étape 2.

Relisez le prompt système : il doit préciser le rôle, le périmètre, le ton et le comportement attendu en l’absence de réponse dans les documents.

4. Tester

Ouvrez la fenêtre de test de l’assistant et posez :

  • une question dont la réponse figure clairement dans un document — vérifiez la citation ;
  • une question hors périmètre — l’assistant doit le signaler ;
  • une question formulée autrement que dans le document — la recherche doit la retrouver.

Chaque modification de configuration crée une nouvelle version : vous pouvez comparer et revenir en arrière à tout moment.

Et ensuite ?