도구와 액터 편집기
에이전트가 호출할 **도구(Tool)**와 위임할 **액터(Actor)**는 독립된 편집기에서 관리합니다. 에이전트에 바인딩되기 전에 먼저 도구/액터를 정의해 두면, 여러 에이전트가 동일한 설정을 재사용할 수 있습니다.
도구 (Tools)
도구는 에이전트가 런타임에 호출 가능한 기능 단위입니다. 목록 페이지는 유형 필터 칩과 개수 배지를 제공해 도구 유형별로 빠르게 탐색할 수 있습니다.
유형
| 유형 | 설명 |
|---|---|
| Built-in | 시스템이 기본 제공하는 도구(검색, 계산기, 시간 등) |
| Custom | Python 스크립트로 작성된 사용자 정의 도구 |
| REST | 등록된 REST 커넥터를 통해 API를 호출하는 도구 |
| Workflow | 파이프라인(워크플로우)을 호출하는 도구 |
| Agent | 다른 에이전트를 도구처럼 호출 |
Workflow / Agent 유형의 도구를 만들면 에이전트가 파이프라인이나 다른 에이전트를 도구 호출처럼 재사용할 수 있습니다.
편집 필드
- 이름 / 별칭 / 설명: 기본 메타데이터. 설명은 AI 자동 생성 버튼으로 한 번에 채울 수 있습니다.
- 입력 스키마(JSON Schema): 도구 호출 시 필요한 파라미터 정의
- 출력 스키마: 도구 결과 구조 (선택)
- 실행 로직:
- Custom: Python 스크립트
- REST: 커넥터 + 경로 + 입력 매핑
- Workflow: 호출할 파이프라인 + 입력 매핑
- Agent: 호출할 에이전트 + 입력 매핑
- HITL 승인 필요 여부: 사람이 호출을 승인해야만 실제로 실행되도록 지정 (ADR-0035, 에이전트 배포 흐름 참고)
테스트
편집 페이지 하단의 Test Run 영역에서 입력값을 채워 도구를 단독 실행하고 결과를 확인할 수 있습니다.
액터 (Actors)
액터는 에이전트가 위임할 하위 실행 주체입니다. 다른 에이전트, 고정 파이프라인, 외부 서비스 등을 동일한 인터페이스로 감쌉니다.
편집 필드
- 이름 / 별칭 / 설명: 기본 메타데이터. 설명은 AI 자동 생성 버튼으로 한 번에 채울 수 있습니다.
- 실행 대상: 다른 에이전트, 파이프라인 등
- 입력 매핑: 상위 에이전트에서 넘어오는 입력을 하위 대상의 입력 스키마에 매핑
- 실행 컨텍스트: 메모리 공유 여부, 실행 타임아웃 등
관련 UI
- ActorSelector: 에이전트 빌더의 Actor Call 노드 또는 React 에이전트 설정에서 액터를 검색·선택할 때 사용됩니다.
- ActorCallPanel: Workflow 에이전트의 Actor Call 노드를 선택했을 때 표시되는 인스펙터 패널로, 매핑과 실행 옵션을 편집합니다.
목록 화면 공통 기능
- 이름 검색과 유형 필터 칩(
Built-in / Custom / REST / Workflow / Agent) - 각 필터에는 해당 유형의 개수 배지가 표시됩니다.
- 행의 액션 메뉴에서 편집 / 복제 / 삭제를 수행합니다.
- 참조 중인 도구/액터를 삭제하려 할 때는 사전 경고가 표시됩니다.