에이전트 (Agents) 개요
에이전트(Agents)는 D.Hub에서 LLM과 도구(Tools), 액터(Actors)를 결합해 자연어 기반 작업을 자동 수행하는 자율 실행 단위입니다. 일반적인 챗봇이 정해진 답변을 반환하는 것과 달리, 에이전트는 사용자 질의를 해석한 뒤 적절한 도구를 호출하고, 필요 시 추가 검색·계산·외부 API 호출을 수행해 결과를 생성합니다.
에이전트 관리 화면은 사이드바 도구 그룹의 에이전트 메뉴에서 진입합니다(하위 항목: 에이전트 / 도구 / 액터). 또는 컬렉션 탐색기에서 에이전트가 속한 컬렉션을 펼쳐 에이전트 항목을 클릭해도 됩니다.
구성 요소
| 요소 | 설명 |
|---|---|
| Agent (에이전트) | 입력 질의에 대해 추론·의사결정을 수행하는 주체. AI 에이전트 또는 워크플로우 모드로 구성 |
| Tool (도구) | 에이전트가 호출 가능한 기능 (검색, 계산, REST 호출, 사용자 정의 코드 등) |
| Actor (액터) | 에이전트가 호출하는 Python 함수형 실행 단위. 실행 전 사람 승인(확인 정책)을 둘 수 있음 |
에이전트의 로직은 두 모드 중 하나로 설계됩니다. 생성 대화상자에는 두 모드가 카드로 표시되며, 모드는 생성 시점에 선택하며 생성 후에는 변경할 수 없습니다.
- AI 에이전트: LLM이 스스로 적절한 도구를 골라 호출하고, 그 결과를 본 뒤 다음 행동을 다시 판단하는 과정을 반복하여 목표를 달성합니다(이 방식을 ReAct라고 부릅니다). 채팅 인터페이스로 동작합니다.
- 워크플로우: 4개 영역 레이아웃의 비주얼 그래프로 단계·조건·분기를 명시적으로 설계합니다. 이벤트 실행 전용이며 채팅 UI에는 노출되지 않습니다.
목록 화면
에이전트 목록 페이지에서 다음 작업을 수행합니다.
- 검색·필터: 이름·별칭·설명으로 에이전트를 검색하고, 상태별 개수 필터 버튼(전체 / 실행 중 / 중지 / 초안)으로 빠르게 좁힙니다.
- 별칭 우선 표시: 목록과 컨펌 다이얼로그는 별칭을 1차 라벨로 사용합니다(생성/삭제 다이얼로그 등 raw name이 필요한 위치만 시스템 이름을 노출).
- Owner 컬럼: 다른 자원과 동일하게 소유자 정보를 호버 미리보기와 함께 제공합니다.
- 상태 확인: 각 에이전트의 배포 상태(초안 / 실행 중 / 중지)가 배지로 표시됩니다.
- 액션:
- 편집: 에이전트 빌더로 이동
- 배포 / 배포 해제: 실행 가능 상태로 전환하거나 중지
- 채팅 테스트: 사이드 패널 또는 별도 페이지에서 대화로 에이전트 동작을 검증
- 삭제: 현재 사용되지 않는 에이전트 제거
채팅 연결
배포된 AI 에이전트와는 Chat 페이지(/agents/:id/chat)나 빌더의 채팅 테스트에서 직접 대화할 수 있습니다(Assistant 사이드 패널은 에이전트를 직접 고르지 않고 컨텍스트 기반으로 자동 선택됩니다). 에이전트는 도구 호출 결과를 실시간으로 스트리밍하며, 도구 이름·입력·출력을 툴팁/카드로 노출해 추론 과정을 투명하게 보여 줍니다.
워크플로우 에이전트는 이벤트 실행만 지원하므로 채팅 테스트 액션이나 Chat 페이지에 나타나지 않습니다. 워크플로우 에이전트의 채팅 URL로 직접 접근하면 빌더로 자동 이동하며, "워크플로우 에이전트는 이벤트 실행만 지원합니다"라는 안내가 표시됩니다. 자세한 내용은 에이전트 배포 흐름을 참고하세요.
사람 승인 (HITL)
액터(Actor)의 확인 정책(confirmation policy)을 확인(confirm)으로 설정하면, 에이전트가 해당 액터를 실행하기 전에 사람의 승인이 필요합니다. (HITL = Human-in-the-Loop, 즉 "사람이 중간에 개입해 승인하는" 방식입니다.) 승인 요청은 대화 UI에 카드 형태로 표시되며, 사용자는 승인 / 거부를 선택하거나 거부 사유를 입력할 수 있습니다. 정책은 액터별로 자동(auto) / 확인(confirm) / 거부(deny) 중 하나를 선택합니다(도구와 액터 편집기 참고).