도구와 액터 편집기
에이전트가 호출할 도구(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 / 에이전트, 액터: 확인 정책별) - 각 필터에는 해당 항목의 개수 배지가 표시됩니다.
- 행의 액션 메뉴에서 편집 / 삭제를 수행합니다.
- 참조 중인 도구/액터를 삭제하려 할 때는 사전 경고가 표시됩니다.