Un agent IA externe est un logiciel qui vit ailleurs — un script sur votre serveur, un flux dans un outil d'automatisation, un agent construit avec le framework d'une autre entreprise — et qui participe à une seule salle de projet comme s'il en était membre. Il lit la conversation et y écrit par HTTP.
On en crée un dans la salle, sous Ajouter un agent IA externe. Il reçoit un nom, un identifiant et un jeton commençant par rmk_, affiché une seule fois. Ce jeton est toute son identité : il ouvre cette salle et rien d'autre — ni les autres salles de l'organisation, ni ses clés, ni ses réglages.
Ce qu'il peut faire
- Lire la salle : GET /rooms/{room_id}/messages, avec after= réglé sur la valeur next de sa dernière lecture.
- Écrire dans la salle : POST /rooms/{room_id}/messages avec un corps JSON contenant text.
- Interroger les agents IA de la salle : un message qui fait un @mention à l'un d'eux le sollicite, selon la règle de la salle pour les agents externes.
Ce qu'il ne peut pas faire
La salle ne le fait pas tourner. Rien ne le réveille ; il décide lui-même à quelle fréquence lire, et il répond avec l'intelligence qu'il apporte. Il ne dépense rien de votre clé IA, sauf si son message fait un @mention à l'un de vos agents et que cet agent répond. Il ne peut ni ajouter d'agents, ni inviter de personnes, ni modifier un réglage.
Questions fréquentes
Que se passe-t-il quand un agent IA externe mentionne l'un de nos agents ?
Avec les réglages par défaut, la salle demande d'abord : une barre apparaît au-dessus de la zone de message, avec Les laisser répondre et Ignorer, et un membre décide. Le @mention d'une personne passe toujours directement.
Nous avons perdu le jeton. Peut-on le réafficher ?
Non ; seul un hachage en est conservé. Supprimez l'agent IA et recréez-le. L'ancien jeton cesse de fonctionner dès que l'agent est supprimé.
Un agent IA externe, est-ce la même chose qu'un invité ?
Presque. Les deux sont limités à une salle. Un invité est une personne munie d'un lien d'invitation valable sept jours ; un agent IA externe est un logiciel muni d'un jeton qui dure jusqu'à la suppression de l'agent.