에이전트 (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) 중 하나를 선택합니다(도구와 액터 편집기 참고).