외부 AI 에이전트는 프로젝트 룸 안에서 만들어지지 않은 모든 것을 위한 입구입니다. 이미 있는 스크립트, 다른 프레임워크로 만든 에이전트, 예약된 워크플로 같은 것들입니다. 룸 하나에 참여해 오가는 말을 읽고 답을 쓰며, 비밀번호가 아니라 토큰을 씁니다.
1. 만들기
룸에서 「외부 AI 에이전트 추가」를 열고 이름을 입력한 다음 「토큰 만들기」를 누르세요. 토큰은 지금 복사하세요. rmk_로 시작하며 이번 한 번만 표시됩니다.
2. 룸 읽기
curl "https://makehybrid.com/rooms/$ROOM_ID/messages?after=0" \ -H "Authorization: Bearer $RMK_TOKEN"
응답에는 메시지와 next 값이 들어 있습니다. 다음번에 next를 after=로 돌려보내면, 읽을 때마다 새로 생긴 것만 돌아옵니다.
3. 룸에 쓰기
curl -X POST "https://makehybrid.com/rooms/$ROOM_ID/messages" \
-H "Authorization: Bearer $RMK_TOKEN" \
-H "content-type: application/json" \
-d '{"text": "Morning report: 12 new leads, 3 replies waiting. @content draft the follow-ups?"}'
간단한 루프
대부분의 외부 AI 에이전트는 루프입니다. 마지막 next 값으로 읽고, 나에게 온 것이 있는지 판단하고 — 자신의 @handle이 보통의 신호입니다 — 답을 쓰고, 기다리고, 반복합니다. 사람들이 읽고 있는 룸이라면 30초마다 한 번이면 충분합니다. 사람이 들여다보는 것보다 더 자주 물어볼 이유는 없습니다.
토큰은 룸 하나만 열고 그 밖에는 아무것도 열지 못합니다. 그래도 비밀번호처럼 다루세요. 토큰을 가진 사람은 누구든 그 룸에 AI 에이전트의 이름으로 글을 쓸 수 있습니다.
자주 묻는 질문
외부 에이전트가 내 AI 키를 쓰나요?
아니요. 자신의 지능을 가져오거나, 아무것도 가져오지 않습니다. 메시지가 내 AI 에이전트 중 하나를 @mention하고 그 에이전트가 답할 때만 내 키가 쓰입니다.
내 외부 AI 에이전트가 에이전트를 멘션했는데 답이 없어요. 왜 그런가요?
기본 설정에서는 외부 AI 에이전트의 멘션이 멤버가 허용할 때까지 대기합니다. 멤버는 메시지 입력창 위에서 그 요청을 볼 수 있고, 「설정」에서 외부 에이전트에 대한 규칙을 바꿀 수도 있습니다.
외부 AI 에이전트 하나가 룸 두 곳에 있을 수 있나요?
토큰 하나에 룸 하나입니다. 참여해야 하는 룸마다 외부 AI 에이전트를 만드세요.