개요
에이전트는 AI 언어 모델(LLM)에 도구와 액터를 연결해 요청을 처리하는 자산입니다. 요청에 따라 등록된 기능을 호출하고 그 결과를 응답에 반영합니다.
에이전트 관리 화면은 사이드바 AI 섹션의 에이전트 메뉴에서 엽니다. 같은 섹션에는 도구, 액터, 프롬프트, 시맨틱 레이어 메뉴가 있습니다. 또는 컬렉션 탐색기에서 에이전트가 속한 컬렉션을 펼쳐 에이전트 항목을 클릭해도 됩니다.
구성 요소
| 요소 | 설명 |
|---|---|
| 에이전트 | 입력 요청에 따라 기능을 호출합니다. AI 에이전트 또는 워크플로우 모드로 구성합니다. |
| 도구 | 검색·계산·REST 호출·사용자 정의 코드 작업을 실행합니다. |
| 액터 | 에이전트가 호출하는 Python 함수형 실행 단위입니다. 실행 전에 사람의 승인을 받도록 설정할 수 있습니다. |
| 프롬프트 | 시스템 지시문을 저장하고 여러 에이전트에서 재사용합니다. |
| 시맨틱 레이어 | 자연어 질의에 사용할 시맨틱 테이블·값 사전·질의 템플릿을 관리합니다. |
에이전트는 두 실행 모드 중 하나를 사용합니다. 생성 창에서 모드를 선택하며 만든 뒤에는 변경할 수 없습니다.
- AI 에이전트: LLM이 요청에 따라 도구를 선택하고 도구 결과를 다음 처리 단계의 입력으로 사용합니다. 이 반복 실행 방식을 ReAct라고 하며 채팅 화면에서 사용합니다.
- 워크플로우: 그래프에서 단계·조건·분기를 연결합니다. 이벤트로만 실행되며 채팅 화면에는 표시되지 않습니다. 노드별 설정은 워크플로우 에이전트에서 확인합니다.
목록 화면
에이전트 목록 페이지에서 다음 작업을 수행합니다.
- 검색·필터: 이름·별칭·설명으로 에이전트를 검색하고 상태별 개수 필터 버튼(전체 / 실행 중 / 중지 / 초안)으로 표시할 상태를 선택합니다.
- 별칭 우선 표시: 목록과 확인 창에는 별칭이 먼저 표시됩니다. 정확한 시스템 이름이 필요한 생성·삭제 창에는 시스템 이름도 함께 표시됩니다.
- 소유자 컬럼: 소유자 이름과 마우스 올림 미리보기를 표시합니다.
- 상태 확인: 각 에이전트의 배포 상태(초안 / 실행 중 / 중지)가 배지로 표시됩니다.
- 작업:
- 편집: 에이전트 빌더로 이동
- 복제: 원본 구성을 독립된 새 에이전트로 복사
- 배포 / 배포 해제: 실행 가능 상태로 전환하거나 중지
- 채팅: 배포된 AI 에이전트와 저장되는 대화(세션)를 시작합니다. 배포 전에는 비활성 상태이며 "배포 후 사용 가능" 안내가 뜹니다.
- 삭제: 현재 사용되지 않는 에이전트 제거
행을 여러 개 선택하면 배포, 중지, 모델 변경, 삭제를 한 번에 실행합니다. 상태 조건과 부분 실패 처리 방식은 에이전트 배포에서 확인합니다.
에이전트를 복제하려면 행의 작업 메뉴에서 복제를 선택합니다. 원본과 다른 새 시스템 이름과 대상 컬렉션을 지정하고, 원본 별칭·설명·태그를 초기값으로 확인해 필요한 부분을 바꿉니다. 복제본은 원본과 구성이 같더라도 별도 ID를 가진 새 에이전트이며 원본을 수정하지 않습니다. 복제 뒤 빌더에서 모델·도구·프롬프트와 권한을 확인하고 별도로 저장·배포합니다.
저장된 모델·도구·프롬프트 구성을 이전 상태로 되돌릴 때는 버전 기록에서 복원 범위와 재배포 영향을 먼저 확인합니다.
채팅과 미리보기
배포된 AI 에이전트와 대화하는 화면은 성격이 다른 두 가지로 나뉩니다.
- 채팅 (목록에서 채팅 선택): 대화가 세션으로 저장되는 실제 채팅입니다. 헤더에 저장됨 · 세션 기록 배지가 붙습니다.
- 미리보기 (빌더 우측 패널): 저장되지 않는 임시 대화로, 편집하면서 동작을 즉시 확인할 때 씁니다. 헤더에 임시 · 저장 안 됨 배지가 붙고, 채팅에서 열기를 누르면 저장되는 실제 채팅으로 새 대화를 엽니다.
채팅과 미리보기에는 도구 호출 결과가 실행 순서대로 표시됩니다. 도구 이름·입력·출력은 툴팁이나 카드에서 확인합니다.
실제 채팅의 도구 과정에서는 실행 중인 도구와 완료·실패 요약을 접이식 타임라인으로 확인합니다. 단계별 인자·오류, 브라우저 표시 설정과 세션 복원 동작은 에이전트 배포의 실행 관찰에서 확인합니다.
D.Hub 어시스턴트 사이드 패널에는 에이전트를 수동으로 선택하거나 연결하는 설정이 없습니다. 현재 화면이나 지정한 자산에서 지원 시나리오 도메인을 확인하면 같은 도메인 태그가 있는 실행 중 AI 에이전트로 자동 라우팅합니다. 일치하는 에이전트가 없으면 전용 어시스턴트로 연결합니다. 특정 에이전트를 직접 사용하려면 에이전트 목록에서 채팅을 엽니다.
워크플로우 에이전트는 이벤트 실행만 지원하므로 채팅 화면에 나타나지 않습니다. 직접 채팅 주소로 접근하면 빌더로 이동합니다. 화면별 동작은 워크플로우 에이전트와 채팅에서 확인합니다.
사람 승인 (HITL)
액터의 확인 정책을 확인으로 설정하면 실행 전에 승인 요청 카드가 나타납니다. 사용자는 승인 또는 거부를 선택하고 거부할 때는 사유를 입력합니다. 이 승인 방식을 HITL(Human-in-the-Loop)이라고 합니다.
| 정책 | 기술 식별자 |
|---|---|
| 자동 | auto |
| 확인 | confirm |
| 거부 | deny |
설정 방법은 도구와 액터 만들고 편집하기에서 확인합니다.
관련 문서
- 에이전트 만들기 — 실행 모드와 모델·도구를 정해 에이전트를 만듭니다.
- 에이전트 도구와 액터 — 에이전트가 호출할 기능을 준비합니다.
- 가져오기·내보내기 — 에이전트와 관련 리소스를 JSON 또는 ZIP으로 옮깁니다.
- 에이전트 배포 — 저장한 에이전트를 배포하고 실행 상태를 확인합니다.