도구 부여하기

도구는 에이전트의 능력입니다. 너무 많이 켜면 응답이 느려지고 비용이 늘며, 너무 적으면 작업을 못 합니다. 작업 성격에 맞게 골라 켜는 것이 중요합니다.

도구 활성화 방법

에이전트 상세 페이지 → 설정 탭
활성화된 도구 섹션에서 사용할 도구 토글 ON
각 도구 옆의 자동 실행 / 승인 필요 버튼으로 실행 전 승인 여부를 도구별로 설정 (위험 도구는 승인 필요가 기본)
저장

💡 권장: 한 에이전트당 30개 이하. 그 이상이 필요하면 작업을 잘게 쪼개서 팀으로 분리하세요. 팀원 에이전트마다 다른 도구 세트를 줄 수 있습니다.

자주 쓰는 도구 카테고리

카테고리	도구
🌐 정보 수집	웹 검색 · HTTP 요청 · 웹 브라우저
✍️ 결과 출력	사용자 알림 · 카드 전송 · 사용자 질문 · 파일 공유 · 캔버스 생성/업데이트 · 캔버스 목록
💾 메모리·파일	파일 읽기 · 파일 쓰기 · 파일 수정 · 메모리 스캔 · 히스토리 검색 · 히스토리 읽기
💻 코드·시스템	Bash · 컴퓨터 사용
⏰ 자동화	스케줄 생성/조회/수정/삭제 · 태스크 생성/업데이트/조회
👥 팀 협업	팀 에이전트 목록 · 팀 에이전트 생성 · 팀 에이전트 도구 장착 · 팀 채팅 전송/읽기 · 팀 상태 조회/설정/목록/삭제 · 서브 에이전트 스폰
🧩 스킬	스킬 검색 · 스킬 살펴보기 · 스킬 설치/활성화 · 스킬 실행 · 스킬 내보내기 · 스킬 피드백 · 스킬 수정
🎨 창작	이미지 생성 · 에이전트 아바타 설정

🌐 정보 수집

설정 화면 표기	언제 쓰나요?
웹 검색	키워드로 웹에서 최신 정보를 찾아야 할 때 (도메인 화이트리스트/블랙리스트 지정 가능). 여러 검색 엔진을 자동 조합하고 복잡한 질문은 여러 하위 검색으로 분해해 인용과 함께 요약합니다
HTTP 요청	URL을 알고 있을 때 외부 API 호출 또는 정적 페이지 추출. 인증 헤더·본문 지정 등 구조화된 요청이 필요할 때
웹 브라우저	로그인이 필요하거나 클릭·스크롤·입력이 필요한 사이트. 클릭 대상의 의미(예: “게시”, “결제”, “삭제” 버튼)에 따라 자동 진행과 승인 요청이 갈립니다. 자세한 기준은 승인이 떴을 때를 참고하세요

팁: 정보만 빠르게 찾을 때는 웹 검색이 가볍고 빠릅니다. 로그인·클릭·입력이 필요한 사이트를 직접 다뤄야 한다면 웹 브라우저를 켜세요. 둘 다 부여해두고 에이전트가 상황에 맞게 고르게 해도 됩니다.

✍️ 결과 출력

설정 화면 표기	언제 쓰나요?
사용자 알림	자율 실행(스케줄·멘션·웹훅) 중 사용자에게 메시지를 전달하고 푸시 알림을 보내는 채널. 사용자가 직접 대화 중인 세션에서는 노출되지 않음
카드 전송	구조화된 카드(정보 카드, OAuth 연결, 파일 선택기 등)를 메시지와 함께 전달. 모든 트리거에서 사용 가능
사용자 질문	진행 중 모르는 정보를 사용자에게 직접 묻고 답을 기다림
파일 공유	생성한 파일을 다운로드 링크로 공유 (이미지·zip·CSV 등)
캔버스 생성/업데이트	마크다운/코드/문서를 인앱 캔버스 패널로 보여주기 (같은 제목이면 새 버전으로 갱신)
캔버스 목록	에이전트가 만든 캔버스 문서 목록 조회

💾 메모리·파일

설정 화면 표기	언제 쓰나요?
파일 읽기 / 쓰기 / 수정	에이전트의 작업 파일과 영속 저장소를 다룸
메모리 스캔	에이전트가 축적해 둔 메모리 목록 조회
히스토리 검색	길어진 대화에서 따로 보관된 지난 대화 구간을 키워드로 찾기
히스토리 읽기	검색해서 찾아낸 대화 구간의 본문을 다시 불러오기
원본 대화 조회	공유 스냅샷 세션 전용 — 설정 화면에는 표시되지 않습니다. 에이전트가 공유된 시점까지의 원본 사용자 대화를 열람. 방문자가 공유 이전의 결정·사실을 물어볼 때 활용
스냅샷 대화 기록 조회	하위 공유 링크를 1개 이상 발행한 에이전트에게만 동적으로 제공. 내가 공유한 링크를 통해 외부 사용자가 나눈 대화를 돌아보고 다음 버전 개선에 활용할 수 있습니다

팁: 반복 작업하는 에이전트는 메모리 도구를 켜두면 점점 똑똑해집니다.

💻 코드·시스템

설정 화면 표기	언제 쓰나요?
Bash	격리된 샌드박스에서 단발성 셸 명령 실행 (데이터 가공·파일 처리·간단한 API 호출 등). 실행 결과(표준 출력/오류)가 별도로 반환됩니다
컴퓨터 사용	GUI 데스크톱 환경과 셸을 직접 제어해야 할 때. 브라우저뿐 아니라 터미널·일반 GUI 앱도 포함됩니다

⏰ 자동화

설정 화면 표기	언제 쓰나요?
스케줄 생성 / 조회 / 수정 / 삭제	자기 자신의 실행 일정을 직접 등록·관리. 반복 주기(예: 매일 오전 9시)와 일회성 지연 실행(예: 30분 후 한 번) 두 방식을 지원합니다
태스크 생성 / 업데이트 / 조회	여러 단계 작업을 명시적으로 추적 (의존성·완료 상태 관리)

👥 팀 협업

설정 화면 표기	언제 쓰나요?
팀 에이전트 목록	같은 팀의 다른 에이전트 찾기 (@mention 대상 탐색)
팀 에이전트 생성	팀 안에 새 전문가 에이전트를 만들고 그래프로 연결 (위험 도구 — 기본 `승인 필요`)
팀 에이전트 도구 장착	팀원 에이전트에 도구·스킬 추가. 팀을 만든 에이전트(FATHER)만 사용 가능하며, 팀 멤버끼리는 서로 장착해 줄 수 없습니다
팀 채팅 전송 / 읽기	팀 채팅에 메시지 게시. `@AgentName`이 들어가면 해당 에이전트가 자동으로 깨어남. 응답이 필요한 멘션 시 멘션된 에이전트가 완료 후 다시 멘션을 보냄. 스레드 답글(특정 멘션에 대한 답)을 보내면 연결선 방향과 상관없이 그 멘션을 처음 보낸 에이전트를 깨울 수 있음
팀 상태 조회 / 설정 / 목록 / 삭제	팀 전체가 공유하는 메모리 (개인 메모리와 별개로, 팀원 모두가 같이 보는 정보). 삭제는 마지막으로 값을 수정한 에이전트 또는 팀을 만든 에이전트(FATHER)만 가능합니다
서브 에이전트 스폰	한 번만 쓸 일회성 보조 에이전트를 띄워 결과만 받아오기. 팀을 만든 에이전트(FATHER)만 사용 가능합니다

🧩 스킬

설정 화면 표기	언제 쓰나요?
스킬 검색	마켓플레이스 또는 내 스킬 라이브러리에서 스킬 찾기
스킬 살펴보기	설치 전 스킬의 설명 파일(SKILL.md)과 포함된 파일 목록을 미리 확인. 스킬 설치 도구를 처음 호출할 때 이 단계가 자동으로 먼저 실행됩니다
스킬 설치/활성화 (⚠️ 승인 필요)	마켓플레이스 스킬을 이 에이전트에 추가하기 (위험 도구 — 기본 `승인 필요`). 설치 시 내용을 복사하지 않고 원본을 참조하는 방식으로 등록되며, 이미 수정한 스킬이 있으면 그 버전을 사용합니다
스킬 실행	설치된 스킬 스크립트를 샌드박스에서 실행
스킬 내보내기 (⚠️ 승인 필요)	샌드박스 코드를 재사용 가능한 스킬로 패키징해 초안으로 저장 (사용자 검토 후 게시)
스킬 피드백	사용한 스킬의 결함을 보고하면, 다른 사람의 스킬은 작성자에게 개선 제안으로 전달되고, 내가 직접 수정해 온 스킬은 곧바로 직접 고치도록 안내됩니다
스킬 수정	내가 직접 수정해 온 스킬의 파일을 정확한 문자열 치환으로 자가 수정. 수정 전·후 버전을 자동 저장해 이전 버전으로 되돌릴 수 있습니다

🎨 창작

설정 화면 표기	언제 쓰나요?
이미지 생성	텍스트→이미지, 참조 이미지 편집(최대 14장), 멀티턴 반복 수정. 해상도 4단계(512·1K·2K·4K), 종횡비 14종 선택 가능
에이전트 아바타 설정	AI 생성 또는 URL로 에이전트 프로필 이미지 변경. 에이전트 본인의 아바타는 누구나 변경할 수 있고, 다른 에이전트의 아바타는 팀을 만든 에이전트(FATHER)만 변경할 수 있습니다

승인(human-in-the-loop)

도구별로 자동 실행 / 승인 필요 를 따로 설정할 수 있습니다. 스킬 설치/활성화, 팀 에이전트 생성, 스킬 내보내기는 도구별 승인 설정이 처음부터 승인 필요로 켜져 있어, 에이전트가 실행하기 전에 사용자가 채팅에서 직접 승인해야 합니다. 스킬 내보내기는 승인 후 초안으로 저장되며 별도 검토 화면이 표시됩니다.

이 세 가지 외에도, 작업의 성격상 기본적으로 승인을 요청하는 도구가 더 있습니다. 파일 공유, 서브 에이전트 스폰, 팀 에이전트 도구 장착, 스케줄 생성/수정/삭제는 기본값으로 실행 전 승인 카드를 띄웁니다. 또한 HTTP 요청(데이터를 보내거나 바꾸는 요청), 컴퓨터 사용(화면을 바꾸는 동작), 웹 브라우저(게시·결제·삭제처럼 결과를 남기는 동작)도 동작의 위험도에 따라 승인을 요청합니다. 이 도구들도 도구별 설정이나 자동 승인 설정으로 동작을 조정할 수 있습니다. 전체 기준은 승인이 떴을 때에서 확인하세요.

도구가 너무 많으면?

도구를 많이 켤수록 LLM이 매 턴 모든 도구 설명을 읽어야 해서 응답이 느려지고 비용이 늘어납니다. 한 에이전트당 30개 이하를 권장합니다.

작업이 복잡해서 도구가 더 필요하면 팀으로 분리하세요. 팀원 에이전트마다 다른 도구 세트를 줄 수 있고, 팀 채팅으로 결과를 주고받게 할 수 있습니다.

다음 단계

스킬·프리셋 설치하기 — 도구 조합이 이미 잘 짜인 패키지 활용
스킬과 자율 스킬 시스템 — 검증된 절차를 스킬로 묶어 재사용. 스킬 피드백·수정 도구가 자율 스킬 시스템과 어떻게 연결되는지 자세히 다룹니다.