Mastra 소개

Mastra는 오픈소스 TypeScript 에이전트(Agent) 프레임워크입니다.

AI 애플리케이션과 기능을 구축하는 데 필요한 핵심 구성 요소를 제공하도록 설계되었습니다.

Mastra를 사용하면 메모리를 가지고 함수를 실행할 수 있는 AI 에이전트(Agent)를 구축하거나, 결정론적 워크플로우(Workflow)에서 LLM 호출을 연결할 수 있습니다. Mastra의 로컬 개발 환경에서 에이전트와 대화하고, RAG를 통해 애플리케이션별 지식을 제공하며, Mastra의 평가 시스템(Evals)으로 출력 결과를 점수화할 수 있습니다.

주요 기능

모델 라우팅(Model Routing)

Mastra는 Vercel AI SDK를 사용하여 모델 라우팅을 처리하며, OpenAI, Anthropic, Google Gemini 등 모든 LLM 제공자와 상호작용할 수 있는 통합 인터페이스를 제공합니다.

에이전트 메모리 및 도구 호출(Agent Memory & Tool Calling)

Mastra를 사용하면 에이전트가 호출할 수 있는 도구(함수)를 제공할 수 있습니다. 에이전트 메모리를 지속적으로 저장하고, 최근성, 의미적 유사성, 또는 대화 스레드를 기반으로 검색할 수 있습니다.

워크플로우 그래프(Workflow Graphs)

LLM 호출을 결정론적 방식으로 실행하고 싶을 때, Mastra는 그래프 기반 워크플로우 엔진을 제공합니다. 개별 단계를 정의하고, 각 실행의 각 단계에서 입력과 출력을 로깅하며, 관찰 가능성 도구로 파이프할 수 있습니다. Mastra 워크플로우는 분기와 체이닝을 가능하게 하는 간단한 제어 흐름 문법(.then(), .branch(), .parallel())을 제공합니다.

에이전트 개발 환경(Agent Development Environment)

에이전트를 로컬에서 개발할 때, Mastra의 에이전트 개발 환경에서 에이전트와 대화하고 상태와 메모리를 확인할 수 있습니다.

검색 증강 생성(RAG - Retrieval-Augmented Generation)

Mastra는 문서(텍스트, HTML, 마크다운, JSON)를 청크로 처리하고, 임베딩을 생성하여 벡터 데이터베이스에 저장하는 API를 제공합니다. 쿼리 시점에 관련 청크를 검색하여 데이터를 기반으로 LLM 응답을 생성하며, 여러 벡터 저장소(Pinecone, pgvector 등)와 임베딩 제공자(OpenAI, Cohere 등) 위에 통합 API를 제공합니다.

배포(Deployment)

Mastra는 기존 React, Next.js 또는 Node.js 애플리케이션 내에서 에이전트와 워크플로우를 번들링하거나 독립 실행형 엔드포인트로 만들 수 있습니다. Mastra 배포 헬퍼를 사용하면 Hono를 사용하여 에이전트와 워크플로우를 Node.js 서버로 쉽게 번들링하거나, Vercel, Cloudflare Workers, Netlify와 같은 서버리스 플랫폼에 배포할 수 있습니다.

평가 시스템(Evals)

Mastra는 모델 기반, 규칙 기반, 통계적 방법을 사용하여 LLM 출력을 평가하는 자동화된 평가 메트릭을 제공합니다. 독성, 편향성, 관련성, 사실 정확성에 대한 내장 메트릭과 함께 사용자 정의 평가를 정의할 수도 있습니다.

왜 Mastra를 선택해야 할까요?

🚀 빠른 개발

복잡한 AI 시스템을 구축하기 위한 모든 구성 요소가 하나의 프레임워크에 통합되어 있어, 빠르게 프로토타입을 만들고 프로덕션에 배포할 수 있습니다.

🔧 유연한 아키텍처

모듈형 설계로 필요한 기능만 선택하여 사용할 수 있습니다. 단순한 챗봇부터 복잡한 멀티 에이전트 시스템까지 자유롭게 구축하세요.

💼 프로덕션 준비

메모리 관리, 관찰 가능성, 평가 시스템 등 프로덕션 환경에서 필요한 모든 기능을 제공합니다.

🌐 멀티 모델 지원

OpenAI, Anthropic, Google Gemini 등 다양한 LLM 제공자를 통합 인터페이스로 사용할 수 있어 벤더 종속성을 피할 수 있습니다.

🛠 개발자 경험

TypeScript로 작성되어 완전한 타입 안전성을 제공하며, 직관적인 API와 풍부한 문서로 학습 곡선을 최소화합니다.

시작하기

Mastra를 바로 시작해보고 싶다면:

설치 가이드에서 프로젝트 설정 방법을 확인하세요
프로젝트 구조에서 코드 구성 방법을 배우세요
에이전트 개요에서 첫 번째 AI 에이전트를 만들어보세요
워크플로우 개요에서 복잡한 작업을 자동화해보세요

사용 사례

Mastra는 다음과 같은 다양한 AI 애플리케이션 구축에 적합합니다:

고객 지원 챗봇: 메모리와 도구 호출 기능을 가진 지능형 고객 서비스
콘텐츠 생성 파이프라인: 워크플로우를 통한 자동화된 콘텐츠 제작 시스템
문서 질의응답 시스템: RAG를 활용한 기업 내부 지식베이스 검색
자동화된 데이터 분석: 에이전트와 워크플로우를 결합한 데이터 처리 시스템
멀티 에이전트 협업: 여러 전문 에이전트가 협력하는 복잡한 작업 처리

커뮤니티 및 지원

GitHub: 소스 코드와 이슈 트래킹
문서: 포괄적인 가이드와 API 참조 문서 제공
예제: 실제 사용 사례를 보여주는 다양한 예제 프로젝트

Mastra와 함께 AI의 미래를 구축해보세요! 🚀

2025년 7월 26일 기준 번역
by dongne.lab@gmail.com