VoltAgent는 두 가지 주요 부분으로 구성된 엔드 투 엔드 (end-to-end) AI 에이전트 엔지니어링 플랫폼입니다:

오픈 소스 TypeScript 프레임워크 (Open-Source TypeScript Framework) – 메모리 (Memory), RAG, 가드레일 (Guardrails), 도구 (Tools), MCP, 음성 (Voice), 워크플로 (Workflow) 등을 포함합니다.

VoltOps 콘솔 (VoltOps Console)
Cloud

Self-Hosted

– 관측성 (Observability), 자동화 (Automation), 배포 (Deployment), 평가 (Evals), 가드레일 (Guardrails), 프롬프트 (Prompts) 등을 포함합니다.

전체 코드 제어권을 가지고 에이전트를 구축하고, 프로덕션 수준의 가시성과 운영 환경을 갖추어 배포하세요.

오픈 소스 프레임워크를 사용하면 어떤 AI 제공업체와도 연결하면서 메모리, 도구 및 다단계 워크플로 (multi-step workflows)를 갖춘 지능형 에이전트를 구축할 수 있습니다. 전문화된 에이전트들이 관리자 (supervisor)의 조정 하에 함께 작동하는 정교한 멀티 에이전트 시스템 (multi-agent systems)을 생성하세요.

핵심 런타임 (Core Runtime (@voltagent/core)): 타입이 지정된 역할 (roles), 도구, 메모리 및 모델 제공업체를 한 곳에서 정의하여 모든 것이 조직적으로 유지되도록 합니다.

워크플로 엔진 (Workflow Engine): 커스텀 제어 흐름 (control flow)을 하나씩 엮는 대신, 다단계 자동화를 선언적으로 기술합니다.

관리자 및 하위 에이전트 (Supervisors & Sub-Agents): 작업을 라우팅하고 동기화 상태를 유지하는 관리자 런타임 하에서 전문화된 에이전트 팀을 실행합니다.

도구 레지스트리 및 MCP (Tool Registry & MCP): 생명주기 훅 (lifecycle hooks)과 취소 기능이 있는 Zod 타입 지정 도구를 배포하고, 추가적인 글루 코드 (glue code) 없이 Model Context Protocol 서버에 연결합니다.

LLM 호환성 (LLM Compatibility): 에이전트 로직을 다시 작성할 필요 없이 설정을 변경함으로써 OpenAI, Anthropic, Google 또는 기타 제공업체 간에 전환할 수 있습니다.

메모리 (Memory): 내구성이 있는 메모리 어댑터를 부착하여 에이전트가 실행 간에 중요한 컨텍스트를 기억하도록 합니다.

재개 가능한 스트리밍 (Resumable Streaming): 클라이언트가 새로고침 후에도 진행 중인 스트림에 다시 연결하여 동일한 응답을 계속 받을 수 있도록 합니다.

검색 및 RAG (Retrieval & RAG): 검색 에이전트 (retriever agents)를 플러그인하여 데이터 소스에서 사실을 추출하고, 모델이 답변하기 전에 응답의 근거를 마련 (RAG)합니다.

VoltAgent 지식 베이스 (VoltAgent Knowledge Base): 문서 수집 (ingestion), 청킹 (chunking), 임베딩 (embeddings) 및 검색을 위한 관리형 RAG 서비스를 사용합니다.

음성 (Voice): OpenAI, ElevenLabs 또는 커스텀 음성 제공업체를 통해 텍스트 음성 변환 (text-to-speech) 및 음성 텍스트 변환 (speech-to-text) 기능을 추가합니다.

가드레일 (Guardrails): 에이전트의 입력 또는 출력을 가로채고 검증합니다.

런타임 (runtime)에서 콘텐츠 정책 및 안전 규칙을 강제합니다. 평가 (Evals): 워크플로 (workflows)와 함께 에이전트 평가 스위트 (eval suites)를 실행하여 에이전트의 동작을 측정하고 개선합니다.

Claude, Cursor 또는 Windsurf와 같은 AI 기반 코딩 어시스턴트 (coding assistants)를 위해, MCP 서버 @voltagent/mcp-docs-server를 사용하여 LLM (Large Language Model)에게 VoltAgent 사용법을 가르칠 수 있습니다. 이를 통해 AI 어시스턴트가 코딩하는 동안 VoltAgent 문서, 예제 및 변경 로그 (changelogs)에 직접 접근할 수 있습니다.

create-voltagent-app CLI 도구를 사용하여 몇 초 만에 새로운 VoltAgent 프로젝트를 생성하세요:

npm create voltagent-app@latest

이 명령어가 설정을 안내합니다.

src/index.ts에서 스타터 코드 (starter code)를 확인할 수 있으며, 여기에는 에이전트와 src/workflows/index.ts에 있는 포괄적인 워크플로 (workflow) 예제가 모두 등록되어 있습니다.

import { VoltAgent, Agent, Memory } from "@voltagent/core";
import { LibSQLMemoryAdapter } from "@voltagent/libsql";
import { createPinoLogger } from "@voltagent/logger";
...

그 후, 프로젝트 디렉토리로 이동하여 다음을 실행하세요:

npm run dev

dev 명령어를 실행하면 tsx가 코드를 컴파일하고 실행합니다. 터미널에서 다음과 같은 VoltAgent 서버 시작 메시지를 볼 수 있습니다:

══════════════════════════════════════════════════
VOLTAGENT SERVER STARTED SUCCESSFULLY
══════════════════════════════════════════════════
...

이제 에이전트가 실행 중입니다! 에이전트와 상호작용하려면:

• 콘솔 (Console) 열기: 터미널 출력에 있는 VoltOps LLM 관측성 플랫폼 (Observability Platform) 링크를 클릭하거나 브라우저에 복사하여 붙여넣으세요.
• 에이전트 찾기: VoltOps LLM 관측성 플랫폼 페이지에서 목록에 있는 에이전트(예: "my-agent")를 찾으세요.
• 에이전트 상세 정보 열기: 에이전트 이름을 클릭하세요.
• 채팅 시작하기: 에이전트 상세 페이지의 오른쪽 하단 모서리에 있는 채팅 아이콘을 클릭하여 채팅 창을 엽니다.
• 메시지 보내기: "Hello"와 같은 메시지를 입력하고 Enter를 누르세요.

step-3-test.mp4

새 프로젝트에는 강력한 워크플로 엔진 (workflow engine)도 포함되어 있습니다.

비용 승인 워크플로 (expense approval workflow)는 일시 중지/재개 (suspend/resume) 기능을 갖춘 인간 참여형 (human-in-the-loop) 자동화를 보여줍니다:

import { createWorkflowChain } from "@voltagent/core";
import { z } from "zod";
export const expenseApprovalWorkflow = createWorkflowChain({
...

VoltOps 콘솔에서 미리 구축된 expenseApprovalWorkflow를 직접 테스트할 수 있습니다:

workflow.mp4

워크플로(Workflows) 페이지로 이동: 서버를 시작한 후, 워크플로 페이지로 직접 이동합니다.

프로젝트 선택: 프로젝트 선택기(project selector)를 사용하여 프로젝트(예: "my-agent-app")를 선택합니다.

찾기 및 실행: 목록에 있는 **"Expense Approval Workflow"**를 찾습니다. 해당 항목을 클릭한 다음 "Run" 버튼을 클릭합니다.

입력 제공: 워크플로는 비용 상세 정보가 포함된 JSON 객체를 기대합니다. 자동 승인을 위해 소액의 비용을 입력해 보세요:
{ "employeeId": "EMP-123", "amount": 250, "category": "office-supplies", "description": "New laptop mouse and keyboard" }

결과 확인: 실행 후, 각 단계에 대한 상세 로그를 검사하고 최종 출력을 콘솔에서 직접 확인할 수 있습니다.

더 많은 예제는 저희의 예제 리포지토리(examples repository)를 방문해 주세요.

Airtable 에이전트 (Airtable Agent)

• VoltOps 액션을 통해 새로운 레코드에 반응하고 Airtable에 업데이트 내용을 다시 작성합니다.

Slack 에이전트 (Slack Agent)

• 채널 메시지에 응답하고 VoltOps Slack 액션을 통해 답장합니다.

VoltAgent를 사용한 ChatGPT 앱 (ChatGPT App With VoltAgent)

• MCP를 통해 VoltAgent를 배포하고 ChatGPT 앱에 연결합니다.

WhatsApp 주문 에이전트 (WhatsApp Order Agent)

• 자연스러운 대화를 통해 음식 주문을 처리하는 WhatsApp 챗봇을 구축합니다. (출처)

YouTube to Blog 에이전트 (YouTube to Blog Agent)

• MCP 도구를 사용하는 감독 에이전트(supervisor agent)를 사용하여 YouTube 비디오를 마크다운(Markdown) 블로그 포스트로 변환합니다. (출처)

AI 광고 생성 에이전트 (AI Ads Generator Agent)

• BrowserBase Stagehand와 Google Gemini AI를 사용하여 Instagram 광고를 생성합니다. (출처)

AI 레시피 생성 에이전트 (AI Recipe Generator Agent)

• 재료와 선호도에 기반하여 개인화된 요리 제안을 생성합니다. (출처 | 비디오)

AI 연구 보조 에이전트 (AI Research Assistant Agent)

• 종합적인 보고서 생성을 위한 멀티 에이전트(multi-agent) 연구 워크플로입니다. (출처 | 비디오)

VoltOps Console은 VoltAgent의 플랫폼 측면으로, 관측성 (observability), 자동화 (automation) 및 배포 (deployment) 기능을 제공하여 실시간 실행 추적 (execution traces), 성능 지표 (performance metrics) 및 시각적 대시보드 (visual dashboards)를 통해 프로덕션 환경의 에이전트를 모니터링하고 디버깅할 수 있도록 지원합니다.

상세한 추적 (traces) 및 성능 지표 (performance metrics)를 통해 에이전트 실행 흐름을 심층 분석합니다.

모든 에이전트, 워크플로 (workflows) 및 시스템 성능 지표에 대한 종합적인 개요를 파악합니다.

모든 에이전트 상호작용 및 워크플로 단계에 대한 상세한 실행 로그 (execution logs)를 추적합니다.

에이전트의 메모리 (memory), 컨텍스트 (context) 및 대화 기록 (conversation history)을 검사하고 관리합니다.

전체 실행 추적 (execution traces)을 분석하여 에이전트의 동작을 이해하고 성능을 최적화합니다.

콘솔에서 직접 프롬프트 (prompts)를 설계, 테스트 및 개선합니다.

원클릭 GitHub 연동 및 관리형 인프라 (managed infrastructure)를 통해 에이전트를 프로덕션 환경에 배포합니다.

웹훅 (webhooks), 스케줄 (schedules) 및 사용자 정의 트리거 (custom triggers)를 사용하여 에이전트 워크플로를 자동화하고 외부 이벤트에 반응하도록 합니다.

전체 시스템에 걸쳐 에이전트의 상태 (health), 성능 지표 및 리소스 사용량을 모니터링합니다.

안전 경계 (safety boundaries)와 콘텐츠 필터 (content filters)를 설정하여 에이전트가 정의된 파라미터 내에서 작동하도록 보장합니다.

평가 스위트 (evaluation suites)를 실행하여 벤치마크 (benchmarks) 대비 에이전트의 동작, 정확도 및 성능을 테스트합니다.

내장된 검색 증강 생성 (RAG, retrieval-augmented generation) 기능을 통해 에이전트를 지식 소스에 연결합니다.

대화형 튜토리얼로 시작하기를 통해 AI 에이전트 구축의 기초를 학습하세요. 문서 (Documentation): 가이드, 개념 및 튜토리얼을 살펴보세요. 예제 (Examples): 실질적인 구현 사례를 탐색하세요. 블로그 (Blog): 기술적 통찰력과 모범 사례 (best practices)에 대해 더 읽어보세요.

기여를 환영합니다! 기여 가이드라인(사용 가능한 경우 링크 필요)을 참조해 주세요. 질문과 토론을 위해 저희 Discord 서버에 참여하세요.

플러그인을 만들거나, 이슈 (issue)를 제기하거나, 풀 리퀘스트 (pull request)를 보내거나, 혹은 단순히 Discord나 GitHub Discussions에서 누군가를 도와준 분들을 포함하여 VoltAgent의 여정에 함께해 주신 모든 분께 큰 감사를 드립니다.

VoltAgent는 커뮤니티의 노력으로 이루어지며, 여러분과 같은 분들 덕분에 계속해서 발전하고 있습니다.

MIT 라이선스에 따라 라이선스가 부여됩니다, Copyright © 2026-현재 VoltAgent.