Guide d'utilisation de QuickAgent
QuickAgent est un espace de travail pour agents d'IA fonctionnant en priorité en local. Il transforme un objectif en une exécution durable, encadre cette exécution par un profil d'espace de travail, demande une validation avant toute action sensible et conserve les résultats vérifiés dans les Artefacts.
Premiers pas
- Ouvrez Réglages > IA, ajoutez un fournisseur et lancez son test de connexion.
- Ouvrez Réglages > Profils d'espace de travail. Choisissez le fournisseur, les outils, les connexions, les racines de fichiers, les sources de connaissances et les portées de mémoire pouvant être utilisés.
- Sélectionnez Nouvelle discussion, choisissez le profil et confirmez la destination du fournisseur affichée au-dessus de la conversation.
- Décrivez un résultat attendu. N'ajoutez que les fichiers, dossiers, médias, connaissances ou souvenirs nécessaires à cette exécution.
- Examinez le plan, les validations, la confirmation Critique et l'aperçu d'envoi de données lorsqu'ils apparaissent.
- Suivez le travail dans la chronologie. Ouvrez le résultat terminé depuis Artefacts et inspectez la piste d'audit dans Historique.
Présentation de l'interface
| Section | À quoi elle sert |
|---|---|
| Discussions | Conversations, destination du fournisseur, panneau de contexte, plans, validations et chronologie de l'exécution en cours. |
| Exécutions | Toutes les tâches planifiées, en cours, en pause, programmées, en échec ou terminées. |
| Boîte de validation | Les demandes d'action, les actions critiques et les envois de données en attente de votre décision. |
| Artefacts | Fichiers, rapports, journaux, médias, tableaux et manifestes d'opérations vérifiés, produits par les exécutions. |
| Automatisations | Planifications, surveillances, webhooks, événements d'application et déclencheurs de raccourcis ou d'App Intents. |
| Skills | Instructions réutilisables avec entrées typées, outils autorisés, connexions requises, niveau de risque et sorties. |
| Connexions | Fournisseurs, profils de navigateur, racines de fichiers/VFS, SSH, MCP, HTTP/SaaS, passerelles domestiques et canaux de notification. |
| Connaissances | Dossiers indexés, contenu QuickNote, extraits web, PDF et sources bureautiques. |
| Historique | Décisions de sécurité, actions d'outils, destinations et horodatages en ajout seul. |
| Réglages | Apparence, langue, IA, outils, sécurité, profils d'espace de travail, raccourcis, autorisations, aide et Pro. |
Fournisseurs et profils d'espace de travail
QuickAgent peut utiliser l'IA du système lorsque le système d'exploitation expose une capacité compatible, des fournisseurs locaux tels qu'Ollama, LM Studio ou DeskLLM, des points de terminaison compatibles OpenAI sur le réseau local ou personnalisés, ainsi que des fournisseurs cloud configurés comme Anthropic ou Gemini. La disponibilité est déterminée par un test de capacité en direct ; le seul nom d'un fournisseur ne signifie pas qu'il est prêt.
Un profil d'espace de travail constitue l'enveloppe de permissions de l'exécution. Il fige le fournisseur/modèle sélectionné, les outils autorisés, les connexions, les racines de fichiers, les sources de connaissances, les portées de mémoire, les dérogations de sécurité et le budget. Une modification ultérieure de la configuration rend cet instantané obsolète et impose une nouvelle validation.
Exécutions, validations et reprise
Commandes d'exécution
- Pause demande un arrêt coopératif à un point de reprise durable.
- Reprendre poursuit la même exécution et le travail déjà accompli.
- Arrêter interrompt le travail du fournisseur et des outils. Un effet externe arrêté ou incertain n'est jamais signalé comme réussi.
- Réessayer n'est disponible que lorsque QuickAgent peut identifier une limite de reprise sûre.
Niveaux de sécurité
| Niveau | Signification |
|---|---|
| Sûr | Lire, inspecter ou transformer dans le cadre du profil actif. |
| Valider | Examiner une écriture ordinaire ou une action externe. |
| Vérifiez que | Examiner une modification à fort impact ou difficile à annuler. |
| Critique | Confirmation explicite à chaque fois ; aucune règle ne peut la valider automatiquement. |
La validation affiche la cible exacte, la destination, les arguments proposés, le risque et la possibilité d'annulation. Si vous modifiez un argument, QuickAgent revalide et réévalue le risque de l'action modifiée.
Exécutions multi-agents
Les objectifs complexes peuvent mobiliser un planificateur, des agents spécialisés typés, un relecteur et un relecteur sécurité. La chronologie montre chaque transmission, relecture, nouvelle tentative, repli et limite de réponse finale. Les agents ne reçoivent que l'intersection des quatre ensembles : outils du Skill, outils du profil d'espace de travail, outils du rôle et outils actuellement actifs.
Des budgets globaux et par rôle limitent les invocations, la durée, le coût, les octets réseau et les jetons. Lorsqu'un budget est atteint, QuickAgent met en pause. Il affiche les limites actuelles et proposées, et ne les relève qu'après une validation explicite. Le budget approuvé et l'historique des rôles terminés survivent à un redémarrage.
Contexte, connaissances et mémoire d'IA
Panneau de contexte
Ajoutez des fichiers, dossiers, images, images vidéo, contenus audio, notes vocales, contenus QuickNote, connaissances ou mémoire d'espace de travail. QuickAgent extrait ou résume les contenus pris en charge et indique si une pièce jointe sera envoyée directement à un fournisseur.
Connaissances
Les sources de connaissances sont indexées séparément des discussions. Une exécution ne peut interroger que les sources autorisées par son profil d'espace de travail, et les citations conservent l'identité de leur source.
Mémoire
La mémoire est délibérée : ce n'est pas un historique de discussion automatique. Les portées Utilisateur, Espace de travail, Projet et Outil/Connexion sont distinctes. Chaque demande de création, de modification ou de suppression fait l'objet d'une nouvelle validation, et l'aperçu de validation indique la portée et la valeur exacte proposée.
Outils et connexions
Le catalogue actif couvre les opérations sur fichiers/VFS ; la bureautique, les PDF et les données structurées ; les médias et l'OCR ; l'utilisation du navigateur et de l'ordinateur ; les commandes de développement ; SSH ; MCP ; HTTP et SaaS ; les passerelles domotiques ; les notifications ; les planifications ; les surveillances ; et le pilotage des automatisations. Les serveurs MCP connectés peuvent ajouter des outils dynamiques après validation du schéma et réévaluation du risque par QuickAgent.
Réglages > Outils indique pourquoi un outil est prêt ou désactivé. Les motifs courants sont une connexion manquante, une autorisation du système d'exploitation, une plateforme non prise en charge, une restriction du profil d'espace de travail, un point de terminaison non testé ou une capacité de fournisseur indisponible.
Automatisations
Les automatisations peuvent être déclenchées par l'heure, un fichier/dossier, le web, un webhook, un e-mail, un calendrier, le réseau, un hôte, un appareil, un capteur, une position, un événement d'application, un raccourci/App Intent, une commande ou une action manuelle, lorsque la plateforme le permet. Un déclencheur crée une exécution ordinaire ; il ne contourne ni le profil d'espace de travail, ni les validations, ni les confirmations critiques, ni le contrôle des envois de données.
- Sur ordinateur, la surveillance ne se poursuit que tant que le processus de l'application est en cours d'exécution.
- Les plateformes mobiles rattrapent le travail en retard lorsque l'application repasse au premier plan.
- Utilisez un raccourci/App Intent ou un relais d'événements de confiance lorsque la livraison par le système d'exploitation est nécessaire.
- Les événements en file d'attente, la mise en pause, l'annulation et la suppression restent explicites, afin qu'aucun événement ne soit silencieusement abandonné.
Skills et packs de Skills
Un Skill enregistre une consigne orientée résultat, des variables typées, une recommandation de fournisseur, les outils autorisés, les connexions et capacités requises, le risque maximal et les artefacts attendus. Avant utilisation, QuickAgent affiche les entrées et les permissions effectives ; cet aperçu n'accorde pas lui-même les permissions.
Sept packs intégrés fournissent de véritables Skills pour la bureautique, le développement, la maison connectée, la recherche, l'automatisation du navigateur, l'administration personnelle et la gestion d'incidents. Vous pouvez installer, mettre à jour, désinstaller, personnaliser, dupliquer, importer et exporter des Skills. Le JSON importé reçoit un aperçu de confiance, d'éditeur, de signature, de permissions, de risque, de plateforme et de conflits. « Conserver les deux » crée une variante locale non signée plutôt que d'hériter de la confiance accordée à un autre éditeur.
Artefacts, historique et annulation
Les artefacts conservent les octets de sortie, les métadonnées, les versions, la provenance, l'exécution d'origine et les manifestes d'opérations. Selon les capacités de la plateforme, vous pouvez les ouvrir, les partager, les exporter ou les localiser. Les opérations éligibles proposent une annulation soumise à validation ; le travail destructeur ou incertain n'est jamais rejoué automatiquement.
L'historique est en ajout seul. Filtrez-le par Sûr, Valider, Confirmer ou Critique, et exportez l'audit lorsque vous avez besoin d'une trace externe.
Réglages
- Général : apparence, langue, profils d'espace de travail, raccourcis, aide et autorisations.
- IA : fournisseurs, points de terminaison, modèles, identifiants et tests en direct.
- Outils : état de préparation du catalogue, prise en charge par la plateforme et étapes de configuration à effectuer.
- Sécurité : règles de validation, comportement des envois de données, authentification de l'appareil et politique de mémoire par portée.
- Avancé : récupération et diagnostics destinés au dépannage.
Raccourcis clavier
Sur macOS, l'application associe les raccourcis Ctrl affichés à la touche Commande de la plateforme lorsque cela est pertinent. La page Raccourcis intégrée à l'application fait foi et permet la personnalisation.
| Raccourci | Action |
|---|---|
| Ctrl + N | Nouvelle discussion |
| Ctrl + L | Placer le curseur dans le champ de saisie |
| Ctrl + Maj + Espace | Mettre en pause ou reprendre l'exécution en cours |
| Ctrl + . | Arrêter l'exécution en cours |
| Ctrl + 1 … 9 | Ouvrir les discussions via l'historique |
| Ctrl + , | Ouvrir les réglages |
| F1 | Ouvrir Aide & confidentialité |
| Échap | Fermer une boîte de dialogue ou annuler l'interaction non destructrice en cours |
Remarques par plateforme
| Plateforme | Limites importantes |
|---|---|
| macOS | Exécution en bac à sable en Debug comme en Release. L'accès aux fichiers passe par les racines sélectionnées et des signets à portée de sécurité. L'enregistrement de l'écran et l'accessibilité sont deux autorisations système distinctes. Les intégrations de processus locaux et de raccourcis restent soumises à des tests de capacité. |
| Windows | Les fonctions de fichiers, de bureautique/PDF/données, de navigateur, de développement, d'accès distant et de contrôle du bureau dépendent de l'environnement d'exécution installé et des autorisations. Les intégrations propres à Apple sont indisponibles, avec un motif affiché. |
| iPhone / iPad | Les fichiers passent par le sélecteur système. L'appareil photo, le microphone, la reconnaissance vocale, les photos, le réseau local et les notifications sont demandés en contexte. La surveillance en arrière-plan n'est pas garantie ; utilisez les raccourcis/App Intents ou le rattrapage au premier plan. |
| Android | Les fichiers et dossiers passent par le Storage Access Framework. Le travail en arrière-plan respecte les restrictions Android. Le contrôle de saisie par l'accessibilité n'est jamais considéré comme accordé du simple fait qu'un service est déclaré. |
| Web | Utilise un stockage limité à la session pour les fonctions nécessitant une persistance native et désactive clairement les capacités d'appareil, de racine de fichiers, de processus local et d'arrière-plan non prises en charge. |
Astuces & conseils
Dépannage
| Problème | À vérifier |
|---|---|
| Le fournisseur ne peut pas s'exécuter | Ouvrez Réglages > IA. Vérifiez la configuration, l'authentification, les capacités du modèle, l'accessibilité du point de terminaison, le délai d'attente et les limites de débit, puis lancez le test de connexion. |
| Un outil est désactivé | Ouvrez Réglages > Outils et lisez le motif affiché en direct. Vérifiez la plateforme actuelle, les autorisations, le test de connexion, le profil d'espace de travail et la racine sélectionnée. |
| Une exécution semble bloquée | Ouvrez Exécutions et la chronologie. Elle peut être en pause, en attente d'une saisie, d'une validation, d'une confirmation critique, d'un contrôle d'envoi de données ou d'une révision de budget. Le bouton d'arrêt reste disponible. |
| Une autorisation a changé | Ouvrez Aide > Vue d'ensemble ou les Réglages, puis ouvrez les réglages système. Retestez la connexion ou l'outil concerné à votre retour. |
| Une action externe est incertaine | Vérifiez le système cible. Laissez l'exécution en pause ou arrêtez-la, sauf si vous avez confirmé qu'une nouvelle tentative est appropriée. |
| Une automatisation ne s'est pas déclenchée en arrière-plan | Les systèmes mobiles ne garantissent pas une interrogation arbitraire. Revenez au premier plan pour le rattrapage, ou configurez un raccourci/App Intent ou une source d'événements de confiance. |
| Un artefact ne peut pas être ouvert ou exporté | Vérifiez si ses octets sont toujours disponibles, si la plateforme prend en charge l'action et si l'autorisation de la destination choisie est toujours valide. |
Confidentialité, autorisations et licences
QuickAgent stocke localement les conversations, les exécutions, les validations, les métadonnées de connaissances, les Skills et les réglages. Les identifiants utilisent le stockage protégé par la plateforme. Le contenu ne quitte l'appareil que via un fournisseur ou un service connecté que vous configurez, et chaque envoi externe fait l'objet d'un aperçu indiquant la destination.
Les autorisations sont demandées en contexte : fichiers/dossiers, photos, appareil photo, microphone, reconnaissance vocale, réseau local, notifications, enregistrement de l'écran et contrôle de l'accessibilité/de la saisie sont indépendants. Retirer une autorisation rend la capacité concernée indisponible, plutôt que de produire une fausse réussite.
Ouvrez Réglages > Aide & confidentialité pour consulter le tableau des capacités de la plateforme actuelle, et Licences open source pour les mentions relatives aux paquets et aux composants natifs intégrés.