에이전트 생성
에이전트는 React 모드 또는 Workflow 모드 중 하나로 설계할 수 있습니다. 목록 페이지의 + 에이전트 버튼으로 생성 대화상자를 여는 것이 기본 진입점입니다.
React 모드
LLM이 도구 호출·관찰·추론을 반복하여 목표를 달성하는 ReAct 패턴입니다. 빠르게 프로토타이핑하거나 자율성이 높은 작업에 적합합니다.
주요 설정
- 모델: 사용할 LLM(Provider + 모델 이름). Provider별로 그룹화된 드롭다운에서 선택합니다.
- 시스템 프롬프트: 에이전트의 역할·행동 지침을 자연어로 기술합니다.
- 도구 / 액터: 에이전트가 호출 가능한 도구와 하위 액터를 체크박스로 선택합니다.
- Temperature / Top-p: 응답의 창의성과 다양성을 조절합니다.
- Max iterations: 도구 호출 반복 상한. 무한 루프를 방지합니다.
빌더 화면
빌더는 4-zone 레이아웃을 따릅니다(ADR-0020): 좌측 트리·설정 · 중앙 캔버스/프롬프트 · 우측 인스펙터 · 하단 실행/테스트. 실행 결과는 하단 로그 패널에 스트리밍으로 출력됩니다.
Workflow 모드
복잡한 분기·조건·반복을 가진 에이전트를 비주얼 그래프로 설계합니다. 각 노드는 LLM 호출, 도구 호출, 액터 위임, 조건 판단 등의 단일 책임을 가지며, 에지는 데이터 흐름과 제어 흐름을 나타냅니다.
주요 노드 유형
- Prompt 노드: 시스템 프롬프트 및 변수 주입으로 LLM 호출
- Tool Call 노드: 정의된 도구를 호출하고 결과를 다음 노드에 전달
- Actor Call 노드: 다른 에이전트·파이프라인을 위임 실행
- Conditional 노드: 조건식을 평가해 분기
- Collector 노드: 여러 경로의 결과를 하나로 합침
인스펙터 패널
노드를 선택하면 우측 인스펙터 패널에 해당 노드의 입력/출력/옵션이 표시됩니다. 도구 호출 노드는 도구 시그니처에 맞춘 입력 편집기를, Actor Call 노드는 연결할 액터 드롭다운과 입력 매핑 UI를 제공합니다.
공통 메타데이터
- 이름 / 별칭 / 설명 / 태그: 검색과 정렬을 위한 메타데이터입니다.
- 소유자: 기본적으로 생성자가 소유자로 지정되며, 컬렉션에 귀속시킬 수 있습니다.
AI 자동 설명 생성
이름/별칭과 도구 구성을 기반으로 AI가 설명을 자동 생성할 수 있습니다.
스크린샷 TODO
에이전트 편집 패널의 Description 입력 옆 AI generate 버튼. 다른 자원(데이터셋·컬렉션·온톨로지)과 동일한 위치·아이콘 정렬을 따릅니다.
- 위치: 설명 입력 필드의 오른쪽 가장자리 (다른 자원과 동일 정렬).
- 동일한 흐름이 도구(Tool)와 액터(Actor) 편집기에도 제공됩니다 — 사용자 경험은 자원 간 일관됩니다.
저장과 버전
저장 시 에이전트 정의가 서버에 기록되며, 각 저장은 새로운 버전을 만듭니다. 버전 이력은 상세 화면에서 확인·복원할 수 있습니다. 이름 변경(alias)은 버전과 독립적으로 적용됩니다.