에이전트 (Agents) 개요
**에이전트(Agents)**는 D.Hub에서 LLM과 도구(Tools), 액터(Actors)를 결합해 자연어 기반 작업을 자동 수행하는 자율 실행 단위입니다. 일반적인 챗봇이 정해진 답변을 반환하는 것과 달리, 에이전트는 사용자 질의를 해석한 뒤 적절한 도구를 호출하고, 필요 시 추가 검색·계산·외부 API 호출을 수행해 결과를 생성합니다.
에이전트 관리 화면은 사이드바의 APPLICATIONS → 에이전트(또는 컬렉션 트리에서 에이전트 leaf)에서 진입합니다. 사이드바 메뉴는 에이전트 목록 / 도구(Tool) / 액터(Actor) 3개 하위로 구성됩니다.
구성 요소
| 요소 | 설명 |
|---|---|
| Agent (에이전트) | 입력 질의에 대해 추론·의사결정을 수행하는 주체. React 또는 Workflow 모드로 구성 |
| Tool (도구) | 에이전트가 호출 가능한 기능 (검색, 계산, REST 호출, 사용자 정의 코드 등) |
| Actor (액터) | 에이전트가 위임할 수 있는 하위 실행 주체 (다른 에이전트, 고정 파이프라인 등) |
에이전트의 로직은 React 모드와 Workflow 모드 중 하나로 설계됩니다(ADR-0021).
- React 모드: ReAct 패턴으로 LLM이 자율적으로 도구 선택·반복 수행
- Workflow 모드: 4-zone 레이아웃의 비주얼 그래프로 단계·조건·분기를 명시적으로 설계
목록 화면
스크린샷 TODO
에이전트 목록 — 별칭 우선 표시, owner 컬럼 + 호버 미리보기, 유형 필터 칩이 보여야 합니다.
에이전트 목록 페이지에서 다음 작업을 수행합니다.
- 검색·필터: 이름·별칭·태그로 에이전트를 검색하고 유형별 카운트 필터 칩으로 빠르게 좁힙니다.
- 별칭 우선 표시: 목록과 컨펌 다이얼로그는 별칭을 1차 라벨로 사용합니다(생성/삭제 다이얼로그 등 raw name이 필요한 위치만 시스템 이름을 노출).
- Owner 컬럼: 다른 자원과 동일한
OwnerCell+ 호버 미리보기로 소유자 정보를 제공합니다. - 상태 확인: 각 에이전트의 배포 상태(대기 / 실행 중 / 오류)가 배지로 표시됩니다.
- 액션:
- 편집: 에이전트 빌더로 이동
- 배포 / 배포 해제: 실행 가능 상태로 전환하거나 중지
- 채팅 테스트: 사이드 패널 또는 별도 페이지에서 대화로 에이전트 동작을 검증
- 삭제: 현재 사용되지 않는 에이전트 제거
채팅 연결
Assistant 사이드 패널이나 Chat 페이지에서 배포된 React 에이전트를 선택해 직접 대화할 수 있습니다(ADR-0023). 에이전트는 도구 호출 결과를 실시간으로 스트리밍하며, 도구 이름·입력·출력을 툴팁/카드로 노출해 추론 과정을 투명하게 보여 줍니다.
HITL (Human-in-the-Loop) 승인
일부 도구 호출은 사람의 승인이 필요하도록 구성할 수 있습니다. 승인 요청은 대화 UI에 카드 형태로 표시되며, 사용자는 승인 / 거부를 선택하거나 입력값을 수정해 재시도할 수 있습니다(ADR-0035).