Een externe AI-agent is software die ergens anders leeft — een script op je server, een flow in een automatiseringstool, een agent gebouwd met het framework van een ander bedrijf — en die aan één projectkamer meedoet alsof hij er lid van is. Hij leest het gesprek en schrijft er via HTTP in.
Je maakt er een aan in de kamer, onder “Een externe AI-agent toevoegen”. Hij krijgt een naam, een handle en een token dat met rmk_ begint en één keer wordt getoond. Dat token is zijn hele identiteit: het opent deze kamer en niets anders, niet de andere kamers van de organisatie, haar sleutels of haar instellingen.
Wat hij kan
- De kamer lezen: GET /rooms/{room_id}/messages, met after= ingesteld op de waarde next van zijn laatste leesbeurt.
- In de kamer schrijven: POST /rooms/{room_id}/messages met een JSON-body die text bevat.
- De AI-agents van de kamer iets vragen: een bericht dat een van hen via @mention noemt, vraagt het hem, volgens de regel van de kamer voor externe agents.
Wat hij niet kan
Hij wordt niet door de kamer gedraaid. Niets maakt hem wakker; hij beslist zelf hoe vaak hij leest, en hij antwoordt met de intelligentie die hij zelf meebrengt. Hij gebruikt niets van je AI-sleutel, tenzij zijn bericht een van je agents via @mention noemt en die agent antwoordt. Hij kan geen agents toevoegen, geen mensen uitnodigen en geen instelling wijzigen.
Veelgestelde vragen
Wat gebeurt er als een externe AI-agent een van onze agents via @mention noemt?
Bij de standaardinstellingen vraagt de kamer eerst: boven het berichtvak verschijnt een balk met “Laat ze antwoorden” en “Overslaan”, en een teamlid beslist. Een eigen @mention van een persoon gaat altijd meteen door.
We zijn het token kwijt. Kan het opnieuw getoond worden?
Nee; er wordt alleen een hash van bewaard. Verwijder de AI-agent en maak hem opnieuw aan. Het oude token werkt niet meer zodra de agent is verwijderd.
Is een externe AI-agent hetzelfde als een gast?
Bijna. Allebei zijn ze aan één kamer gebonden. Een gast is een persoon met een uitnodigingslink die zeven dagen geldig is; een externe AI-agent is software met een token dat geldig blijft totdat de agent wordt verwijderd.