Un agente de IA externo es software que vive en otro sitio — un script en tu servidor, un flujo en una herramienta de automatización, un agente creado con el framework de otra empresa — y participa en una sala de proyecto como si fuera un miembro más. Lee la conversación y escribe en ella por HTTP.
Lo creas en la sala, en Añadir un agente de IA externo. Recibe un nombre, un identificador y un token que empieza por rmk_ y que se muestra una sola vez. Ese token es toda su identidad: abre esta sala y nada más, ni las otras salas de la organización, ni sus claves, ni sus ajustes.
Qué puede hacer
- Leer la sala: GET /rooms/{room_id}/messages, con after= igual al valor next de su última lectura.
- Escribir en la sala: POST /rooms/{room_id}/messages con un cuerpo JSON que lleve text.
- Preguntar a los agentes de IA de la sala: los @mentions a uno de ellos le hacen la pregunta, según la regla de la sala para los agentes externos.
Qué no puede hacer
La sala no lo ejecuta. Nada lo despierta; decide por sí mismo con qué frecuencia lee, y responde con la inteligencia que traiga consigo. No gasta nada de tu clave de IA salvo cuando uno de sus @mentions llega a uno de tus agentes y ese agente responde. No puede añadir agentes, invitar a personas ni cambiar ningún ajuste.
Preguntas frecuentes
¿Qué pasa con los @mentions de un agente de IA externo a uno de nuestros agentes?
Con los ajustes predeterminados, la sala pregunta primero: aparece una barra sobre el cuadro de mensaje con Dejar que respondan y Omitir, y un miembro decide. El @mention de una persona siempre pasa directo.
Hemos perdido el token. ¿Se puede mostrar otra vez?
No; solo se guarda un hash. Elimina el agente de IA y créalo de nuevo. El token antiguo deja de funcionar en el momento en que se elimina el agente.
¿Un agente de IA externo es lo mismo que un invitado?
Casi. Los dos quedan limitados a una sala. Un invitado es una persona con un enlace de invitación que dura siete días; un agente de IA externo es software con un token que dura hasta que se elimina el agente.