VIBECODING 365 / DICTIONARY

호스티드 툴

Hosted Tools

중급 난이도: 중급태그: hosted tools · nw_ · agent

DEFINITION

호스티드 툴은 Neuralwatt 게이트웨이가 요청 안에서 모델 대신 실행하는 서버 쪽 도구다. 개요는 모델이 원래 들고 오지 않은 능력을, 그 요청 안에서 해결한다고 적는다. 문서는 Preview다. 페이지는 누구나 읽지만, 쓰려면 등록을 요청하고 승인되면 대시보드에 스위치가 생긴다. 형태와 한도, 가격은 일반 제공 전에 바뀔 수 있다. 오픈웨이트 모델은 텍스트 생성만 들고 오는 경우가 많고, 그 밖의 일은 보통 클라이언트가 만든다. 호스티드 툴은 그중 작은 묶음을 게이트웨이 쪽에서 모델에게 건넨다.

왕복이 클라이언트로 안 온다

일반 툴 호출은 모델이 멈추고 클라이언트가 함수를 실행한 뒤 두 번째 요청으로 결과를 넣는다. 호스티드 툴은 클라이언트에 도달하지 않는다. 게이트웨이가 도구를 제안하고 호출을 보고 실행한 뒤, 결과를 모델에 돌려 같은 응답 안에서 생성을 이어 간다. 클라이언트에 도착하는 것은 끝난 답이다. 문서의 JSON은 클라이언트가 파싱할 스키마가 아니라, 모델이 무엇을 묻고 무엇을 받는지 공개한 것이다. 이름은 모두 nw_로 시작해 예약되어 있어, 직접 선언한 툴과 이름이 겹치지 않는다. 자체 툴과 나란히 쓸 수 있다.

스위치가 켜져야 주입된다

도구마다 API Keys and Allowances에 스위치가 있고 마스터 스위치는 없다. 기본은 전부 꺼짐이다. 프리뷰 승인은 스위치만 보여 주고 켜 주지는 않는다. 새 세션부터 적용되며, 진행 중인 대화의 프롬프트와 캐시를 깨지 않는다. 요청의 tools 배열에 이름을 넣으면 대시보드와 무관하게 쓸 수 있고, X-NW-Tools-Opt-Out을 true로 두면 그 요청에서 전부 끈다. 키별 오버라이드는 프리뷰에 아직 없다. 호출 중인 모델이 공개한 도구만 나타나며, 유료 플랜이 없으면 유료 도구는 켜는 칸 대신 업그레이드 링크가 보인다. 프리뷰 메인라인은 GLM-5.2와 5.3 계열, Kimi-K3, Kimi-K2.7-Code, DeepSeek-V4-Flash, Qwen3.6-35B, Gemma-4-31B이고, fast와 옛 리다이렉트 별칭은 빠진다. 비전 모델은 look을 받지 않는다. 모델 목록의 hosted_tools 플래그로 확인한다.

천장과 한 장의 영수증

요청 metadata의 hosted_tools_budget에 달러 천장과 와트시 천장을 둘 수 있다. 둘 다 선택이고, 도구가 만드는 하위 요청만 묶는다. 본인 답은 max_tokens다. 잘못된 예산은 400이다. 천장은 이미 도는 일을 끊지 않고 다음에 시작할지를 막는다. check_budget은 천장에 막히지 않는다. 프리뷰에서 열리는 넷은 예산 확인, 다른 모델 자문, 비전 위임, 웹 검색이다. spawn_subagents는 문서만 있고 프리뷰에서 호출할 수 없다. consult와 look은 대상 모델 정상 요금이고 툴 마크업이 없다. web_search는 플랜 기간 허용량이며 건당 과금이 아니다. check_budget은 무료다. consult는 최대 120초, spawn은 300초를 문서로 적는다. 검색은 페이지를 가져오지 않고 제목과 링크, 스니펫만 준다. 쿼리는 Brave Search로 가며, 세션에 비밀을 둔 채 검색을 켜지 말라고 경고한다. 하위 요청은 사용량 기록으로 원 요청에 묶여 한 턴의 영수증이 된다.

ENGLISH

Hosted Tools

EXAMPLE

대시보드에서 nw_web_search를 켠 뒤, hosted_tools를 지원하는 모델로 요청하면 게이트웨이가 검색을 수행한다. 요청 metadata의 hosted_tools_budget으로 달러·와트시 천장을 둘 수 있다.

REFERENCE

docs.neuralwatt.com/hosted-tools/overview