Skip to main content

​
도구 수정

경로: 도구 목록 또는 도구 상세 → Edit 화면 제목: Edit Agent Tool - {tool-name} 기존에 등록된 도구의 설정을 수정합니다. 생성 페이지와 비슷한 구성이지만 Transport 는 변경 불가 하며, 연결된 에이전트에 영향을 주는 필드는 변경 시 세션 영향을 고려해야 합니다.

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

Transport 는 수정 화면에서 변경 불가 입니다. 예를 들어 stdio 로 등록한 도구를 HTTP 로 바꾸려면 기존 도구를 삭제하고 새로 등록 해야 합니다. 삭제 전 연결된 에이전트 영향은 도구 삭제 참고.

​
절차

1

Edit 진입

도구 목록 또는 상세 에서 Edit 버튼 클릭. 기존 값이 미리 채워진 폼이 열립니다.
2

값 변경

필요한 필드만 수정. System Default 항목은 편집 불가 (잠긴 상태로 표시).
3

Test 검증

저장 전 도구 상세 의 Test 로 핸드셰이크·list_tools 응답이 정상인지 확인 (특히 Command/URL/Args 를 바꾼 경우).
4

Save

Save 클릭 → 변경 즉시 적용. 연결된 에이전트의 진행 중 호출은 다음 호출부터 영향.

​
운영 주의

운영 중인 에이전트·Flow·Scheduler 에 영향
  • 도구를 수정하면 해당 도구를 사용하는 모든 에이전트·Flow 노드·Scheduler·Skill 의 다음 호출이 즉시 영향을 받습니다.
  • Command 또는 URL 을 잘못 바꾸면 관련 자동화가 일제히 실패할 수 있으니, 저장 전 Test 검증 + 사전 공지 를 권장합니다.
  • 실패 시 이전 값으로 되돌리려면 다시 Edit 해서 복원 해야 합니다 (자동 롤백 없음).
  • 이름 변경 — 에이전트 쪽 참조는 자동 갱신되지만, 사용자 메모·Skill 의 tools_required·외부 스크립트에 박힌 도구 이름은 수동 업데이트 필요.
  • Env 필수 키 삭제 — 기존 호출이 해당 변수에 의존 중이면 즉시 실패 가능. 삭제 전 사용 여부 확인.
  • Access Public → Private — 현재 접근 중인 다른 에이전트가 다음 호출부터 접근 거부됨.
  • System Default 값 변경이 필요하면 Environment 에서 운영자가 처리 — 본 화면에서는 불가.

​
관련 문서