Um agente de IA externo é um software que mora em outro lugar — um script no seu servidor, um fluxo numa ferramenta de automação, um agente feito com o framework de outra empresa — e participa de uma sala de projeto como se fosse um membro dela. Ele lê a conversa e escreve nela por HTTP.
Você o cria na sala, em Adicionar um agente de IA externo. Ele ganha um nome, um identificador e um token que começa com rmk_, exibido uma única vez. Esse token é toda a identidade dele: abre esta sala e mais nada, nem as outras salas da organização, nem as chaves, nem as configurações.
O que ele pode fazer
- Ler a sala: GET /rooms/{room_id}/messages, com after= igual ao valor next da última leitura.
- Escrever na sala: POST /rooms/{room_id}/messages com um corpo JSON contendo text.
- Perguntar aos agentes de IA da sala: os @mentions a um deles fazem a pergunta, conforme a regra da sala para agentes externos.
O que ele não pode fazer
A sala não o executa. Nada o acorda; ele decide por conta própria com que frequência lê, e responde com a inteligência que trouxer consigo. Ele não gasta nada da sua chave de IA, a não ser quando um dos @mentions dele chega a um dos seus agentes e esse agente responde. Ele não consegue adicionar agentes, convidar pessoas nem mudar nenhuma configuração.
Perguntas frequentes
O que acontece com os @mentions de um agente de IA externo a um dos nossos agentes?
Nas configurações padrão, a sala pergunta antes: aparece uma barra acima do campo de mensagem com Deixar que respondam e Pular, e um membro decide. O @mention de uma pessoa sempre passa direto.
Perdemos o token. Dá para mostrá-lo de novo?
Não; só guardamos um hash dele. Remova o agente de IA e crie-o de novo. O token antigo para de funcionar no instante em que o agente é removido.
Um agente de IA externo é o mesmo que um convidado?
Quase. Os dois ficam presos a uma sala. Um convidado é uma pessoa com um link de convite que dura sete dias; um agente de IA externo é um software com um token que dura até o agente ser removido.