구성

Anyy 구성은 프로필에 속합니다. 각 프로필에는 자체 모델 경로, 채널, 도구, 일정, 자격 증명, 워크스페이스, 상태가 있습니다.

권장 설정 변경 방법

변경	권장 인터페이스
초기 설정	anyy setup
모델·자격 증명	Dashboard → Models 또는 anyy setup model
채널	Dashboard → Channels 또는 anyy setup channel
이미지·동영상·음성 경로	Dashboard → Models 또는 해당 Tools 페이지
웹 검색	Dashboard → Tools → Web Search
역할·스킬·MCP·cron	해당 Dashboard 섹션
결정 구성 확인	anyy config

anyy config는 읽기 전용입니다. 비밀값 없이 프로필, 경로, 공급자/모델 선택, 자격 증명 참조 상태를 보고합니다.

지원 편집기를 사용하세요

Dashboard·설정 명령은 변경 검증, 비밀 보호, 지원 실시간 다시 로드를 합니다. 직접 YAML은 고급 복구에 유용하지만 안내 검사를 건너뜁니다.

프로필 구성

활성 홈에는 해당 프로필의 표준 사용자 데이터가 있습니다. 주요 경로:

경로	목적
config.yaml	설정·비밀 참조. MCP 값은 입력 문자열 유지
secrets/	Anyy 관리 비밀
state.db	세션, 메시지, 작업, 감사 등 영속 상태
memory/USER.md	사용자 영속 사실·선호
memory/MEMORY.md	영속 비서 메모리
objects/	표준 상태가 참조하는 콘텐츠 주소 영속 페이로드
workspace/	컨텍스트·사용자 작업 파일
skills/	설치 프로필 로컬 스킬
roles/	프로필 로컬 역할 정의

workspace/는 보안 경계가 아닙니다. 도구는 운영체제 권한·실행 제한을 따릅니다.

활성 프로필 확인

anyy status
anyy config

다른 이름 프로필 확인:

anyy --profile work config

--home PATH 지원 명령은 명시 디렉터리를 지정할 수 있습니다. 의도적 경로 진단 외에는 --profile, --profile-root, 임의 --home을 섞지 마세요.

Thinking 구성과 마이그레이션

전역 thinking 선호는 main_model.inference, 정확 대상 재정의는 루트 model_thinking_levels 맵입니다.

main_model:
  provider_id: your-provider
  model: your-model
  inference:
    enabled: true
    # Leave level omitted to keep the global level unset.
model_thinking_levels:
  "your-provider/your-model": high

구성한 공급자/모델 ID를 쓰세요. 첫 /에서 나누며 양쪽이 비어 있으면 안 됩니다. 키를 정규화하지 않고 정확히 조회합니다. 미등록 모델 키도 나중을 위해 저장 가능합니다. 값은 Pi 이름 off, minimal, low, medium, high, xhigh, max이며 런타임 스냅샷은 값 공백을 자릅니다. 빈 맵 값은 무효입니다.

전역 enabled 기본은 true입니다. true·생략 시 level 생략은 미설정이고 enabled: false는 level 없이도 명시 off입니다. 이름 off도 유효합니다. 모델이 요청을 제한하며 inference.effective_level은 읽기 전용이지 YAML 설정이 아닙니다. 우선순위를 참조하세요.

이전 구성을 v0.1.107로 올릴 때:

• 폐기 prompt_program.inference_level은 빈 값도 제거하세요. null·다른 타입도 거부됩니다. 전역 의도는 main_model.inference, 모델별은 model_thinking_levels로 옮기세요.
• prompt_program.render_profile은 null·빈 값도 제거하세요. 대체 선택기나 must-high 요건은 없습니다.
• 제품 provider_default를 이름 있는 Pi 수준으로 바꾸세요. 전역은 level 제거로 미설정 유지, 맵은 이름 값 선택 또는 항목 제거입니다.

JSON/YAML·제품 API는 폐기 입력을 명시 거부하며 별칭·medium 자동 변환은 없습니다. Anyy는 조용히 다시 쓰지 않으므로 명시 마이그레이션하세요. 공개 prompt_program은 resource_class만 유지합니다. 네이티브 저수준 inference 생략은 유효합니다.

재시도와 모델 인터페이스

세션·공급자 SDK·대체·가상 모델 콜백 제어는 별개이며 retry.enabled는 전체 스위치가 아닙니다. 타입 providers[].models[], 샘플링, 정확한 retry/httpIdleTimeoutMs는 공급자 프로토콜과 모델 인터페이스를 참조하세요.

MCP 구성

프로필 MCP는 config.yaml의 mcp.client.servers입니다. 표준 워크스페이스에 .anyy/mcp.json(현재 <ProfileHome>/workspace/.anyy/mcp.json)도 가능합니다. 전체 정의는 같은 이름을 대체하고 부분은 활성·노출·전체 순서 노출 규칙만 재정의합니다. 형식·표현식은 구성을 참조하세요.

활성/노출은 선택 정의·기존 프로젝트 재정의에 저장하고 해당 서버에만 영향 줍니다. 프로필 명령의 설명·도구 재정의·전송·비밀 편집은 원시 프로필 편집입니다. CLI 설정과 프로필 옵션은 따로 제출하세요. enable/disable --project는 미재정의 프로필에 활성 전용 재정의를 만듭니다. add/remove --local은 프로젝트만 편집해 프로필·독립 비밀을 보존하고 다음 시작·유휴 다시 로드에 적용됩니다.

anyy mcp reload는 로드값으로 재연결하며 파일을 읽지 않습니다. 시작·유휴 session.reload가 재읽습니다. 표현식, 노출, OAuth는 MCP 안내를 참조하세요.

자격 증명

관리 자격 증명은 구성에 비밀값 대신 참조를 씁니다. Dashboard·설정의 명시 지원 작업은 제한 권한의 secrets/에 기록합니다. 일반 MCP 값은 문자열·표현식을 유지하고 자동 관리 비밀을 만들지 않습니다. MCP 값을 참조하세요.

생성한 기능 인터페이스에서 교체·지우기·연결·해제하세요. 프롬프트, 스크린샷, 셸 기록, 지원 번들에 붙이지 마세요.

변경 적용

많은 Dashboard·설정 작업은 기록 성공 후 해당 런타임을 다시 로드합니다. 채널은 명시적으로도 적용합니다.

anyy channel reload

저장됐지만 동작이 같으면:

anyy status
anyy doctor
anyy gateway status

조치가 요청하거나 실시간 다시 로드 불가일 때만 Gateway를 재시작하세요.

v0.1.107은 다음 이전 MCP를 거부하므로 수동 구성에서 제거·이전하세요.

• mcp.client.enabled: 서버별 enabled 사용.
• mcp.client.session_idle_ttl_ms: 폐기. 알림·명시 작업으로 카탈로그 갱신.
• 서버 connect_timeout_ms: 초기화·검색·도구 요청마다 기존 call_timeout_ms 사용.
• tools.include, tools.exclude, tools.trusted: exposure, toolExposure 사용. tools.resources, tools.prompts도 폐기.

새 request_timeout_ms 키는 없습니다. 전체 형식·이전은 MCP 서버를 참조하세요.

수동 편집 전 백업

anyy backup create

기본은 관리 secrets/와 지원 mcp/oauth/를 제외하고 --include-secrets가 추가 포함합니다. 표준 구성·워크스페이스는 여전히 캡처하므로 인라인 비밀은 기본 아카이브에도 들 수 있습니다. 완전 가림은 보장하지 않습니다. 모든 아카이브를 비공개로 보호하고 관리 비밀은 자격 증명 저장소처럼 보호할 때만 포함하세요. 백업 및 복원을 참조하세요.

문제 해결

증상	확인 사항
설정 그대로	활성 프로필·anyy config
Gateway 이전 값	해당 다시 로드 후 anyy status
검증 실패	Dashboard·마법사로 무효 필드 확인
구성 비밀 미해결	소유 Models·Tools·Channels에서 교체
YAML이 시작 차단	최근 유효 파일 또는 새 프로필에 백업 복원