Guide complet pour travailler avec les assistants IA dans AYETO

Bienvenue dans ce guide qui vous présentera toutes les fonctionnalités liées au travail avec les assistants IA sur la plateforme AYETO. Vous apprendrez à créer, configurer et utiliser efficacement vos propres assistants IA.

Table des matières

1. Qu’est-ce qu’un assistant IA ?
2. Accéder aux assistants
3. Créer un nouvel assistant
4. Galerie de modèles
5. Modifier un assistant existant
6. Base de connaissances (RAG)
7. Attribution des tâches
8. Outils IA
9. Partager un assistant
10. Exportation et importation
11. Travailler avec les conversations
12. Paramètres avancés
13. Conseils et astuces

Qu’est-ce qu’un assistant IA ?

Un assistant IA dans AYETO est votre assistant IA personnalisé qui combine :

• Un modèle linguistique sélectionné (par ex. GPT-4, Claude, Gemini)
• Des instructions personnalisées définissant la personnalité et le comportement
• Une base de connaissances contenant vos documents (facultatif)
• Des outils IA pour des fonctionnalités étendues (recherche web, génération d’images, etc.)

Grâce aux assistants, vous pouvez disposer d’IA spécialisées pour différentes tâches — de la programmation au support client, en passant par l’écriture créative.

Accéder aux assistants

Ouvrir la boîte de dialogue des assistants

1. Cliquez sur l’icône Assistants dans le menu principal
2. Une boîte de dialogue s’ouvre avec la liste de tous vos assistants
3. Vous pouvez effectuer une recherche à l’aide du champ de recherche

Aperçu d’un assistant

Chaque carte d’assistant affiche :

• Le nom et l’avatar
• Le modèle de chat (modèle linguistique pour les conversations)
• Le modèle d’image (modèle pour la génération d’images)
• L’identifiant de l’assistant (pour un usage avancé)
• Une icône de partage (si l’assistant est partagé)

Créer un nouvel assistant

La création d’un nouvel assistant se fait via un assistant en plusieurs étapes :

Étape 1 : Informations de base

💡 Conseil : La description est obligatoire si vous prévoyez d’utiliser l’assistant dans une équipe IA !

Étape 2 : Sélection du modèle

• Modèle de chat – le modèle linguistique principal (nous recommandons les modèles prenant en charge les outils)
• Modèle d’image – modèle pour la génération d’images

Étape 3 : Instructions

Ici, vous définissez la personnalité et le comportement de l’assistant :

Vous êtes un assistant technique amical spécialisé dans la programmation Python.
Vous répondez de manière concise et factuelle. Fournissez toujours des exemples de code.

⚠️ Avertissement : Les instructions ne doivent pas être vides et sont soumises à une limite de longueur.

Étape 4 : Outils IA

Sélectionnez les outils dont l’assistant disposera :

Outils de base :

• Recherche web
• Génération d’images
• Gestion des fichiers
• Et plus encore...

Outils avancés :

• Exécution de code
• Intégration avec des services externes
• Fonctions spéciales

Étape 5 : Paramètres RAG

Le RAG (Retrieval-Augmented Generation) permet à l’assistant de travailler avec une base de connaissances issue de vos documents :

• Outils IA – activer la Recherche dans la base de connaissances

Paramètres RAG avancés :

• Taille des segments (Chunk size) – taille des segments de document (0 = par défaut)
• Top K – nombre de segments pertinents à récupérer (0 = par défaut)

Étape 6 : Téléverser des documents

Formats pris en charge :

• PDF, DOCX, TXT
• Fichiers Markdown
• Et autres formats texte

Étape 7 : Vérification et création

Vérifiez le résumé des paramètres et cliquez sur Créer l’assistant.

Galerie de modèles

Vous ne voulez pas partir de zéro ? Utilisez des modèles prêts à l’emploi !

Comment utiliser un modèle

1. Dans la boîte de dialogue des assistants, cliquez sur Galerie
2. Parcourez les modèles par catégorie ou par étiquettes
3. Sélectionnez un modèle et cliquez sur Utiliser ce modèle
4. L’assistant sera créé avec des valeurs préconfigurées

Filtrer les modèles

• Tous – liste complète
• Recommandés – modèles sélectionnés
• Par étiquettes – filtrage par catégories

Modifier un assistant existant

Accéder aux paramètres

1. Dans la liste des assistants, cliquez sur le menu (trois points)
2. Sélectionnez Modifier
3. Ou cliquez sur l’icône des paramètres dans la conversation

Onglets des paramètres

Général

• Nom et description
• Sélection du modèle
• Instructions pour l’assistant

Outils

• Aperçu de tous les outils IA disponibles
• Regroupés par catégories
• Possibilité d’activer/désactiver chaque outil individuellement

Base de connaissances

• La base de connaissances est utilisée via l’outil « Recherche dans la base de connaissances »
• Gestion des documents téléversés
• Ajout de transcriptions YouTube

Conversations

• Aperçu des conversations avec l’assistant

Tâches

• Aperçu des tâches que l’assistant est censé effectuer

Avancé

• Température du modèle – créativité des réponses (0 = conservateur, 1 = créatif)
• Mémoire de l’assistant – notes à long terme pour l’assistant

Base de connaissances (RAG)

Qu’est-ce que le RAG ?

Le RAG (Retrieval-Augmented Generation) combine :

1. La recherche des parties pertinentes de vos documents
2. La génération d’une réponse basée sur les informations trouvées

Téléverser des documents

1. Allez dans l’onglet Base de connaissances
2. Cliquez sur Téléverser de nouveaux documents
3. Sélectionnez les fichiers (la taille maximale et la quantité sont limitées)
4. Attendez le traitement

Transcriptions YouTube

Vous pouvez également ajouter des transcriptions de vidéos YouTube :

1. Allez dans l’onglet Ajouter une transcription YouTube
2. Collez l’URL de la vidéo
3. Cliquez sur Ajouter

Gestion des documents

• Voir tous les documents téléversés
• Supprimer des documents individuels
• Supprimer tous les documents en masse

Attribution des tâches

À quoi servent les tâches ?

Les tâches sont utilisées pour automatiser les activités de l’assistant.

1. Pour une tâche, nous spécifions l’invite de tâche
2. Nous définissons la méthode de déclenchement de la tâche
3. Les résultats d’exécution de la tâche sont stockés sous forme de conversation pour la tâche
4. Cette conversation commence par l’invite de tâche et se poursuit avec la réponse de l’assistant

Définition de la tâche

1. Nom de la tâche - le nom par lequel nous désignerons la tâche
2. Description - une brève description de la tâche
3. Invite - des instructions expliquant à l’agent ce qu’il doit faire dans le cadre de la tâche

Configuration du déclencheur de tâche

1. Manuel - la tâche n’est lancée que manuellement - en appuyant sur le bouton Exécuter maintenant.

2. Planifié - la tâche se lance automatiquement à l’heure planifiée - sélectionnez le fuseau horaire - entrez la date et l’heure

3. Récurrent - la tâche se lance de façon répétée selon le calendrier spécifié - le même format de paramètres est utilisé que pour le service cron - dans la sélection Calendrier, des exemples de paramètres sont disponibles - l’élément Personnalisé ouvre l’édition d’une expression cron personnalisée - sélectionnez le fuseau horaire

Paramètres avancés de la tâche

1. Statut - actif - la tâche peut être démarrée - en pause - la tâche ne s’exécute pas
2. Nombre maximal d’exécutions - une limite sur le nombre de fois où la tâche peut s’exécuter

Notifications

1. Notifier à la fin - une notification concernant le résultat est envoyée une fois la tâche terminée
2. Notifier en cas d’échec - une notification est envoyée en cas d’échec

Bouton Supprimer

• supprime la tâche et son historique

Bouton Historique

• affiche l’historique d’exécution

Bouton Exécuter maintenant

• démarre la tâche
• démarre également les tâches planifiées, c’est-à-dire en dehors du planning

Historique d’exécution des tâches

• après l’exécution d’une tâche, les informations sur son résultat sont stockées dans Historique d’exécution
• les exécutions individuelles sont disponibles dans la liste
• après avoir cliqué, le résultat de l’exécution est disponible, c’est-à-dire la conversation créée par l’exécution de la tâche
• le bouton Conversation complète affiche l’intégralité de la conversation dans le contexte de la conversation
• cette conversation contient l’invite de tâche et la réponse de l’assistant, c’est-à-dire l’exécution de la tâche
• vous pouvez continuer la conversation plus loin à cet endroit
• ⚠️ cependant, la conversation n’est stockée que dans l’historique de la tâche, c’est-à-dire qu’elle n’est pas visible dans la liste normale des conversations

Outils IA

Vue d’ensemble des outils

Les outils IA étendent les capacités de l’assistant. Ils sont divisés en groupes :

Exigences des outils

⚠️ Pour utiliser les outils, le modèle sélectionné doit prendre en charge l’appel de fonctions (capacité d’utiliser des outils).

Partager un assistant

Partage avec d’autres utilisateurs

1. Dans les paramètres de l’assistant, allez dans la section Partage
2. Cliquez sur Partager avec un utilisateur
3. Saisissez l’adresse e-mail de l’utilisateur
4. Enregistrez les modifications

Autorisations de partage

Le partage permet à d’autres utilisateurs de :

• Utiliser l’assistant dans des conversations
• Copier l’assistant (crée leur propre copie)
• Exporter l’assistant

Exportation et importation

Exporter un assistant

1. Dans le menu de l’assistant, sélectionnez Exporter
2. Choisissez les options : - ✅ Inclure la base de connaissances - ✅ Inclure la mémoire
3. Cliquez sur Télécharger le fichier d’exportation

L’exportation crée un fichier JSON contenant tous les paramètres.

Importer un assistant

1. Dans la boîte de dialogue des assistants, cliquez sur Importer
2. Sélectionnez le fichier JSON
3. Entrez un nom pour l’assistant importé
4. Choisissez les options : - ✅ Importer la base de connaissances - ✅ Importer la mémoire
5. Cliquez sur Importer

Copier un assistant

Pour créer rapidement une copie :

1. Dans le menu de l’assistant, sélectionnez Copier
2. Entrez un nouveau nom
3. Choisissez si vous souhaitez copier la base de connaissances
4. Confirmez

Travailler avec les conversations

Démarrer une conversation

1. Dans la liste des assistants, cliquez sur Chat
2. Ou créez une nouvelle conversation et sélectionnez l’assistant

Interface de chat

• En-tête – informations sur l’assistant et le modèle
• Historique des messages – conversations précédentes
• Champ de saisie – rédaction des messages, téléversement de fichiers

Fonctionnalités dans la conversation

• Génération d’images – basculer vers le mode génération d’images
• Pièces jointes – téléverser des fichiers et des images
• Saisie vocale – dicter des messages
• Exporter la conversation – enregistrer en PDF ou DOCX

Paramètres avancés

Température du modèle

Affecte la créativité des réponses :

Mémoire de l’assistant

Mémoire à long terme pour stocker :

• Les préférences de l’utilisateur
• Des informations importantes
• Le contexte à travers les conversations

La mémoire peut être modifiée dans les paramètres avancés.

Mode RAG strict

Lorsqu’il est activé :

• L’assistant répond UNIQUEMENT sur la base des documents
• Il n’ajoute pas d’informations issues des connaissances générales du modèle
• Idéal pour des réponses précises et vérifiables

Conseils et astuces

📝 Instructions efficaces

✅ Bon :
"Vous êtes un expert Python. Répondez de manière concise. Fournissez toujours des exemples de code."

❌ Mauvais :
"Soyez un bon assistant."

🎯 Spécialisation

Créez plusieurs assistants pour différentes tâches :

• Programmeur – aide technique
• Rédacteur – textes créatifs
• Analyste – travail avec les données

📚 Optimisation du RAG

• Téléversez des documents pertinents et de haute qualité
• Divisez les grands documents en parties plus petites
• Mettez régulièrement à jour la base de connaissances

🔧 Sélection du modèle

• Pour les tâches complexes : GPT-4, Claude 3 Opus
• Pour les réponses rapides : GPT-3.5, Claude 3 Haiku
• Pour le code : modèles avec prise en charge des outils

💾 Sauvegarde

Exportez régulièrement les assistants importants en cas de :

• Suppression accidentelle
• Transfert vers un autre compte
• Partage avec des collègues

Besoin d’aide ?

• 📧 Contactez le support
• 📖 Consultez la section FAQ