에이전트 생성
에이전트는 AI 에이전트 또는 워크플로우 모드 중 하나로 설계할 수 있습니다. 목록 페이지의 + 에이전트 만들기 버튼으로 생성 대화상자를 여는 것이 기본 진입점입니다. 생성 대화상자는 두 모드를 카드로 보여 줍니다 — AI 에이전트("채팅 인터페이스")와 워크플로우("비주얼 플로우 에디터").
에이전트의 모드는 생성 시점에 고정되며 이후 변경할 수 없습니다. 다른 모드가 필요하면 새 에이전트를 생성하세요.
AI 에이전트 모드
LLM이 스스로 적절한 도구를 골라 호출하고, 그 결과를 본 뒤 다음 행동을 다시 판단하는 과정을 반복하여 목표를 달성합니다(이 방식을 ReAct라고 부릅니다). 빠른 프로토타이핑이나 자율성이 높은 작업에 적합합니다. (모델 설정 화면에서는 이 모드를 "ReAct 에이전트"로 안내합니다.)
주요 설정
- 모델: 사용할 LLM을 모델 제공자와 모델 2단계로 선택합니다. 모델 목록은 관리자가 등록한 LLM 모델 카탈로그에서 동적으로 불러오며(아래 참고), 저장 시
(제공자, 모델)쌍만 기록됩니다. - 시스템 프롬프트 (지침): 에이전트의 역할·행동 지침을 자연어로 기술합니다.
- 도구 / 액터: 에이전트가 호출 가능한 도구와 하위 액터를 선택합니다.
- 최대 반복 (Max iterations): 도구 호출 반복 상한. 무한 루프를 방지합니다(기본 10, 1~100).
모델 선택 (LLM 카탈로그)
모델 선택 UI는 관리자가 등록한 LLM 모델 카탈로그를 기반으로 동작합니다. 포털에 고정된 제공자 목록은 없습니다.
- 등록된 모델이 없을 때: "등록된 모델 없음"이 표시되며, "등록된 LLM 모델이 없습니다. 이 에이전트를 실행하려면 관리자가 모델을 먼저 등록해야 합니다."라는 안내가 함께 나타납니다. 이는 정상 상태입니다 — 모델 등록은 관리자 작업입니다(향후
설정 → LLM 모델문서 참고). - 사용 불가 모델: 과거에 선택했던 제공자·모델이 현재 카탈로그에 더 이상 없으면 라벨에 "(사용 불가)"가 붙고, 저장 전 등록된 모델로 다시 선택하라는 경고가 표시됩니다.
- 응답 온도(temperature)·최대 토큰 등 세부 파라미터 입력은 제거되었습니다. 에이전트 설정은
(제공자, 모델)선택으로 단순화되었습니다.
빌더 화면
React 빌더는 모델·지침·도구/액터 설정을 탭으로 편집합니다. 빌더 상단에서 저장·배포·채팅 테스트를 수행합니다.
워크플로우 모드
복잡한 분기·조건·반복을 가진 에이전트를 비주얼 그래프로 설계합니다. 각 노드는 LLM 호출, 도구 호출, 액터 위임, 조건 판단 등의 단일 책임을 가지며, 에지는 데이터 흐름과 제어 흐름을 나타냅니다.
4-zone 빌더 레이아웃
Workflow 빌더는 4개 영역으로 구성됩니다.
| 영역 | 위치 | 역할 |
|---|---|---|
| 액션 바 | 상단 | 에이전트명, 저장 상태, 실행 취소/다시 실행, 자동 정렬, 저장, 배포 |
| 노드 팔레트 | 좌측 | 6개 카테고리의 노드를 캔버스로 드래그 |
| 캔버스 | 중앙 | 노드 배치·연결·편집 |
| 노드 설정(인스펙터) | 우측 | 선택한 노드의 상세 설정 패널 |
노드 유형 (6 카테고리, 14종)
| 카테고리 | 노드 |
|---|---|
| 흐름 (Flow) | 시작, 종료 |
| AI | 에이전트, LLM |
| 데이터 (Data) | 코드, 템플릿, 변수 |
| 통합 (Integration) | 도구 호출, 액터 호출 |
| 제어 (Control) | 조건 분기, 반복, 병렬 실행 |
| 고급 (Advanced) | 사용자 입력, 오류 처리 |
인스펙터 패널
노드를 선택하면 우측 인스펙터 패널에 해당 노드의 입력/출력/옵션이 표시됩니다. 도구 호출 노드는 도구 시그니처에 맞춘 입력 편집기를, 액터 호출 노드는 연결할 액터와 입력 매핑, 확인 정책 (auto / confirm / deny) 을 제공합니다. confirm을 선택하면 해당 액터 실행 전 사용자 승인을 요청합니다.
공통 메타데이터
- 이름 / 별칭 / 설명 / 태그: 검색과 정렬을 위한 메타데이터입니다.
- 소유자: 기본적으로 생성자가 소유자로 지정되며, 컬렉션에 귀속시킬 수 있습니다.
AI 자동 생성 (별칭·설명·태그)
이름/별칭과 구성을 기반으로 AI가 별칭·설명·태그를 자동 생성할 수 있습니다. 입력 필드 오른쪽 가장자리의 반짝임(✨) 아이콘 버튼으로 실행합니다("AI로 설명 생성" 등).
- 위치: 입력 필드의 오른쪽 가장자리 (다른 자원과 동일 정렬).
- 생성 취소: 생성 중에는 버튼이 정지(stop) 아이콘으로 바뀌며, 버튼 클릭 또는 ESC 키로 취소할 수 있습니다.
- 생성 완료 표시: 값이 채워지면 해당 필드에 주색 배경 틴트가 약 2초간 비쳤다 사라져 AI가 방금 작성했음을 알립니다.
- 동일한 흐름이 도구(Tool)와 액터(Actor) 편집기에도 제공됩니다 — 사용자 경험은 자원 간 일관됩니다.
저장
저장 시 에이전트 정의가 서버에 기록됩니다. 변경 사항을 실행에 반영하려면 저장 후 다시 배포해야 합니다(에이전트 배포 흐름 참고). 이름(별칭) 변경은 즉시 적용됩니다.