Skip to main content

​
도구 수정

경로: 도구 목록 또는 도구 상세 → 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 에서 운영자가 갱신
Add Environment Variable — 신규 추가✓User Input · System Default 둘 다 가능
Headers (HTTP 전용)✓인증 토큰·경로 변경
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 에서 운영자가 처리 — 본 화면에서는 불가.

​
관련 문서