컨텍스트 참조
컨텍스트 참조는 소스 자료를 직접 복사하지 않고 Anyy에 가리키게 합니다. 일반 프롬프트 텍스트에 지원 @ 참조를 넣으면 상주 런타임이 모델 턴 전에 확장하고 실행에 인용 메타데이터를 기록합니다.
지원 참조
| 문법 | 추가 내용 |
|---|---|
@file:PATH | 프로필 홈의 텍스트 파일 또는 안전 검사를 통과한 명시적 절대 경로 |
@file:PATH:START-END | 텍스트 파일의 제한된 줄 범위 |
@url:https://example.com/page | 공개 HTTP(S) 페이지에서 읽을 수 있는 텍스트 |
@result:RESULT_ID | 현재 세션 도구 결과의 저장 증거 |
@folder:PATH | 활성 워크스페이스 루트 내 폴더 하나의 정렬된 목록 |
@diff | 현재 스테이징하지 않은 Git diff |
@staged | 현재 스테이징한 Git diff |
@git:N | 최근 N개 Git 커밋의 패치 |
일반 지침과 참조를 함께 쓸 수 있습니다.
Compare @file:workspace/proposal.md:10-80 with @url:https://example.com/policy and list conflicts.
파일 참조
상대 @file 경로는 선택 프로필 홈에서 결정됩니다. 따라서 기본 워크스페이스는 보통 workspace/ 접두사로 참조합니다.
Summarize @file:workspace/notes/meeting.md
한 부분만 중요하면 줄 범위를 사용하세요.
Review the assumptions in @file:workspace/plan.md:24-67
참조별 한도보다 큰 텍스트 파일은 제한 줄 범위가 맞지 않으면 거부됩니다. 바이너리는 텍스트로 넣지 않습니다. 지원 미디어는 채팅 인터페이스로 첨부하세요.
폴더나 Git 상태 참조
@folder는 디렉터리의 직접 항목을 나열하며 모든 파일을 재귀 삽입하지 않습니다. 폴더·Git 참조는 세션이 제공한 활성 워크스페이스 루트로 제한됩니다.
Use @folder:reports to identify the newest report.
Review @diff for correctness and missing tests.
Compare the last three commits with @git:3.
@diff, @staged, @git:N에는 Git 작업 트리가 필요합니다. Anyy는 제한된 읽기 전용 Git 명령을 실행하고 변경 경로 사전 검사에 보호 민감 경로가 포함되면 참조를 거부합니다.
공개 페이지와 도구 결과 참조
@url은 공개 HTTP(S) 목적지를 받습니다. 비공개/내부 대상과 미지원 스킴은 차단됩니다.
Extract the decision criteria from @url:https://example.com/guide
이전 도구가 논리 결과 ID를 반환했고 저장 증거가 다시 필요하면 @result를 사용하세요.
Re-check the failures in @result:tr_123 and propose the smallest fix.
도구 결과 참조는 현재 세션으로 제한됩니다. 다른 세션 ID는 찾을 수 없음으로 취급합니다.
제한과 경고
프롬프트 하나는 참조를 최대 여덟 개 확장합니다. 기본값은 참조당 64 KiB, 전체 첨부 참조 텍스트 192 KiB입니다. 공개 페이지 추출도 제한되며 Git 캡처에는 별도의 유한 한도가 있습니다.
참조가 잘못되거나 차단·누락·초과되거나 개수/전체 예산을 넘으면 Anyy는 내용을 만들어 내지 않고 경고를 첨부합니다. 고친 뒤 새 턴을 보내세요.
참조 텍스트는 신뢰할 수 없을 수 있습니다. Anyy 시스템 규칙, 현재 요청, 활성 도구 구성을 재정의하지 않습니다.
보안 동작
- 보호 자격 증명 경로를 거부하고 인식한 비밀 자료를 정리합니다.
- 폴더·Git 참조의 경로 탐색과 활성 워크스페이스 루트 이탈을 차단합니다.
- 심볼릭 링크는 보호 경계를 넘어 따라가지 않고 검증합니다.
- 바이너리 파일 내용을 거부합니다.
- URL 가져오기는 비공개/내부 목적지와 비 HTTP(S) 스킴을 차단합니다.
이 검사는 우발 노출을 줄일 뿐 임의의 공개 콘텐츠를 신뢰 가능하게 만들지는 않습니다. 이를 바탕으로 행동을 허가하기 전에 인용 소스를 읽으세요.
문제 해결
| 경고 | 해결 |
|---|---|
malformed context reference | 콜론 문법, 줄 범위, 양수 Git 개수 확인 |
reference not found | 경로, 결과 ID, Git 저장소, URL 확인 |
reference blocked | 허용 루트 안에 두고 자격 증명·비공개 네트워크 대상 회피 |
reference too large | 파일 줄 범위나 더 적고 작은 소스 선택 |
reference limit exceeded | 턴당 여덟 개 이하로 요청 분할 |