> ## 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.

> 도구 수정 — 기존 도구의 Name·Access·Args·환경변수 등 변경. Transport 는 변경 불가

# Tool update

# 도구 수정

**경로**: [도구 목록](/console/agent-ops/agent-tool/tool-list) 또는 [도구 상세](/console/agent-ops/agent-tool/tool-detail) → **Edit**

**화면 제목**: `Edit Agent Tool - {tool-name}`

기존에 등록된 도구의 설정을 수정합니다. 생성 페이지와 비슷한 구성이지만 **Transport 는 변경 불가** 하며, 연결된 에이전트에 영향을 주는 필드는 변경 시 세션 영향을 고려해야 합니다.

## 수정 가능 / 불가 매트릭스

| 항목                                                          | 수정 가능?   | 비고                                                                                  |
| ----------------------------------------------------------- | -------- | ----------------------------------------------------------------------------------- |
| **Name**                                                    | ✓        | 변경 시 에이전트 쪽 참조도 자동 갱신                                                               |
| **Description**                                             | ✓        | —                                                                                   |
| **Transport**                                               | ✗ **불가** | 생성 시 선택한 `Standard I/O` 또는 `Streamable HTTP` 가 고정 — 전환하려면 **새 도구로 재등록**             |
| **Access** (Private/Public)                                 | ✓        | Public → Private 전환 시 접근하던 다른 에이전트에 영향                                              |
| **Run Settings** (stdio) — Command · Args                   | ✓        | Command/Args 변경은 서버 기동 영향 큼 — 반드시 Test                                              |
| **Connection Settings** (HTTP) — URL · Timeout · Verify SSL | ✓        | URL 변경은 완전히 다른 서버로 전환됨 — 영향 분석 필수                                                   |
| **Environment Variables** — User Input 값                    | ✓        | 자격 증명 로테이션 용도로 빈번                                                                   |
| **Environment Variables** — System Default 값                | ✗        | 이 화면에서 변경 불가. [Environment](/internal/system-admin/settings/environment) 에서 운영자가 갱신 |
| **Add Environment Variable** — 신규 추가                        | ✓        | User Input · System Default 둘 다 가능                                                  |
| **Headers** (HTTP 전용)                                       | ✓        | 인증 토큰·경로 변경                                                                         |

<Warning>
  **Transport 는 수정 화면에서 변경 불가** 입니다. 예를 들어 stdio 로 등록한 도구를 HTTP 로 바꾸려면 기존 도구를 **삭제하고 새로 등록** 해야 합니다. 삭제 전 연결된 에이전트 영향은 [도구 삭제](/console/agent-ops/agent-tool/tool-delete) 참고.
</Warning>

## 절차

<Steps>
  <Step title="Edit 진입">
    [도구 목록](/console/agent-ops/agent-tool/tool-list) 또는 [상세](/console/agent-ops/agent-tool/tool-detail) 에서 **Edit** 버튼 클릭. 기존 값이 미리 채워진 폼이 열립니다.
  </Step>

  <Step title="값 변경">
    필요한 필드만 수정. System Default 항목은 편집 불가 (잠긴 상태로 표시).
  </Step>

  <Step title="Test 검증">
    저장 전 [도구 상세](/console/agent-ops/agent-tool/tool-detail) 의 **Test** 로 핸드셰이크·`list_tools` 응답이 정상인지 확인 (특히 Command/URL/Args 를 바꾼 경우).
  </Step>

  <Step title="Save">
    **Save** 클릭 → 변경 즉시 적용. 연결된 에이전트의 진행 중 호출은 다음 호출부터 영향.
  </Step>
</Steps>

## 운영 주의

<Warning>
  **운영 중인 에이전트·Flow·Scheduler 에 영향**

  * 도구를 수정하면 해당 도구를 사용하는 **모든 에이전트·Flow 노드·Scheduler·Skill** 의 다음 호출이 즉시 영향을 받습니다.
  * Command 또는 URL 을 잘못 바꾸면 관련 자동화가 일제히 실패할 수 있으니, 저장 전 **Test 검증 + 사전 공지** 를 권장합니다.
  * 실패 시 이전 값으로 되돌리려면 **다시 Edit 해서 복원** 해야 합니다 (자동 롤백 없음).
</Warning>

<Warning>
  * **이름 변경** — 에이전트 쪽 참조는 자동 갱신되지만, 사용자 메모·Skill 의 `tools_required`·외부 스크립트에 박힌 도구 이름은 수동 업데이트 필요.
  * **Env 필수 키 삭제** — 기존 호출이 해당 변수에 의존 중이면 즉시 실패 가능. 삭제 전 사용 여부 확인.
  * **Access Public → Private** — 현재 접근 중인 다른 에이전트가 다음 호출부터 접근 거부됨.
  * **System Default 값 변경이 필요하면** [Environment](/internal/system-admin/settings/environment) 에서 운영자가 처리 — 본 화면에서는 불가.
</Warning>

## 관련 문서

* [도구 상세](/console/agent-ops/agent-tool/tool-detail) — Test·호출 로그
* [도구 목록](/console/agent-ops/agent-tool/tool-list) — Actions → Edit / Delete
* [도구 삭제](/console/agent-ops/agent-tool/tool-delete) — Transport 변경 등 재등록이 필요한 경우
* [Environment (운영자)](/internal/system-admin/settings/environment) — System Default 값 관리