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

> 도구 삭제 — 연결된 모든 에이전트의 해당 도구 호출이 즉시 실패. 삭제 전 영향 범위 확인 필수

# Tool delete

# 도구 삭제

**경로**: Tool Management → 목록 또는 상세 → **🗑 삭제**

도구를 영구 제거합니다. **이 도구를 연결한 모든 에이전트는 즉시 해당 도구 호출이 실패** 하므로 사전 영향 분석이 필수입니다.

<Warning>
  **삭제 전 반드시 확인**

  * 이 도구를 사용하는 **에이전트 목록** ([도구 상세](/console/agent-ops/agent-tool/tool-detail) 의 Connected Agents 섹션)
  * 해당 에이전트들이 도구 없이도 동작 가능한지 (자동화·Slack 봇 등 의존도)
  * 도구 삭제 후 **자동 대체될 수 없으며**, 같은 이름으로 재생성해도 에이전트의 도구 매핑은 자동 복구되지 않습니다.
</Warning>

## 삭제 시 발생하는 일

| 영향 범위                       | 결과                                                                                                            |
| --------------------------- | ------------------------------------------------------------------------------------------------------------- |
| **연결 에이전트의 Tool 호출**        | 해당 도구 메서드 호출 시 즉시 에러 — 답변 실패 또는 부분 실패                                                                         |
| **활성 Flow / Scheduler**     | 이 도구를 호출하는 [Flow](/agent-chat/toolbar/flow-studio) 와 [Schedule](/agent-chat/user-menu/scheduler) 은 다음 실행부터 실패 |
| **Slack 리스너 / Webhook 자동화** | Slack 봇 답변·자동 알림 등이 도중에 끊어질 수 있음                                                                              |
| **에이전트 설정**                 | 각 에이전트의 Tools 탭 체크는 **자동 해제** 됨                                                                               |
| **호출 로그 / 감사 이력**           | 과거 호출 기록은 유지 (감사 목적)                                                                                          |
| **자격 증명 (PAT·Bot Token)**   | 삭제와 함께 Seahorse 측에서 제거 — 외부 서비스의 토큰 자체는 별도로 폐기 권장                                                             |

## 절차

<Steps>
  <Step title="영향 분석">
    [도구 상세](/console/agent-ops/agent-tool/tool-detail) → **Connected Agents** 섹션에서 사용 중인 에이전트 확인. 운영 중인 자동화가 있으면 사전 공지·대체 방안 마련.
  </Step>

  <Step title="일시 비활성 권장 (선택)">
    즉시 삭제 대신 **Private 로 전환** 또는 에이전트의 Tools 탭에서 **체크 해제** 로 1\~2 일 영향 모니터링 후 삭제 결정.
  </Step>

  <Step title="삭제 다이얼로그">
    목록 또는 상세에서 **🗑 삭제** → 확인 다이얼로그에서 도구 이름 재입력 또는 체크.
  </Step>

  <Step title="확인 후 삭제">
    **\[삭제 확인]** 클릭. 도구 레코드 즉시 제거 + 모든 에이전트의 연결 자동 해제.
  </Step>

  <Step title="외부 자격 증명 회수">
    GitHub PAT / Slack Bot Token / DB 사용자 등 외부 서비스에 발급한 자격 증명은 **별도로 폐기** 하세요. Seahorse 에서 도구를 지워도 외부 토큰은 살아 있습니다.
  </Step>
</Steps>

<Warning>
  **대안: 일시 비활성화**
  삭제 대신 다음을 고려하세요.

  * **Private 전환** — 다른 에이전트가 새로 연결하지 못하도록 차단
  * **에이전트 Tools 탭에서 체크 해제** — 도구는 유지하고 특정 에이전트만 사용 중단
  * **자격 증명만 무효화** — 외부 토큰을 폐기하면 도구는 남되 호출은 실패하므로, 잠시 끊어두고 영향 관찰 가능
</Warning>

<Info>
  삭제 후 같은 이름으로 도구를 다시 만들어도, 각 에이전트의 Tools 탭에서 **수동으로 다시 체크** 해야 연결됩니다. 이전 매핑은 복원되지 않습니다.
</Info>

## 관련 문서

* [도구 상세](/console/agent-ops/agent-tool/tool-detail) — Connected Agents 확인
* [도구 목록](/console/agent-ops/agent-tool/tool-list)
* [Tool Management 개요](/console/agent-ops/agent-tool)
* [Agent 수정 — Tools 탭](/console/agent-ops/agent/agent-update)