Adresse e-mail de l'agent
Chaque session Indagis peut disposer d'une adresse e-mail dédiée sur le domaine cloud.indagis-labs.fr. Cette adresse agit comme une boîte aux lettres numérique pour l'agent : des fichiers, des ordres, des reçus, des CV ou tout autre contenu peuvent y être envoyés depuis l'extérieur. L'agent consulte périodiquement cette boîte et traite son contenu selon les instructions qu'il a reçues.
Cette fonctionnalité transforme l'agent d'un simple interlocuteur actif en un point de contact réactif. Elle est particulièrement utile dans les workflows où des humains ou des systèmes envoient spontanément des documents à traiter, sans avoir à ouvrir un chat ou à appeler une API.
Concept
L'adresse e-mail de l'agent est rattachée à un profil ou à une session spécifique. Lorsqu'un message arrive, il est stocké dans une file de traitement. Selon la configuration, l'agent peut :
- traiter immédiatement le message ;
- attendre une validation humaine (
pending_approval) ; - enregistrer simplement le message dans un dossier pour consultation ultérieure.
L'adresse prend généralement la forme :
<identifiant-session>@cloud.indagis-labs.fr
Par exemple, une session dédiée à la collecte de CV pourrait avoir l'adresse recrutement-2026@cloud.indagis-labs.fr.
L'e-mail est un canal asynchrone et unidirectionnel par défaut : le correspondant envoie un message, l'agent le traite. Si une réponse est nécessaire, l'agent peut être configuré pour répondre depuis la même adresse, sous réserve que le fournisseur de messagerie associé le permette.
Setup
Activer la fonctionnalité
Dans ~/.indagis/profiles/<profil>/config.yaml :
email_gateway:
enabled: true
provider: indagis-cloud
domain: cloud.indagis-labs.fr
mailbox: recrutement-2026
require_approval: true
allowed_senders: []
save_attachments_to: /shared/inbox/recrutement
auto_reply: false
enabled: active la réception d'e-mails.provider: backend de messagerie, iciindagis-cloud.mailbox: partie locale de l'adresse.require_approval: sitrue, chaque message requiert une validation avant traitement.allowed_senders: liste blanche d'expéditeurs. Si vide, tous les expéditeurs sont acceptés.save_attachments_to: répertoire où enregistrer les pièces jointes.auto_reply: sitrue, l'agent envoie un accusé de réception automatique.
Commandes CLI associées
L'adresse e-mail de l'agent peut être gérée depuis la ligne de commande :
| Commande | Effet |
|---|---|
indagis email enable --mailbox <nom> | Active une adresse pour le profil courant. |
indagis email disable --mailbox <nom> | Désactive l'adresse. |
indagis email list | Liste les boîtes actives du profil. |
indagis email status --mailbox <nom> | Affiche le nombre de messages en attente. |
indagis email approve --id <message-id> | Valide un message en file d'approbation. |
indagis email reject --id <message-id> | Rejette un message. |
Ces commandes sont également accessibles en session interactive via les slash commands /email enable, /email disable, /email status et /email approve.
Associer à une session
Pour obtenir une adresse dédiée à une session en cours :
/email enable recrutement-2026
L'agent confirme l'adresse complète et commence à scruter la boîte. La commande /email disable désactive la réception pour cette session.
Vérifier la connectivité
indagis email test --profile default --mailbox recrutement-2026
Cette commande envoie un e-mail de test vers l'adresse et vérifie que l'agent le reçoit correctement.
Cas d'usage
Réception de CV
Un recruteur peut publier l'adresse candidatures@cloud.indagis-labs.fr sur une offre d'emploi. Les candidats envoient leur CV par e-mail. L'agent :
- enregistre la pièce jointe dans
/shared/cv/; - extrait les informations clés (nom, expérience, compétences, diplômes) ;
- écrit un résumé structuré dans
/shared/cv/summaries/; - notifie l'équipe de recrutement dans un canal Slack.
Ce scénario peut être combiné avec la fonctionnalité d'extraction de documents et le mode bot.
Collecte de reçus et factures
Un comptable ou un entrepreneur peut donner l'adresse de l'agent à ses fournisseurs ou à ses clients. Les factures reçues sont automatiquement extraites et transformées en lignes comptables. L'agent détecte les doublons et signale les anomalies.
Déclenchement de tâches
Un e-mail peut servir de déclencheur pour une action complexe. Par exemple, un responsable envoie un message à rapports@cloud.indagis-labs.fr avec le sujet rapport hebdomadaire. L'agent génère le rapport demandé et le renvoie en pièce jointe.
Réception de fichiers de terrain
Une équipe sur le terrain envoie des captures d'écran, des photos de documents ou des notes par e-mail. L'agent les classe, les renomme et les analyse. L'adresse e-mail devient une simple interface d'ingestion pour des utilisateurs non techniques.
Sécurité
L'e-mail est un canal non authentifié et asynchrone. N'importe qui peut envoyer un message à l'adresse de l'agent. Cela crée une surface d'attaque par injection de prompt.
Mesures de protection
- Approbation obligatoire :
require_approval: trueplace chaque message dans une file d'attente. L'opérateur humain valide avant traitement. - Liste blanche d'expéditeurs :
allowed_senderslimite les expéditeurs autorisés. - Pas d'action automatique sur les instructions : l'agent ne doit jamais exécuter directement les commandes contenues dans le corps d'un e-mail. Les instructions textuelles sont traitées comme du contenu, pas comme des ordres.
- Sandbox d'exécution : les traitements déclenchés par e-mail s'exécutent dans le terminal environment configuré.
- Journal d'audit : chaque message reçu, chaque pièce jointe et chaque action entreprise est enregistrée.
Recommandations d'usage
- Utilisez une adresse dédiée par usage ou par session, plutôt qu'une seule adresse générique.
- Ne rattachez pas l'adresse de l'agent à des processus sensibles (récupération de mot de passe, validations financières).
- Vérifiez régulièrement la file d'approbation pour détecter les tentatives d'abus.
- Combinez l'e-mail de l'agent avec le mode gateway pour bénéficier d'une authentification par token en plus de la réception simple.
- Activez l'extraction de documents pour automatiser le traitement des pièces jointes.
- Utilisez le mode bot pour traiter les messages entrants de manière asynchrone.
Exemple de file d'approbation
Lorsque require_approval: true est activé, chaque message entrant apparaît dans une file d'approbation :
[indagis email status --mailbox recrutement-2026]
Boîte : recrutement-2026@cloud.indagis-labs.fr
Messages en attente : 3
- msg-001 : candidature@example.com, sujet "Candidature développeur", 1 pièce jointe
- msg-002 : unknown@spammer.net, sujet "Urgent", 0 pièce jointe
- msg-003 : factures@fournisseur.fr, sujet "Facture septembre", 1 pièce jointe
L'opérateur peut alors approuver ou rejeter chaque message individuellement, ce qui réduit considérablement le risque d'exécution automatique de contenus malveillants.