도구 검색

tool_search는 지연/Codemode 노출로 등록되었으나 현재 선언에 활성화되지 않은 적격 도구를 찾게 합니다. 매 요청에 모든 스키마를 넣지 않고 간접 카탈로그를 유지합니다. 검색은 일치 도구를 실행하지 않습니다.

검색 활성화

tool_search는 기본 비활성 등록입니다. 예를 들어 명시적으로 선택합니다.

anyy --tools '+tool_search'
anyy --resume SESSION_ID --tools '+codemode,+tool_search'

기존 세션의 명시적 선택 변경은 대기 입력 없는 유휴 상태여야 합니다. + 규칙은 프로필 기본값에서 시작하며 구성 기록이나 재개 세션 활성 목록의 증분 편집이 아닙니다. 대화 도구 선택을 참조하세요.

MCP 지연 노출도 현재 선택 규칙에 따라 자동 활성화할 수 있습니다. 명시적 제외와 상위 제한이 우선합니다. Codemode와 도구 검색은 독립적이므로 Codemode를 꺼도 허용된 활성 tool_search는 꺼지지 않습니다. 별도 Dashboard 구성 양식은 없습니다.

결과 검색과 사용

필요 기능을 요청하세요. 예:

Find the configured documentation-search tool. Inspect its inputs, then use it to find the release notes.

모델 도구 입력:

{"query":"documentation search","limit":3}

query는 필수 비공백 문자열입니다. limit는 선택 양수 정수이며 기본 8입니다. 이름, 설명, 입력 스키마, 네임스페이스 메타데이터로 적격 카탈로그 순위를 매깁니다. 구체 작업 단어나 서버 이름을 쓰세요. 일치 도구 없음도 정상 결과입니다.

일치 비활성 도구는 기존 이름을 유지하며 세션 활성 이름에 추가됩니다. 결과는 로드 도구를 식별하고 details.loaded에도 담습니다. 선언은 검색 결과가 루프로 돌아온 뒤 다음 모델 요청에서 사용 가능합니다. 이미 준비한 요청에 새 스키마를 제자리 추가하지 않습니다. 이후 모델은 반환 선언으로 유효 호출을 할 수 있으며 일반 범위·인증·검증은 계속 적용됩니다.

비활성 지연/Codemode 도구만 검색합니다. 활성, 직접 전용, 숨김, 모델 전용 선언은 제외됩니다. 비활성 서버 부활, 미등록 도구 생성, 상위 접근 확장은 불가능합니다. 서버가 구성되어도 사용 가능한 실시간 카탈로그가 아직 없을 수 있으니 관련 결과가 없으면 연결을 확인하세요.

Codemode와의 관계

방식	변경 사항
모델 tool_search	다음 요청의 활성 선언으로 일치 항목 로드
Codemode searchTools(query, options)	선언 활성화 없이 현재 스크립트 호출 스냅샷 검색
Codemode describeTool(name)	호출 없이 현재 선언 하나 읽기

따라서 호출 가능 MCP 도구는 먼저 직접 모델 선언이 되지 않고 Codemode에서 쓸 수 있습니다. 원격 이름이 정리되거나 충돌 접미사를 받을 수 있으니 발견된 이름·스키마를 사용하세요. Codemode와 MCP 노출을 참조하세요.

검색 결과가 없을 때

같은 프로필, 서버 활성·준비, exposure/순서 있는 toolExposure, 현재 세션 제외, 상위 제한을 확인하세요. 이미 활성 도구는 다시 검색하지 말고 기존 선언으로 호출합니다. 숨김 도구는 의도적인 구성 변경이 필요하며 검색어 변경으로 노출되지 않습니다.