본문으로 바로가기
리옵트 핸드북
리옵트 핸드북
Vercel 엔터프라이즈 AI 플랫폼

플랫폼 기초

플랫폼 아키텍처AI SDK 런타임AI Gateway 제어면

실행 런타임

Workflow 장기 실행Sandbox 실행 격리MCP 데이터 계층Queues & 비동기 작업 관리

프롬프트 & 품질

프롬프트 엔지니어링 & 가드레일RAG & 검색 증강 생성관측성·평가

운영 체계

보안·거버넌스비용·안정성배포 전략 & AI CI/CD

실전 시나리오

고객지원 에이전트 아키텍처내부 리서치 에이전트 아키텍처승인형 백오피스 자동화코딩 오케스트레이션

오케스트레이션 패턴

그래프 중심 오케스트레이션실무 오케스트레이션 플레이북멀티 에이전트 아키텍처

부록

마이그레이션 가이드레퍼런스검증 리포트업데이트 내역
핸드북›Vercel 엔터프라이즈 AI›실무 오케스트레이션 플레이북
한국어English

실무 오케스트레이션 플레이북

ticket triage, alert triage, approval queue, scheduled reporting 같은 실무 runbook형 오케스트레이션 예제를 정리합니다.

핵심 요약

  • 실무 자동화는 거대한 범용 agent보다 ticket triage·alert triage·approval queue·scheduled reporting 같은 작은 playbook 워크플로우로 시작합니다.
  • 예제마다 가장 중요한 통제가 다릅니다. triage는 classification drift, alert는 false negative 방지, approval은 SLA, reporting은 source provenance.
  • pattern별로 권한을 분리하고 잘못된 action을 차단합니다.
  • false negative 영향이 큰 예제, 특히 alert triage에는 반드시 human escalation 경로를 둡니다.
  • provenance와 결과 로그를 남기고 pattern별 비용·성공률을 따로 관측합니다.

많은 팀은 거대한 agent 하나보다 작은 운영 루프 여러 개에서 먼저 효과를 봅니다.
운영팀이 바로 적용할 수 있는 짧은 예제를 기준으로, Workflow와 AI SDK를 어느 시점에 붙여야 하는지 정리합니다.

언제 이 패턴을 쓰는가

조건적합도이유
반복적인 운영 티켓이 많음높음runbook 자동화에 적합
완전 자율 agent보다 검증 가능한 흐름이 필요함높음작은 워크플로우가 더 안전
단일 초대형 agent를 만들려 함낮음운영 복잡도 급증

대표 예제

예제핵심 흐름가장 중요한 통제
ticket triage분류 → 우선순위 → assignee 추천classification drift
alert triage요약 → 중복 판단 → escalationfalse negative 방지
approval queue초안 생성 → 승인 대기 → 실행approval SLA
scheduled reporting데이터 수집 → 요약 → artifact 전달source provenance

구조

예제 1. Ticket triage

항목설계
문제운영 티켓 분류와 우선순위가 느림
흐름티켓 입력 → 분류 → severity 제안 → owner 추천
실패 모드잘못된 severity, owner mismatch
지표first response time, routing accuracy

예제 2. Alert triage

항목설계
문제알림 폭주로 human fatigue 발생
흐름alert 수신 → 요약 → dedupe → human escalation
실패 모드진짜 사고를 low priority로 분류
지표dedupe rate, false negative rate

예제 3. Approval queue

항목설계
문제승인 대기가 이메일/슬랙에 흩어짐
흐름초안 생성 → approval event → 실행
실패 모드승인 누락, timeout
지표approval SLA, execution success

예제 4. Scheduled reporting

항목설계
문제주간 보고서 생성이 수동
흐름schedule trigger → 데이터 수집 → 요약 → artifact 전달
실패 모드source 누락, hallucinated KPI
지표report on-time rate, data completeness

최소 구현 스켈레톤

import { defineHook, sleep } from 'workflow'

const opsApprovalHook = defineHook<{ approved: boolean }>()

export async function opsPlaybook(eventId: string) {
  'use workflow'

  const event = await loadEvent(eventId)
  const pattern = await classifyPattern(event)

  if (pattern === 'approval') {
    const approval = opsApprovalHook.create({ token: `ops:${event.id}` })
    await requestOpsApproval({ event, token: approval.token })
    return Promise.race([
      approval,
      sleep('4h').then(() => ({ approved: false })),
    ])
  }

  return executePlaybook(pattern, event)
}

async function loadEvent(eventId: string) {
  'use step'
  return loadOpsEvent(eventId)
}

async function classifyPattern(event: OpsEvent) {
  'use step'
  return classifyOpsPattern(event)
}

async function executePlaybook(pattern: OpsPattern, event: OpsEvent) {
  'use step'
  return runPlaybook(pattern, event)
}

보안·거버넌스 포인트

통제이유
pattern별 권한 분리잘못된 action 차단
human escalationfalse negative 보완
provenance 기록요약 근거 보존
api key scope운영 자동화 비용 분리

ADR 스타일 결론

Decision

실무 자동화는 거대한 범용 agent보다 작은 playbook 워크플로우로 시작합니다. ticket triage, alert triage, approval queue, scheduled reporting처럼 관찰 가능한 운영 루프를 먼저 자동화하고, 이후에만 범위를 확장합니다.

실무 체크리스트

  • 자동화 단위가 playbook 수준으로 작게 유지되는가
  • false negative가 큰 예제에 human escalation 경로가 있는가
  • provenance와 결과 로그가 남는가
  • pattern별 비용과 성공률을 따로 볼 수 있는가

관련 문서

  • AI Agents on Vercel
  • Vercel Workflow
  • How to build AI Agents with Vercel and the AI SDK

관련 문서

코딩 오케스트레이션

repo-aware coding agent를 이슈 수집부터 계획, 코드 수정, 테스트, PR 초안까지 연결하는 운영 체계를 정리합니다.

실행 가능한 예제 번들

DuckDB 고급 활용 · 작은 CSV·JSON 샘플과 DuckDB SQL 스크립트로 수집, Parquet 변환, profiling을 직접 실행합니다.

글로벌 약관 예제

웹서비스 운영을 위한 약관 가이드 · 글로벌 SaaS 약관, 개인정보, DPA, 구독·환불, MoR 결제, 준거법·수출통제 문구를 한국 법인 관점에서 조합하는 실전 예제

고객지원 에이전트 아키텍처

고객-facing 챗/지원 에이전트를 AI SDK, AI Gateway, MCP, escalation 구조로 설계하는 방법을 정리합니다.

Ch12. Evals와 품질 게이트

엔터프라이즈 Eve 에이전트 개발 · Eve eval runner와 assertion surface를 활용해 에이전트 회귀를 막는 품질 게이트를 설계한다.

그래프 중심 오케스트레이션

LangGraph 스타일의 graph/state-machine 사고방식을 Vercel의 code-first orchestration으로 매핑하는 방법을 정리합니다.

멀티 에이전트 아키텍처

AI SDK의 subagent, tool delegation, 역할 분리를 활용한 멀티 에이전트 패턴을 정리합니다.

On this page

언제 이 패턴을 쓰는가대표 예제구조예제 1. Ticket triage예제 2. Alert triage예제 3. Approval queue예제 4. Scheduled reporting최소 구현 스켈레톤보안·거버넌스 포인트ADR 스타일 결론실무 체크리스트관련 문서