Skip to content

에이전트 관리

  • 경로: /admin/agents
  • 라우트 이름: admin-agents
  • 컴포넌트: apps/web-ui/src/pages/admin/AdminAgents.vue
  • 권한: operator

목적

배포된 AI 에이전트의 실행 상태를 실시간 모니터링하고, 에이전트 플릿 전반의 상태를 한눈에 파악합니다. AI 운영(/admin/ai)에서 정의한 에이전트를 실제 서버에서 실행·제어하는 운영 허브입니다.

핵심 기능

에이전트 플릿 현황

  • 전체 에이전트 수, 실행 중(running) 수, 오류(error) 수 실시간 집계
  • 에이전트 이름 검색 및 필터링

에이전트 카드

  • 각 에이전트별 카드: 이름, 소스(local / connected), 실행 상태 배지
  • local 에이전트: 서버 시작(start) / 중지(stop) 제어 버튼
  • connected 에이전트: 외부 엔드포인트 URL 표시
  • 개별 에이전트 상태·로그 드로어 열기

에이전트 브리핑

  • 에이전트가 발신하는 브리핑(error_analysis / briefing / reply_log) 목록
  • 심각도(info / warning / critical) 배지 표시
  • 읽음 처리 및 일괄 읽음 처리

실시간 SSE 스트리밍

  • 백엔드 /api/v1/settings/server-agents/stream에서 SSE로 상태·로그 실시간 수신
  • 상태 변경 즉시 반영 (EventSource 자동 재연결)

에이전트 타입

타입설명
local백엔드에서 LangGraph 기반으로 동적 생성·실행되는 에이전트
connected외부 에이전트 엔드포인트(URL)에 연결하는 프록시 에이전트

연계

  • 스토어: stores/agents.ts — 에이전트 목록, 서버 상태, 브리핑, SSE 스트림
  • API: VITE_API_URL/api/v1/agents/ (에이전트 CRUD), /api/v1/settings/server-agents/ (서버 실행 상태)
  • 브리핑: /api/v1/agents/briefings
  • AI 운영 페이지: /admin/ai — 에이전트 정의·설정은 AI 운영에서 관리

관련 문서