도구
도구는 작업 중 Anyy가 호출할 수 있는 기능입니다. 기본 제공 작업, MCP 도구, 웹 검색, 미디어 백엔드가 포함됩니다.
Dashboard → Tools에서 선택 프로필이 세션에 노출할 수 있는 항목을 확인하세요.
도구 분류
| 분류 | 관리 대상 |
|---|---|
| Built-in | 로컬 도구 정의와 Codemode 설정 |
| MCP | 활성 MCP 서버에서 현재 구체화된 도구 |
| Image | 이미지 이해·생성 모델 경로 |
| Video | 동영상 이해 모델 경로 |
| Voice | 텍스트 음성 변환·음성 텍스트 변환 경로 |
| Web Search | 최신 공개 정보 검색 백엔드 |
도구 확인
기본 제공 또는 MCP 도구를 선택해 다음을 봅니다.
- 출처와 도구 모음.
- 설명과 입력 스키마.
- 제한 시간.
- 표시 및 저장 출력 예산.
입력 스키마는 Anyy의 도구 호출 계약입니다. MCP 정의는 실시간 서버 카탈로그에서 옵니다. MCP에서 노출할 원격 도구를 관리하세요.
런타임 정보
상세 페이지에는 현재 제한 시간과 표시/저장 출력 예산이 나타납니다. 도구 설명, 스키마, 자원 설정은 이 페이지에서 읽기 전용입니다. 정의는 도구 구현이나 MCP 서버 카탈로그에서 옵니다. 기능 백엔드, MCP 선택, Toolsets로 가시성을 구성하세요.
Codemode 설정
Tools → Built-in → codemode를 여세요. Codemode는 모델이 JavaScript로 세션의 사용 가능 도구를 호출하게 합니다. 설정에는 별도 범위 두 가지가 있습니다.
프로필 기본값
활성 설정과 공유 호출 모드를 고른 뒤 Save를 선택합니다.
| 활성화 | 효과 |
|---|---|
| Use current tool selection | 기존 선택과 MCP 자동 활성화 규칙을 따름. 비활성이라는 뜻이 아님 |
| Enable | 다른 도구를 켜지 않고 새 세션 기본값에 Codemode 추가 |
| Disable | 새 세션 기본값에서 Codemode 명시적 제외 |
| 모드 | Codemode 활성 시 |
|---|---|
| Direct calls and scripts (on) | 스크립트와 직접 도구 항목을 함께 유지 |
| Concentrate calls in scripts (only) | 스크립트 호출 가능한 직접 항목 숨김. 해당 도구는 Codemode로 계속 사용 가능 |
모드는 프로필이 공유하며 다음 준비에 적용됩니다. 이미 준비한 요청은 바꾸지 않습니다. 활성 기본값 저장은 기존 세션의 도구를 다시 선택하지 않습니다. 페이지는 Applied 또는 Saved, not yet applied를 보고합니다. 외부 구성 편집 후 여기서 명시적으로 저장하거나 Gateway를 다시 시작하세요. 공급자 다시 로드는 도구 설정을 적용하지 않습니다.
다른 도구 규칙과 더 넓은 제외는 유지됩니다. Codemode만 바꾸는 작업이 다른 도구 규칙도 바꾸면 저장을 거부하고 원래 구성을 보존합니다. 이 페이지는 Codemode를 역할로 만들거나 일반 도구 정의를 편집하지 않습니다.
기존 세션
- Session override에서 세션을 선택해 상태를 봅니다.
- 대기 입력 없는 유휴 상태에서 Enable 또는 Disable을 선택합니다.
- Apply to Session을 선택해 반환 상태를 확인합니다.
세션의 다른 활성 도구와 선택 규칙을 보존하며 Codemode만 바꿉니다. 세션 허용 도구 목록을 확장할 수 없으므로 프로필 기본값이 활성이어도 오래된 제한 세션은 켤 수 없을 수 있습니다. 바쁜 세션은 먼저 유휴 상태가 되어야 합니다. Not loaded yet은 상주 도구 상태가 아직 관찰되지 않았다는 뜻이지 비활성 확인이 아닙니다. 별도 세션 모드는 없습니다. 프로필 Save와 세션 Apply는 독립 작업입니다.
MCP와 도구 검색
구성이 허용하면 MCP가 Codemode를 자동 활성화할 수 있습니다. Use current tool selection은 이를 유지합니다. 명시적 제외는 여전히 적용됩니다. 도구 검색은 독립적입니다. Codemode를 꺼도 MCP나 도구 검색은 꺼지지 않으며 허용된 활성 도구 검색은 간접 MCP 도구를 계속 찾을 수 있습니다. 페이지는 사용 가능하면 남은 경로를 보여 줍니다.
CLI 선택과 수동 구성은 Toolsets를 참조하세요. 스크립트 API는 Codemode, 검색과 다음 요청 활성화는 도구 검색을 참조하세요.
기능 백엔드 구성
기능 카드는 설정과 상태 검사를 안내합니다.
- Web Search에서 공급자, 엔드포인트, 자격 증명을 선택하고 검증합니다.
- Image, Video, Voice는 전용 경로에 모델 구성 인터페이스를 재사용합니다.
대응 CLI
구성된 기능을 나열합니다.
anyy tools list
대화형 설정이나 기능 점검을 실행합니다.
anyy tools websearch
anyy tools image --probe
anyy tools image generation --probe
anyy tools video understanding --probe
anyy tools voice tts --probe
anyy tools voice stt --probe
도구 가시성
백엔드가 구성되어도 기존 세션에 반드시 보이지는 않습니다. 도구 모음은 선택 프로필과 세션 컨텍스트에 따라 결정됩니다. 새 기능을 켠 뒤 백엔드와 세션 선택을 확인하세요. Codemode는 위 명시적 세션 작업을 사용합니다. 프로필 기본값만 바꿔도 기존 세션은 그대로입니다.
문제 해결
| 문제 | 해결 |
|---|---|
| 목록에는 있지만 세션에 도구 없음 | 기능 백엔드와 도구 모음 구성 확인 |
| MCP 도구 누락 | 서버 활성/노출과 세션 선택 확인. 필요하면 서버 점검·다시 로드 |
| 도구 출력 잘림 | 이어 읽기 안내를 따르거나 확인 가능한 결과 참조에 tool_result_read 사용 또는 더 좁은 결과 요청 |