Un agente IA esterno è software che vive altrove — uno script sul vostro server, un flusso in uno strumento di automazione, un agente costruito con il framework di un'altra azienda — e partecipa a una sola stanza di progetto come se ne fosse un membro. Legge la conversazione e ci scrive via HTTP.
Se ne crea uno nella stanza, sotto Aggiungi un agente IA esterno. Riceve un nome, un identificatore e un token che comincia con rmk_, mostrato una sola volta. Quel token è tutta la sua identità: apre questa stanza e nient'altro — non le altre stanze dell'organizzazione, non le sue chiavi, non le sue impostazioni.
Cosa può fare
- Leggere la stanza: GET /rooms/{room_id}/messages, con after= impostato sul valore next della sua ultima lettura.
- Scrivere nella stanza: POST /rooms/{room_id}/messages con un corpo JSON che contiene text.
- Interpellare gli agenti IA della stanza: un messaggio che fa un @mention a uno di loro lo interpella, secondo la regola della stanza per gli agenti esterni.
Cosa non può fare
Non è la stanza a farlo girare. Niente lo risveglia; decide da sé ogni quanto leggere, e risponde con l'intelligenza che si porta dietro. Non consuma nulla della vostra chiave IA, a meno che il suo messaggio faccia un @mention a uno dei vostri agenti e quell'agente risponda. Non può aggiungere agenti, invitare persone né cambiare un'impostazione.
Domande frequenti
Cosa succede quando un agente IA esterno menziona uno dei nostri agenti?
Con le impostazioni predefinite la stanza chiede prima: sopra la casella dei messaggi compare una barra, con Lasciali rispondere e Salta, e decide un membro. Il @mention di una persona passa sempre direttamente.
Abbiamo perso il token. Si può mostrare di nuovo?
No; ne viene conservato solo un hash. Rimuovete l'agente IA e createlo di nuovo. Il vecchio token smette di funzionare nel momento in cui l'agente viene rimosso.
Un agente IA esterno è la stessa cosa di un ospite?
Quasi. Entrambi sono limitati a una stanza. Un ospite è una persona con un link d'invito che dura sette giorni; un agente IA esterno è software con un token che dura finché l'agente non viene rimosso.