튜토리얼 18: 도구 및 도구 세트 — AI의 손

이 글은 Hermes Agent 공식 튜토리얼 시리즈의 일부입니다. 전체 튜토리얼 보기

여러분의 어시스턴트에게 스위스 아미 나이프를 쥐어준다고 상상해 보세요. 각 도구는 서로 다른 칼날이고, 툴셋은 그 칼날들을 정리해 두는 작은 케이스입니다. 바로 이것이 Hermes Agent에서 Tools와 Toolsets이 하는 역할입니다. AI에게 그냥 대화만 하는 게 아니라 실제로 무언가를 해내는 “손”을 쥐어주는 거죠.

1단계: 도구들 만나보기 (AI의 손가락)

Hermes에는 기본 제공되는 도구들로 가득 찬 공구함이 함께 제공됩니다. 간단히 정리하면 이렇습니다:

카테고리	기능	예시
웹	인터넷 검색, 페이지 읽기	`web_search`, `web_extract`
터미널 및 파일	명령 실행, 파일 편집	`terminal`, `read_file`, `patch`
브라우저	실제 브라우저 열기, 화면 보기	`browser_navigate`, `browser_vision`
미디어	이미지 분석, 아트 생성, 음성 출력	`vision_analyze`, `image_generate`, `text_to_speech`
에이전트 오케스트레이션	계획 수립, 질문, 코드 작성	`todo`, `clarify`, `execute_code`, `delegate_task`
메모리	과거 대화 기억	`memory`, `session_search`
자동화	작업 예약	`cronjob`
통합	스마트 홈, MCP 서버 연동	`ha_*`, MCP 도구

초보자 팁: 이걸 전부 외우지 마세요. 그냥 이런 게 있다는 것만 알아두면 됩니다. 필요할 때마다 골라 쓰면 됩니다.

2단계: 도구 켜기 (스위치 켜듯이)

도구들은 툴셋이라는 단위로 묶여 있습니다. 미리 포장된 키트라고 생각하면 됩니다. 채팅 세션별로 또는 플랫폼별로(예: 텔레그램 vs. 내 컴퓨터) 활성화할 수 있습니다.

제어하는 방법은 다음과 같습니다:

# 채팅에서 특정 툴셋 사용하기
hermes chat --toolsets "web,terminal"

# 사용 가능한 모든 도구 보기 (대화형 메뉴)
hermes tools

# 특정 플랫폼용 도구 구성하기
hermes tools

어떤 화면이 나오나요? hermes tools를 실행하면 친절한 메뉴가 나타납니다. 스페이스바를 눌러 도구를 켜고 끄면 됩니다. 피자 토핑 고르는 것과 똑같아요. 원하는 것만 골라 담고, 나머지는 놔두면 됩니다.

3단계: 자주 쓰는 툴셋 알아두기 (단골 키트)

전부 기억할 필요는 없지만, 이 정도는 가장 자주 쓰게 될 겁니다:

web — 웹사이트 검색 및 읽기
terminal — 컴퓨터에서 명령 실행
file — 파일 읽기 및 편집
browser — 실제 브라우저 자동화
vision — 이미지 분석
memory — 채팅 간 기억 유지
cronjob — 작업 예약
delegation — Hermes가 하위 에이전트 생성

예시: Hermes에게 뭔가 조사시키고 메모를 파일로 저장하고 싶다면? --toolsets "web,file"을 사용하면 끝입니다.

4단계: 특별한 도구들 (숨은 보석)

알아두면 좋은 멋진 기능 두 가지:

1. X(트위터) 검색 — X의 게시물을 검색할 수 있지만, 기본적으로 꺼져 있습니다. xAI 자격 증명(SuperGrok 또는 XAI_API_KEY)이 필요합니다. hermes tools → 🐦 X(트위터) 검색에서 켤 수 있습니다.

2. 도구 게이트웨이 — 유료 Nous Portal 구독자라면 별도의 API 키 없이 웹 검색, 이미지 생성, TTS, 브라우저 자동화를 이용할 수 있습니다. 그냥 실행하세요:

hermes model

그런 다음 hermes tools로 개별 도구를 활성화하면 됩니다.

5단계: 터미널 백엔드 선택하기 (명령이 실행되는 곳)

terminal 도구는 다양한 환경에서 명령을 실행할 수 있습니다:

백엔드	기능	적합한 경우
`local`	내 컴퓨터에서 실행 (기본값)	신뢰할 수 있는 작업, 개발
`docker`	격리된 컨테이너에서 실행	보안, 테스트
`ssh`	원격 서버에서 실행	에이전트를 자체 코드로부터 분리
`singularity`	Singularity 컨테이너 사용	HPC / 과학 컴퓨팅

초보자 팁: local로 시작하세요. 안전이 걱정되면 docker로 전환하세요.

다음 단계: 스킬 시스템에 대해 자세히 알아보겠습니다. 여러분의 작업 흐름에 완벽하게 맞는 새로운 기술을 Hermes에게 가르치는 방법입니다.

이제 Hermes에게 “손”을 쥐어주는 방법을 알게 되었습니다. 다음으로는 나만의 맞춤 도구를 만드는 방법을 자세히 살펴보겠습니다. 여러분의 작업 흐름에 완벽하게 맞는 새로운 기술을 Hermes에게 가르칠 수 있게 될 거예요.

계속 지켜봐 주세요, 그리고 즐거운 자동화 되세요! 🚀