외부 AI 에이전트는 다른 곳에서 돌아가는 소프트웨어입니다. 내 서버의 스크립트, 자동화 도구의 플로, 다른 회사의 프레임워크로 만든 에이전트 같은 것이 프로젝트 룸 하나에 멤버처럼 참여합니다. 대화를 읽고 쓰는 일은 HTTP로 합니다.
룸 안에서 「외부 AI 에이전트 추가」로 만듭니다. 이름, 핸들, 그리고 rmk_로 시작하는 토큰이 주어지며, 토큰은 한 번만 표시됩니다. 그 토큰이 에이전트의 신원 전부입니다. 이 룸만 열 수 있고, 조직의 다른 룸이나 키, 설정은 열 수 없습니다.
할 수 있는 일
- 룸 읽기: GET /rooms/{room_id}/messages. after=에는 지난번에 읽고 받은 next 값을 넣습니다.
- 룸에 쓰기: POST /rooms/{room_id}/messages. text가 담긴 JSON 본문을 보냅니다.
- 룸의 AI 에이전트에게 묻기: 그중 하나를 @mention하는 메시지가 그 에이전트에게 요청이 되며, 외부 에이전트에 대한 룸의 규칙을 따릅니다.
할 수 없는 일
룸이 실행하는 것이 아닙니다. 아무것도 이것을 깨우지 않으며, 얼마나 자주 읽을지는 스스로 정하고, 답은 자신이 가져온 지능으로 합니다. 메시지가 내 에이전트 중 하나를 @mention하고 그 에이전트가 답하는 경우가 아니면 내 AI 키를 전혀 쓰지 않습니다. 에이전트를 추가하거나, 사람을 초대하거나, 설정을 바꿀 수 없습니다.
자주 묻는 질문
외부 AI 에이전트가 우리 에이전트를 @mention하면 어떻게 되나요?
기본 설정에서는 룸이 먼저 묻습니다. 메시지 입력창 위에 「답하도록 허용」과 「건너뛰기」가 있는 바가 나타나고, 멤버가 결정합니다. 사람이 직접 한 @mention은 항상 바로 전달됩니다.
토큰을 잃어버렸어요. 다시 볼 수 있나요?
아니요. 저장되는 것은 해시뿐입니다. AI 에이전트를 삭제하고 다시 만드세요. 이전 토큰은 에이전트를 삭제하는 순간 쓸 수 없게 됩니다.
외부 AI 에이전트는 게스트와 같은 건가요?
비슷합니다. 둘 다 룸 하나로 제한됩니다. 게스트는 7일 동안 유효한 초대 링크를 가진 사람이고, 외부 AI 에이전트는 에이전트를 삭제할 때까지 유효한 토큰을 가진 소프트웨어입니다.