> ## Documentation Index
> Fetch the complete documentation index at: https://ai-kb.automationanywhere.com/llms.txt
> Use this file to discover all available pages before exploring further.

# 도구

> 에이전트에 사용자 지정 도구 및 워크플로우 추가

에이전트 빌더의 **도구** 탭을 사용하면 에이전트에 사용자 지정 도구 및 워크플로우를 추가할 수 있습니다. **툴킷**(사전 빌드된 통합)과 달리, **도구**는 사용자가 만든 사용자 지정 도구 및 워크플로우로 요구 사항에 맞게 기능을 확장합니다.

## 개요

**도구**를 통해:

* **사용자 지정 도구 추가**: 프로젝트에서 만든 사용자 지정 도구 첨부
* **워크플로우 추가**: 다단계 프로세스를 실행하는 워크플로우/작업 포함
* **새 도구 만들기**: 에이전트 빌더에서 직접 새 사용자 지정 도구 빌드
* **도구 구성 관리**: 에이전트가 도구를 사용하는 방법 구성
* **도구 라이브러리 탐색**: 공개 라이브러리에서 수천 개의 사전 빌드된 도구 접근

## 도구 대 툴킷

차이점을 이해하면 올바른 접근 방식을 선택하는 데 도움이 됩니다:

| 기능     | 도구                            | 툴킷                           |
| ------ | ----------------------------- | ---------------------------- |
| **유형** | 사용자 지정 도구 및 워크플로우             | 사전 빌드된 통합                    |
| **생성** | 사용자가 생성하거나 라이브러리에서            | EKB에서 사전 구성                  |
| **범위** | 프로젝트별 또는 공개                   | 플랫폼 전체 통합                    |
| **구성** | 완전한 사용자 지정                    | 사전 구성 및 옵션                   |
| **예시** | 사용자 지정 API 호출, 워크플로우, 비즈니스 로직 | Gmail, Slack, Google Drive 등 |

**도구를 사용하는 시점:**

* 사용자 지정 비즈니스 로직이 필요한 경우
* 재사용 가능한 워크플로우를 만들고 싶은 경우
* 사용자 지정 API와 통합해야 하는 경우
* 여러 작업을 하나의 도구로 결합하고 싶은 경우

**툴킷을 사용하는 시점:**

* 표준 통합이 필요한 경우 (Gmail, Slack 등)
* 사전 구성된 인증을 원하는 경우
* 일반적인 작업이 필요한 경우 (이메일 발송, 태스크 생성 등)

## 도구 탭에 접근

1. **에이전트 빌더 열기**
   * 사이드바에서 **에이전트**로 이동
   * 기존 에이전트의 **편집** 또는 **에이전트 생성** 클릭
   * 에이전트 빌더가 열림

2. **도구 탭으로 이동**
   * 왼쪽 사이드바에서 **도구** 클릭
   * 도구 탭이 선택된 도구와 추가 옵션과 함께 표시됨

## 에이전트에 도구 추가

### 기존 사용자 지정 도구 추가

1. **도구 선택기 열기**
   * 도구 탭에서 **+ 도구 추가** 버튼 클릭
   * 도구 선택기 모달이 열림

2. **사용 가능한 도구 탐색**
   * **사용자 지정 도구**: 프로젝트에서 만든 도구
   * **공개 도구**: 공개 라이브러리의 도구 (9,000개 이상 사용 가능)
   * **워크플로우**: 프로젝트의 기존 워크플로우

3. **검색 및 필터링**
   * 검색 표시줄을 사용하여 특정 도구 찾기
   * 카테고리 또는 유형별 필터링
   * 인기 또는 최근 추가순으로 탐색

4. **도구 선택**
   * 도구를 클릭하여 세부 정보 확인
   * 도구의 설명 및 입력 검토
   * **추가**를 클릭하여 에이전트에 첨부

### 새 사용자 지정 도구 만들기

1. **도구 선택기에서**
   * 도구 탭에서 **+ 도구 추가** 클릭
   * 모달에서 **사용자 지정 도구 만들기** 클릭
   * 도구 빌더로 리디렉션됨

2. **빈 상태에서**
   * 도구가 없는 경우 **첫 번째 도구 만들기** 클릭
   * 새 도구를 위한 도구 빌더가 열림

3. **도구 구성**
   * **이름**: 도구에 설명적인 이름 부여
   * **설명**: 도구가 하는 일을 설명
   * **입력**: 입력 매개변수 정의
   * **단계**: 도구의 실행 단계 구성
   * **저장**: 초안으로 저장하거나 게시

4. **에이전트로 돌아가기**
   * 생성 후 도구가 프로젝트에서 사용 가능해짐
   * 에이전트 빌더로 돌아가 도구 선택기를 통해 추가

### 워크플로우 추가

1. **도구 선택기 열기**
   * 도구 탭에서 **+ 도구 추가** 클릭
   * 모달에서 **워크플로우 만들기** 클릭

2. **워크플로우 트리거 선택**
   * 트리거 유형 선택:
     * **양식 입력**: 사용자가 양식을 작성
     * **파일 업로드**: 사용자가 파일 업로드
     * **수동**: 요청 시 실행

3. **워크플로우 구성**
   * 워크플로우 단계 설정
   * 입출력 정의
   * 트리거 설정 구성

4. **에이전트에 추가**
   * 생성되면 워크플로우가 도구 목록에 나타남
   * 필요 시 에이전트가 실행할 수 있음

## 도구 관리

### 추가된 도구 보기

**도구** 탭은 다음을 표시합니다:

* **사이드바**: 에이전트에 추가된 모든 도구 표시
  * 사용자 지정 도구
  * 워크플로우
  * 프로젝트의 작업
* **메인 영역**: 도구 세부 정보 및 관리 옵션 표시

### 도구 상태

도구는 다양한 상태를 가질 수 있습니다:

* **활성**: 도구가 사용 준비됨
* **초안**: 도구가 편집 중 (아직 게시되지 않음)
* **게시**: 도구가 게시되었고 사용 가능

### 도구 구성

1. **도구 구성 편집**
   * 추가된 도구에서 **구성** 클릭
   * 도구별 설정 조정
   * 승인 요구 사항 설정 (필요한 경우)

2. **도구 승인 설정**
   * **자동 실행**: 트리거되면 도구가 자동으로 실행
   * **승인 필요**: 에이전트가 실행 전 확인을 요청

3. **입력 기본값**
   * 도구 입력의 기본값 설정
   * 필수 대 선택 입력 구성

### 도구 제거

1. **에이전트에서 제거**
   * 사이드바에서 도구의 **X** 버튼 클릭
   * 또는 도구 세부 정보에서 **제거** 클릭
   * 제거 확인

2. **사용자 지정 도구 삭제**
   * 사용자 지정 도구의 경우 완전히 삭제할 수 있음
   * 사용자 지정 도구의 세로 점 3개 메뉴 클릭
   * **삭제** 선택
   * **참고**: 이는 프로젝트에서 도구를 영구적으로 삭제합니다

## 도구 유형

### 사용자 지정 도구

사용자 지정 도구는 다음으로 만드는 도구입니다:

* **사용자 지정 로직**: 자체 비즈니스 규칙 및 프로세스
* **API 통합**: 자체 API에 연결
* **다단계 작업**: 여러 작업 결합
* **데이터 처리**: 데이터 변환 및 조작

### 워크플로우

워크플로우는 다음을 할 수 있는 다단계 프로세스입니다:

* **순서 실행**: 여러 작업을 순서대로 실행
* **트리거 처리**: 양식 입력 또는 파일 업로드에 응답
* **데이터 처리**: 여러 단계를 통해 데이터 변환
* **서비스 통합**: 여러 서비스를 함께 연결

### 공개 도구

공개 도구 라이브러리에는 다음이 포함됩니다:

* **9,000개 이상의 도구**: 커뮤니티의 사전 빌드된 도구
* **다양한 카테고리**: 커뮤니케이션, 생산성, 데이터 등
* **바로 사용 가능**: 클론 후 요구 사항에 맞게 사용자 지정
* **정기 업데이트**: 새로운 도구가 자주 추가됨

## 모범 사례

### 도구 구성

1. **명확하게 이름 짓기**: 도구의 목적을 설명하는 설명적인 이름 사용
2. **잘 문서화하기**: 각 도구에 대한 명확한 설명 추가
3. **관련 도구 그룹화**: 기능 또는 카테고리별로 도구 구성
4. **버전 관리**: 게시 전 테스트를 위해 초안 사용

### 도구 선택

1. **단순하게 시작**: 기본 도구로 시작하고 복잡성을 점진적으로 추가
2. **철저하게 테스트**: 프로덕션 에이전트에 추가하기 전에 도구 테스트
3. **성능 고려**: 너무 많은 도구는 에이전트 응답을 느리게 할 수 있음
4. **정기적으로 검토**: 사용하지 않는 도구를 제거하여 에이전트 효율성 유지

## 트러블슈팅

### 도구가 나타나지 않음

**문제**: 도구가 선택기에 나타나지 않음

**솔루션:**

* 도구가 게시되었는지 확인 (초안은 나타나지 않을 수 있음)
* 올바른 프로젝트에 있는지 확인
* 도구 목록 새로고침
* 도구 권한 확인

### 도구가 실행되지 않음

**문제**: 에이전트가 도구를 사용하지 않음

**솔루션:**

* 도구가 에이전트에 추가되었는지 확인
* 도구 구성 확인
* 에이전트의 시스템 프롬프트 검토 (도구를 언급해야 할 수 있음)
* 도구를 독립적으로 테스트

### 도구 실행 오류

**문제**: 실행 시 도구 실패

**솔루션:**

* 도구 입력이 올바른지 확인
* 도구 구성 확인
* 도구 실행 로그에서 오류 메시지 검토
* 샘플 입력으로 도구 테스트

## 관련 문서

* [워크플로우](/tools/workflows-v2) - 워크플로우 생성 알아보기
* [툴킷](/agents/toolkits/overview) - 사전 빌드된 통합 이해
* [에이전트 빌더](/agents/agents) - 일반 에이전트 구성 가이드