> For the complete documentation index, see [llms.txt](https://help.genesis.autify.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.genesis.autify.com/features-ko/ai-feature/tools.md).

# 도구

Autify Genesis에서는 AI 어시스턴트와 AI 에이전트 블록이 AI 모델에 도구를 조합하여 코드베이스 탐색, 파일 읽기, 외부 서비스 연동 등을 실행할 수 있습니다.

## 도구 종류

사용할 수 있는 도구는 다음 3가지로 나뉩니다.

| 종류                 | 내용                                                                                       |
| ------------------ | ---------------------------------------------------------------------------------------- |
| 개별적으로 활성화하는 빌트인 도구 | AI 에이전트 블록의 **도구** 탭에서 선택하는 도구입니다. AI 어시스턴트에서는 자동으로 사용됩니다.                               |
| 조건에 따라 자동 부여되는 도구  | 워크스페이스 상태나 활성화된 연동에 따라 자동으로 추가되는 도구입니다.                                                  |
| 사용자 지정 MCP 서버      | 워크스페이스의 **리소스 및 컨텍스트 > 연동**에서 외부 MCP(Model Context Protocol) 연결을 등록하면 사용할 수 있게 되는 도구입니다. |

## 빌트인 도구

주요 빌트인 도구는 다음과 같습니다.

| 도구        | 설명                                                  |
| --------- | --------------------------------------------------- |
| 탐색        | bash 풍의 명령으로 워크스페이스의 코드베이스와 업로드된 파일을 읽기 전용으로 확인합니다. |
| 미디어 보기    | 워크스페이스 안의 이미지와 PDF를 읽어 확인합니다.                       |
| 지식 베이스 검색 | 등록된 코드베이스와 사양 파일을 시맨틱 검색합니다.                        |
| 파일 버전     | 업로드된 파일의 모든 버전을 목록으로 표시합니다.                         |
| URL 가져오기  | 공개 URL에서 데이터를 가져옵니다.                                |
| 동영상 분석    | 업로드된 동영상의 내용을 확인하여 요약합니다.                           |
| 원격 머신     | 사용자가 SSH로 연결한 실제 머신에서 명령을 실행합니다.                    |
| 샌드박스      | 일회용 프라이빗 샌드박스 환경에서 명령을 실행하고 결과를 확인합니다.              |

{% hint style="info" %}
원격 머신과 샌드박스는 조직 단위로 활성화된 경우에만 사용할 수 있습니다. **설정 > 원격 머신**이 표시되지 않거나 실행 도구에 **샌드박스**가 표시되지 않으면 Autify 지원 담당자에게 문의하세요.
{% endhint %}

## 조건에 따라 자동 부여되는 도구

일부 도구는 개별적으로 선택하지 않아도 자동으로 사용할 수 있게 됩니다.

* **파일 읽기** 등의 파일 계열 도구는 항상 자동으로 부여됩니다.
* **이미지 생성**은 조직에서 Google 프로바이더를 사용할 수 있는 경우에 AI 어시스턴트에서만 부여됩니다.
* **GitHub 도구**는 **리소스 및 컨텍스트 > 코드베이스**에서 GitHub를 연결하면 사용할 수 있습니다.
* **Slack 도구**는 조직에서 Slack을 연결하고 워크스페이스에 사용할 수 있는 채널을 연결하면 사용할 수 있습니다. **Slack 채널 연결**, **Slack 채널 목록 가져오기**, **Slack 스레드 읽기**, **Slack 파일 가져오기**, **Slack 메시지 보내기** 등이 포함되며, 답장과 파일 전송도 의도한 Slack 스레드 안에 유지됩니다. 사용자가 명시적으로 요청한 경우에는 보낸 사람 이름과 아이콘도 지정할 수 있습니다. 보낸 사람을 사용자 지정하려면 Slack을 다시 연결하여 권한을 업데이트해야 합니다.
* **파일을 Google Sheets에 쓰기**는 편집 가능한 Google 스프레드시트가 워크스페이스에 연결되어 있으면 자동으로 추가됩니다. 저장된 파일의 JSON, CSV, TSV 또는 XLSX 표 형식 데이터를 쓸 수 있습니다. 샌드박스가 활성화된 실행에서는 샌드박스 파일도 사용할 수 있습니다.
* 워크플로의 AI 에이전트 블록에서는 연결된 채널의 스레드를 메시지 URL 또는 채널 ID와 부모 메시지 타임스탬프로 읽을 수 있습니다. 채널 기록은 날짜 범위를 지정해 읽을 수 있습니다. 결과가 페이지로 나뉘면 반환된 계속 커서로 나머지 메시지를 가져오십시오.
* 워크플로의 **AI 에이전트** 블록에서는 실행 컨텍스트와 권한에 따라 워크스페이스의 워크플로우, 파일, 사양서, 폴더, 스페이스를 확인하는 읽기 전용 쿼리 도구가 자동으로 부여될 수 있습니다.
* **Aximo 도구**는 워크스페이스에 Aximo 연결이 설정되어 있으면 사용할 수 있습니다.
* **스페이스 도구**는 조직에서 **스페이스**를 사용할 수 있는 경우에 부여됩니다. 스페이스와 컬렉션을 생성·업데이트하고 행 키워드 검색(**항목 검색**)을 수행하는 것 외에도 보드를 확인·설정하고, 기본 보기 조건을 저장하며, 카드를 이동할 수 있습니다.

## 사용자 지정 MCP 서버

외부 MCP 연결은 워크스페이스 페이지의 **리소스 및 컨텍스트 > 연동**에서 등록합니다.

| 이용 위치            | 이용 방법                                                                   |
| ---------------- | ----------------------------------------------------------------------- |
| AI 어시스턴트(채팅)     | 채팅에서는 항상 사용할 수 있는 도구와 함께 MCP 도구 카탈로그가 표시되며, 필요한 MCP 도구만 나중에 불러올 수 있습니다. |
| 워크플로의 AI 에이전트 블록 | 블록의 **MCP 서버** 탭에서 사용할 연결을 추가합니다.                                       |

채팅에서는 `load_mcp_tools` 를 사용해 서버 이름, 검색 키워드, 도구 이름 또는 이들을 조합한 조건으로 필요한 도구를 불러올 수 있습니다.

{% hint style="info" %}
워크스페이스 단위의 MCP 연결을 등록·관리하는 절차는 [연동](/features-ko/resources-context/integrations.md) 참조.
{% endhint %}