AgentWorkforce/relay

Real time communication for agents. Wake on message, channels, DMs and actions. Useful for orchestrating agents.

Agent Relay – AI 에이전트를 위한 메시징 레이어

무엇인가요 – Agent Relay는 임의의 수의 AI 에이전트(Claude, Codex, Gemini, 커스텀 봇, 또는 인간 운영자)가 공유하고 Slack과 유사한 워크스페이스를 사용할 수 있도록 해주는 TypeScript/Node.js 라이브러리입니다. 에이전트는 채널에 참여하고, 직접 메시지를 보내며, 이모지로 반응하고, 스레드를 만들고, 사용자 정의 액션을 노출할 수 있습니다. 이 모든 기능은 귀하가 하위 채팅 인프라를 구축할 필요 없이 가능합니다.

왜 중요한가요 – 기존의 대부분의 에이전트 프레임워크는 단일 에이전트의 도구 사용에 초점을 맞추고 있습니다. Relay는 여러 에이전트가 신뢰성 있게 협업할 수 있도록 해주는 협업 원시 기능(채널, 지속적 전달, 이벤트 스트림, 웹훅)을 제공합니다. 이를 통해 다중 에이전트 시스템, 오케스트레이션 파이프라인, 또는 인간이 개입하는 워크플로우를 더 쉽게 구축할 수 있습니다.

핵심 개념

개념	기능
워크스페이스	에이전트, 채널, 메시지를 보관하는 사전 환경. `AgentRelay.createWorkspace()`로 생성되며 안정적인 `workspaceKey`로 식별됩니다.
에이전트 등록	`workspace.register({name, type})`은 메시지 전송/수신이 가능한 실시간 클라이언트를 반환합니다.
채널 / 개인 메시지	텍스트 기반의 방(`#general`) 또는 개인 대화. 에이전트는 `join`, `sendMessage`, `reply`, `react`를 사용할 수 있습니다.
이벤트	실시간 WebSocket 이벤트(`message.created`, `action.completed` 등)는 `relay.addListener`를 통해 수신됩니다.
하네스	실제 LLM 또는 도구(Claude Code, Codex, OpenCode, 커스텀 봇)를 감싸는 런타임 어댑터입니다. 메시지를 수신하고, 선택적으로 액션을 노출하기 위한 작은 계약을 구현합니다.
액션	타입 지정된 등록 가능한 명령어(`relay.registerAction`)로, 에이전트가 호출할 수 있으며 Zod를 통한 입력 검증이 가능합니다.
웹훅	인바운드 훅은 외부 서비스가 채널에 메시지를 게시할 수 있게 하고, 아웃바운드 훅은 선택된 이벤트를 귀하의 HTTP 엔드포인트로 전달합니다.

빠른 시작 (복사 붙여넣기 가능)

# 1️⃣ SDK 설치
npm install @agent-relay/sdk

// 2️⃣ 워크스페이스와 세 에이전트 생성
import { AgentRelay } from '@agent-relay/sdk';
const relay = await AgentRelay.createWorkspace({ name: 'my-company' });
const alice = await relay.workspace.register({ name: 'Alice', type: 'agent' });
const bob   = await relay.workspace.register({ name: 'Bob',   type: 'agent' });
const carol = await relay.workspace.register({ name: 'Carol', type: 'agent' });

// 3️⃣ 채널 설정
await alice.channels.create({ name: 'general', topic: 'Team chat' });
await bob.channels.join('general');
await carol.channels.join('general');

// 4️⃣ 새 메시지 리스닝
relay.addListener('message.created', ({ message, envelope }) => {
  const { from, channel } = envelope;
  if (channel?.name === 'general') {
    console.log(`${from.handle} in #${channel.name}: ${message.text}`);
  }
});

// 5️⃣ 몇 가지 메시지 보내기
await alice.sendMessage({ to: '#general', text: 'Stand‑up in 5 min' });
await bob.sendMessage({   to: '#general', text: 'Got it' });
await carol.sendMessage({ to: '#general', text: 'Will share status' });

// 6️⃣ 이벤트가 발생할 수 있도록 프로세스를 잠시 유지
await new Promise(r => setTimeout(r, 4_500));

이 스크립트는 워크스페이스를 생성하고, 세 에이전트를 등록하며, 채널을 열고, 새 메시지를 출력하며, 기본적인 전송/응답/반응 흐름을 보여줍니다.

실제 LLM 에이전트와 함께 작업하기 (하네스)

import { claude, codex } from '@agent-relay/harnesses';
// Claude Code 인스턴스(모델 "sonnet")과 Codex 인스턴스(모델 "gpt‑5.5") 생성
const taskMgr = await claude.create({ relay, model: 'sonnet' });
const engineer = await codex.create({ relay, model: 'gpt-5.5' });

하네스는 Relay 런타임 어댑터를 구현하는 어떤 프로세스든 가능합니다. CLI 기반 LLM, 서버 사이드 모델, 또는 직접 작성한 커스텀 봇일 수 있습니다. 생성 후 하네스는 다른 에이전트와 마찬가지로 워크스페이스에 나타나며 동일한 메시지 API를 사용할 수 있습니다.

플랫폼 확장하기

커스텀 액션 – 에이전트가 호출할 수 있는 타입 지정된 도구를 등록:

relay.registerAction({
  name: 'classify',
  input: z.object({ text: z.string() }),
  handler: async ({ input }) => ({ label: await myClassifier(input.text) })
});

액션에서 에이전트 스파운 – 에이전트가 Relay에 요청하여 필요 시 다른 LLM을 즉시 시작할 수 있습니다.
웹훅 – 외부 CI/CD, 모니터링, 티켓 시스템을 채널에 연결하거나 Relay 이벤트를 귀하의 서비스로 전달할 수 있습니다.

일반적인 사용 사례

시나리오	Relay가 어떻게 도움이 되는가
코드 공동 작성	Claude(기획)가 Codex(생성)와 공유 채널에서 대화; 결과는 메시지로 게시되고 반응 가능.
사고 대응	모니터링 시스템의 알림이 인바운드 웹훅을 통해 게시; 인간 운영자와 AI 트리지 봇이 실시간으로 협업.
작업 오케스트레이션	에이전트가 `spawn‑claude` 또는 `submit‑vote`와 같은 액션을 등록; 컨트롤러 에이전트가 `action.completed` 이벤트를 감시하여 워크플로우를 제어.
인간이 개입하는 워크플로우	`createHuman`로 "인간 하네스"를 생성. 다른 에이전트와 마찬가지로 동일한 채널에 메시지를 입력할 수 있음.

더 깊이 탐구하기

문서 – https://agentrelay.com/docs (완전한 이벤트 목록, SDK 참조, 하네스 가이드).
CLI – agent-relay node agent spawn codex --runtime native --name NativeCodex로 명령줄에서 하네스를 시작할 수 있습니다.
패키지 – 모노레포에는 @agent-relay/sdk, @agent-relay/harnesses, 그리고 네이티브 하네스를 시작하는 드라이버가 포함되어 있습니다.

라이선스

결론 – Agent Relay는 최소한의 부가 작업으로 임의의 수의 AI 에이전트, 도구, 인간을 연결할 수 있는 프로덕션 준비 완료된 오픈소스 메시징 백본입니다. 이는 견고한 다중 에이전트 애플리케이션을 가능하게 합니다.