도구

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

​

개요

도구를 통해:

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

​

도구 대 툴킷

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

• 사용자 지정 비즈니스 로직이 필요한 경우
• 재사용 가능한 워크플로우를 만들고 싶은 경우
• 사용자 지정 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. 정기적으로 검토: 사용하지 않는 도구를 제거하여 에이전트 효율성 유지

​

트러블슈팅

​

도구가 나타나지 않음

문제: 도구가 선택기에 나타나지 않음 솔루션:

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

​

도구가 실행되지 않음

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

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

​

도구 실행 오류

문제: 실행 시 도구 실패 솔루션:

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

​

관련 문서

• 워크플로우 - 워크플로우 생성 알아보기
• 툴킷 - 사전 빌드된 통합 이해
• 에이전트 빌더 - 일반 에이전트 구성 가이드