open-multi-agent/open-multi-agent

Open Multi‑Agent (OMA)

무엇인가요 – TypeScript 중심의 프레임워크로, 어떤 Node.js 애플리케이션 내에서도 동적한 LLM 기반 에이전트 팀을 실행할 수 있습니다. 사용자가 고수준의 목표를 제시하면, 내장된 코디네이터가 실시간으로 작업 DAG를 생성하고 에이전트 간에 작업을 스케줄링하며, 모든 단계를 기록하여 실행을 검토, 승인, 재실행, 재개할 수 있도록 합니다.

핵심 개념

• 목표 기반 오케스트레이션 – 수동으로 그래프를 작성할 필요 없음. 코디네이터가 사용자 제공 프롬프트에서 실시간으로 의존성 그래프를 생성합니다.
• 제어된 실행 – 계획, 작업 배분, 도구 호출은 미리 보기 및 인간의 승인을 위해 일시 중지할 수 있습니다. 프레임워크는 승인 훅과 지속 가능한 체크포인트를 제공합니다.
• 관측성 및 재실행 – 모든 실행은 추적 데이터로 저장됩니다. 오프라인 Run Viewer는 DAG, 스팬 워터폴, 토큰 사용량, 도구 호출을 시각화하고, 실행을 원래처럼 정확히 재실행할 수 있게 합니다.
• 안전성 및 프라이버시 – 도구는 기본적으로 비활성화되어 있으며, 각 호출은 명시적으로 허용되어야 합니다. 텔레메트리 및 지속 상태는 옵트인 프라이버시 컨트롤의 대상입니다.
• 오픈 런타임 – 어떤 LLM 제공자(OpenAI, Claude, Gemini, 로컬 서버, AI-SDK)와도 호환되며 클라우드와 온프레미스 모델을 혼합 사용할 수 있습니다. 공유 메모리, 예산, 재시도, 루프 탐지, OpenTelemetry 내보내기를 지원합니다.

일반적인 사용 사례

• 복잡한 백오피스 자동화 (예: PR 리뷰 봇, 보안 분석 파이프라인).
• 여러 에이전트가 사실을 수집하고 증거를 비교하며 합의에 도달해야 하는 연구 또는 분석 팀.
• 감사 가능성, 승인 워크플로우, 장애 후 재개가 필요한 프로덕션 수준의 AI 서비스.

시작하기

# 오프라인에서 완전히 작동하는 예제가 포함된 스타터 프로젝트 생성
npm create oma-app@latest my-oma

또는 기존 Node.js 코드베이스에 핵심 라이브러리를 추가:

npm install @open-multi-agent/core

import { OpenMultiAgent } from '@open-multi-agent/core'

const oma = new OpenMultiAgent({ defaultProvider: 'openai', defaultModel: 'gpt-5.4' })

const team = oma.createTeam('research-team', {
  agents: [
    { name: 'researcher', systemPrompt: '관련 사실을 찾아라.' },
    { name: 'analyst',   systemPrompt: '증거를 비교하고 트레이드오프를 식별하라.' },
  ],
  sharedMemory: true,
})

const result = await oma.runTeam(team, '세 가지 접근 방식을 비교하고 하나를 추천하라.')
console.log(result.agentResults.get('coordinator')?.output)

이 예제는 스크립트된 모델 응답을 사용하므로 API 키 없이도 작동합니다. 실제 모델로 시도하려면 OPENAI_API_KEY를 설정하세요.

안전성 훅 예시 – 중요한 도구 호출(예: 파일 쓰기)을 수동 검토를 위해 일시 중지:

const oma = new OpenMultiAgent({
  defaultProvider: 'openai',
  defaultModel: 'gpt-5.4',
  onToolCall: ({ consequential }) =>
    consequential ? { action: 'suspend' } : { action: 'allow' },
})

에코시스템

• 핵심 패키지 – @open-multi-agent/core는 런타임, 도구 라이브러리, 체크포인트, 추적, CLI, 오프라인 Run Viewer를 제공합니다.
• OTel 통합 – @open-multi-agent/otel을 사용하면 OMA 추적 데이터를 중앙 집중식 OpenTelemetry 스택으로 전송할 수 있습니다.
• 스캐폴더 – create-oma-app는 npm create oma-app를 위한 빠른 스타터 템플릿을 제공합니다.
• 통합 – 커뮤니티 프로젝트에서는 OMA가 PR 리뷰 보조 도구, WordPress 보안 스캐너, 양자 모델 기반 연구 도구 등에 통합되어 있습니다.

문서 및 리소스

• 전체 문서: https://open-multi-agent.com/getting-started/introduction/
• API 참조 및 가이드는 packages/core 폴더 내에 있습니다.
• 다른 오케스트레이션 프레임워크(LangGraph, CrewAI 등)와의 비교는 웹사이트에서 확인 가능합니다.

라이선스 – MIT (LICENSE 파일 참조). 프로젝트는 YuanASI Technology에서 유지 관리되며 GitHub 이슈와 풀 리퀘스트를 통해 기여를 환영합니다.