Web Tools

에이전트가 실시간 웹 검색과 페이지 가져오기를 통해 최신 정보를 활용할 수 있도록 해 주는 내장 도구 모음입니다.

개요

Web Tools는 Kiro 에이전트가 학습 시점 이후에 변경된 정보를 보완하기 위해 인터넷에서 직접 자료를 가져오는 기능입니다. 모델이 알고 있지 않은 최신 라이브러리 버전, 문서 변경 사항, 시세나 날짜처럼 시간에 민감한 주제에 답할 때 특히 유용합니다. 단, 검색 결과는 시점에 따라 달라질 수 있고, 페이월·로그인·접근 제한이 걸린 페이지는 가져올 수 없도록 설계되어 있습니다. 또한 응답이 원문을 그대로 길게 옮겨오지 않도록 의미 있는 분량의 텍스트 재현은 차단됩니다.

제공되는 도구

두 가지 도구가 기본으로 노출됩니다.

web_search — 키워드로 웹을 검색해 후보 결과를 가져옵니다.
web_fetch — 지정한 URL에서 페이지 본문을 직접 읽어옵니다.

예를 들어 사용자가 어떤 라이브러리의 최신 동작을 물으면, 에이전트는 먼저 web_search로 관련 페이지를 찾고, 적합한 링크를 선택해 web_fetch로 본문을 받아본 뒤 답변에 반영합니다.

인용과 사용자 책임

웹에서 가져온 근거(grounded) 정보가 답변에 포함되면, 출처 링크나 인용이 함께 표시됩니다. 그 결과물을 다른 사용자에게 다시 보여줄 때는 인용과 링크를 그대로 유지해야 합니다. 인용은 원문 페이지로의 추적성을 보장하는 핵심 장치입니다.

특정 에이전트가 웹 도구를 사용하지 않도록 만들고 싶다면, 커스텀 에이전트의 tools 필드에서 해당 도구를 제외하도록 설정하면 됩니다.

제한 사항

web_fetch는 안전한 사용을 위해 다음과 같은 제약을 둡니다.

한 페이지당 최대 10MB까지 가져옵니다.
요청 타임아웃은 30초입니다.
리디렉션은 최대 10회까지 따라갑니다.
text/html 형식의 페이지만 지원합니다.
실패 시 자동으로 최대 3회 재시도합니다.

조직 단위 거버넌스

IAM Identity Center로 로그인하는 Pro 등급 고객은 조직 전체에서 웹 도구 사용 여부를 관리할 수 있습니다. 기본값은 사용 설정(on)이지만, 관리자가 AWS 콘솔에서 일괄로 끌 수 있습니다.

이 제어는 클라이언트 측에서 적용됩니다. 즉, 최종 사용자가 우회할 가능성이 존재한다는 점을 인지하고 운용 정책을 함께 마련하는 것이 좋습니다.

조직 전체에서 끄는 방법

계정이나 조직에 속한 모든 Kiro IDE 사용자에 대해 web_fetch와 web_search를 동시에 비활성화하려면 다음 절차를 따르세요.

Kiro 콘솔을 엽니다.
좌측 메뉴에서 Settings로 이동합니다.
Shared settings 영역의 Web search and web fetch tools 토글을 Off로 변경합니다.

설정이 적용되면 해당 조직에 속한 사용자는 더 이상 두 도구를 호출할 수 없게 됩니다.