도구와 액터 편집기
에이전트가 호출할 도구(Tool)와 위임할 액터(Actor)는 독립된 편집기에서 관리합니다. 에이전트에 바인딩되기 전에 먼저 도구/액터를 정의해 두면, 여러 에이전트가 동일한 설정을 재사용할 수 있습니다.
도구 (Tools)
도구는 에이전트가 작업 중에 호출하는 기능 단위입니다. 목록 페이지는 유형 필터 버튼과 개수 배지를 제공해 도구 유형별로 빠르게 탐색할 수 있습니다.
유형
| 유형 | 설명 |
|---|---|
| Python | Python 스크립트로 작성하는 사용자 정의 도구 |
| 에이전트 (Agent) | 다른 에이전트를 도구처럼 호출 |
| 워크플로우 (Workflow) | 파이프라인(워크플로우)을 도구처럼 호출 |
에이전트 / 워크플로우 유형의 도구를 만들면 에이전트가 다른 에이전트나 파이프라인을 도구 호출처럼 재사용할 수 있습니다.
편집 필드
- 이름 / 별칭 / 설명: 기본 메타데이터. 설명은 AI 자동 생성 버튼으로 한 번에 채울 수 있습니다.
- 유형: Python / 에이전트 / 워크플로우 중 선택.
- 입력 스키마 (JSON Schema): 도구 호출 시 필요한 파라미터 정의
- 실행 로직:
- Python: Python 스크립트. 커넥터 섹션에서 스크립트가 사용할 연결(커넥터)을 선택할 수 있습니다.
- 에이전트: 호출할 에이전트 + 입력 매핑
- 워크플로우: 호출할 파이프라인 + 입력 매핑
사람 승인은 도구가 아니라 액터에 설정합니다
실행 전 사람의 승인을 받는 단계는 도구가 아닌 액터의 확인 정책으로 지정합니다. 아래 확인 정책 (HITL)을 참고하세요.
액터 (Actors)
액터는 에이전트가 호출해 작업을 수행하는 Python 함수 단위입니다. 도구와 비슷하지만, 실행 전 사람의 승인(확인 정책)을 둘 수 있다는 점이 다릅니다.
편집 필드
- 이름 / 별칭 / 설명: 기본 메타데이터. 설명은 AI 자동 생성 버튼으로 한 번에 채울 수 있습니다.
- 소스 코드 (Python):
def execute(**kwargs) -> Any함수를 작성합니다. - 입력 파라미터 (JSON Schema): 액터를 호출할 때 받을 입력을 정의합니다.
- 커넥터: 스크립트가 사용할 연결(커넥터)을 선택합니다.
- 확인 정책 (confirmation policy): 아래 참고
확인 정책 (HITL)
액터 편집 화면의 확인 정책 섹션에서 해당 액터를 실행하기 전 사람의 승인을 거칠지 지정합니다. 세 가지 중 하나를 선택합니다.
| 정책 | 동작 |
|---|---|
| 자동 (auto) | 확인 없이 즉시 실행 |
| 확인 (confirm) | 실행 전 사람의 승인 필요 (채팅에 승인 카드 표시) |
| 거부 (deny) | 실행 완전 차단 |
확인(confirm)으로 설정한 액터를 에이전트가 실행하려 하면, 대화 UI에 승인 요청 카드가 나타나 사용자가 승인하거나 거부할 수 있습니다. 승인 흐름과 카드 UI는 에이전트 배포 흐름 — 사람 승인 카드에서 자세히 다룹니다. 액터 목록은 확인 정책별 필터 버튼을 제공합니다.
관련 UI
- 액터 선택기: 에이전트 빌더의 액터 호출 노드 또는 AI 에이전트 설정에서 액터를 검색·선택할 때 사용됩니다.
- 액터 호출 노드 설정 패널: 워크플로우 에이전트의 액터 호출 노드를 선택했을 때 표시되는 패널로, 매핑과 실행 옵션(확인 정책 포함)을 편집합니다.
목록 화면 공통 기능
- 이름 검색과 유형 필터 버튼(도구:
Python / 에이전트, 액터: 확인 정책별) - 각 필터에는 해당 항목의 개수 배지가 표시됩니다.
- 행의 액션 메뉴에서 편집 / 삭제를 수행합니다.
- 참조 중인 도구/액터를 삭제하려 할 때는 사전 경고가 표시됩니다.