Toolsets

도구 모음은 관련 도구의 이름 있는 그룹입니다. 프로필/세션 그룹 선택과 상위 접근 한도가 적격 인벤토리를 결정합니다. 세션은 모델 선언 도구와 Codemode 호출 도구를 따로 선택합니다.

기본 제공 기본값

기본 표시 그룹:

도구 모음	일반 기능
artifact	세션 파일 목록·확인·고정·내보내기
web	공개 웹 검색·가져오기
sessions	이전 프로필 세션 검색
memory	프로필 메모리 작업
tasks, automation	작업, 알림, 예약 실행
clarify	입력 누락 시 구조화 질문
file, terminal	파일 접근·직접 명령 실행
messaging	채널 인식 메시징
skills	프로필 스킬 관리. 읽기는 read/bash
subagents	위임, 백그라운드, 하위 제어
tts	TTS 구성 시 음성 응답

적격 제품 그룹이며 매 세션 모든 도구 활성 보장이 아닙니다. 이식 가능한 기본 활성 이름은 read, bash, edit, write이며 제품 도구가 기본 활성 항목을 더할 수 있습니다. 런타임에 더 많은 그룹이 있을 수 있고 자격 증명·백엔드가 제한할 수 있습니다.

카탈로그 확인

Dashboard → Tools → Built-in은 출처, 모음, 네이티브 정의, 런타임 제한을 보여 줍니다. 행을 열면 정의, 제한 시간, 출력 예산을 봅니다. 인벤토리이며 현재 세션 활성 선언이 아닙니다. 정의는 읽기 전용입니다. Codemode는 프로필 기본값과 명시적 세션의 전용 설정이 있으며 일반 도구별 재정의 편집기가 아닙니다.

Dashboard에는 일반적인 ‘모든 기본 모음 토글’ 편집기가 없습니다. 지원 선택 기능이 제품 그룹을 갱신합니다. MCP 구성은 독립적입니다.

세션 도구 선택

대화 도구 플래그로 바꿉니다.

anyy --tools '+codemode,+tool_search'
anyy --resume SESSION_ID --tools '+codemode,+tool_search'
anyy chat --session SESSION_ID --tools 'read,bash' "Inspect the project"

새 세션은 프로필 기본값과 제공 플래그로 시작합니다. +name, -name은 재개 세션 현재 활성 집합이 아닌 기본값을 바꿉니다. 위 --resume 예는 대기 입력 없는 유휴 기존 세션에도 Codemode를 켤 수 있으므로 새 세션이 필수는 아닙니다. 재정의가 없으면 실시간 세션은 현재 선택을 유지합니다. 다른 활성 이름·규칙을 보존하며 Codemode만 바꾸려면 CLI 재적용 대신 Dashboard를 쓰세요.

플래그 규칙은 실시간 세션에 남으며 프로필 config.yaml을 바꾸거나 Gateway 재시작 후 유지되지 않습니다. 이전 기록 활성 이름은 현재 프로필 규칙 아래 선택 분기에서 복원될 수 있습니다. 같은 포함·제외·도구 없음 규칙이 필요하면 유휴 연결에서 명시하세요.

도구 선택은 상위, 행위자/세션, 전달 범위를 넓히지 않습니다. 이전 저장 스키마/이름은 과거 증거이며 새 등록·재정의 핸들을 막는 중복 게이트가 아닙니다.

Codemode와 도구 검색

codemode는 현재 호출 가능 도구로 원시 JavaScript를 실행합니다. tool_search는 비활성 codemode/deferred 도구를 찾아 다음 모델 요청에 활성화합니다. 둘 다 기본 비활성 등록이며 명시적 선택이나 해당 MCP 자동 활성화로 켤 수 있습니다. 서로 독립적이며 Codemode 변경은 도구 검색이나 역할을 바꾸지 않습니다.

Dashboard → Tools → Built-in → codemode에서 기본값과 공유 on/only 모드를 저장합니다. 재시작 없이 다음 준비에 게시하지만 기존 세션을 다시 선택하지는 않습니다. 세션을 별도로 고르고 대기 입력 없는 유휴 상태에서 Apply to Session을 쓰세요. 제한과 두 작업 차이는 설정을 참조하세요.

프로필 config.yaml 수동 편집 예:

default_tools:
  - "+codemode"
  - "+tool_search"
codemode:
  mode: on

codemode.mode는 이미 활성 세션의 표현을 제어하며 활성 스위치가 아닙니다. on은 직접 선언 유지, only는 요청의 호출 가능 직접 선언을 숨깁니다. 도구는 Codemode에서 계속 가능하고 표준 선언도 기록됩니다. 전용 CLI 플래그·역할 설정은 없습니다.

수동 편집 후 Gateway 재시작이나 설정 페이지 명시적 저장으로 게시하세요. 공급자 다시 로드는 도구 설정을 게시하지 않습니다. 페이지는 미적용 저장값을 구분합니다. 공유 모드 변경은 다음 준비에 적용되며 프로필 기본 활성 변경은 기존 세션 선택을 유지합니다. 세션 Apply는 현재 규칙 아래 Codemode만 바꾸므로 제한 세션은 기본값이 켜져도 거부할 수 있습니다.

도구 노출과 제품 그룹은 별개입니다.

노출	세션 동작
direct	활성 시 호출 가능, 보통 직접 선언
codemode, deferred	직접 선언 없이 등록 인벤토리에서 호출 가능
model-only	선언 가능하지만 스크립트 호출 불가
hidden	선언·호출 모두 불가

활성 MCP 서버는 exposure와 순서 있는 toolExposure로 네이티브 도구를 제공합니다. mcp-NAME 제품 모음이나 include 활성 게이트는 필요 없습니다. 해당 MCP 설정은 Codemode를 자동 켤 수 있지만 명시적 제외가 우선입니다. Codemode가 꺼져도 허용 활성 검색은 간접 MCP를 찾을 수 있습니다. MCP 서버를 참조하세요.

샌드박스는 첫 실행에 로드됩니다. 제한 시간에 로드·VM 시작도 포함됩니다. 컴파일 코드는 Anyy 프로세스 안에서 재사용할 수 있지만 실행마다 자체 VM·전역이 있습니다. 로드 실패는 나중 호출이 재시도할 수 있으며 로드 호출 취소가 다른 호출 로드를 취소하지 않습니다. Node.js 설치는 불필요합니다.

성공 저장값은 선택 분기에 속하고 DB 재열기 후 읽을 수 있습니다. 제한 시간 초과 스크립트는 부분 출력·오류를 유지하고 준비 값 변경을 버립니다. 축소 출력의 전체 경로는 나중에 read의 offset·limit로 읽습니다. 실패가 완료 도구 효과를 롤백하지는 않습니다. API·제한·예는 Codemode, 검색 입력은 도구 검색을 참조하세요.

세션과 스킬

세션은 명시적 모음 선택을 가질 수 있습니다. 현재 구현에서 프로필 기본값을 쓰는 세션은 활성 스킬이 추가 그룹을 요청할 수 있습니다. 명시적 턴 선택이나 의도적으로 좁힌 세션 선택이 우선입니다. 하위는 상위 접근을 넓힐 수 없습니다.

턴에 첨부가 있으면 범위 파일 접근을 위해 해당 턴에 artifact 그룹을 추가할 수 있습니다.

도구 가용성

활성 도구는 직접 실행합니다. 자격 증명, 운영체제 권한, 백엔드 상태, 세션 범위가 사용 가능 여부를 결정합니다. 모음은 모델 카탈로그를 정리합니다.

문제 해결

증상	확인 사항
구성 도구가 안 보임	적격 제품 그룹, 노출, 세션 선택
MCP 연결됐지만 도구 없음	서버 활성·노출과 Codemode·검색 활성
하위에 도구 없음	상위 카탈로그나 하위 정책이 허용 안 함
호출 실패	결과, 자격 증명, 운영체제 권한, 백엔드 상태