コンテキスト参照
コンテキスト参照は、原資料を手でメッセージにコピーせずAnyyに示す方法です。通常のプロンプト文章に対応する@参照を入れると、常駐ランタイムがモデルターン前に展開し、引用メタデータを実行とともに記録します。
対応する参照
| 構文 | 追加されるもの |
|---|---|
@file:PATH | Profile Homeのテキストファイル、または安全検査を通る明示的な絶対パス |
@file:PATH:START-END | テキストファイルの指定行範囲 |
@url:https://example.com/page | 公開HTTP(S)ページの読み取り可能な文章 |
@result:RESULT_ID | 現在のセッションのツール結果に保存された証拠 |
@folder:PATH | アクティブWorkspaceルート内の1フォルダーの整列済み一覧 |
@diff | 現在の未ステージGit差分 |
@staged | 現在のステージ済みGit差分 |
@git:N | 最新N件のGitコミットのパッチ |
通常の指示と参照を組み合わせられます。
Compare @file:workspace/proposal.md:10-80 with @url:https://example.com/policy and list conflicts.
ファイルを参照する
相対@fileパスは、選択したProfile Homeを基準に解決されます。したがって、既定Workspaceは通常workspace/接頭辞付きで参照します。
Summarize @file:workspace/notes/meeting.md
1つの部分だけが重要なら行範囲を使います。
Review the assumptions in @file:workspace/plan.md:24-67
参照ごとの上限を超えるテキストファイルは、指定した行範囲が収まる場合を除き拒否されます。バイナリファイルはテキストとして挿入されません。対応メディアはチャット画面から添付してください。
フォルダーやGit状態を参照する
@folderはディレクトリ直下の項目を列挙し、全ファイルを再帰的に挿入しません。フォルダーとGit参照は、セッションが提供するアクティブWorkspaceルート内に制限されます。
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は見つからないものとして扱われます。
制限と警告
1つのプロンプトで展開できる参照は最大8件です。既定の添付参照テキスト上限は1件64 KiB、合計192 KiBです。公開ページの抽出にも上限があり、Git取得には独自の有限上限があります。
参照の構文が不正、拒否、欠落、サイズ超過、件数／合計予算超過の場合、Anyyは内容を勝手に作らず警告を添えます。参照を直し、新しいターンで送信してください。
参照文は信頼できない場合があります。Anyyのシステム規則、現在の依頼、有効なツール設定を上書きしません。
セキュリティ上の動作
- 保護された認証情報パスは拒否され、認識したシークレットは秘匿されます。
- フォルダーとGit参照では、パストラバーサルとアクティブWorkspaceルート外への脱出を拒否します。
- シンボリックリンクは保護境界を越えて追跡せず、検証します。
- バイナリファイル内容は拒否します。
- URL取得はプライベート／内部宛先とHTTP(S)以外のスキームを拒否します。
これらは偶発的な漏洩を減らしますが、任意の公開コンテンツを信頼できるものにするわけではありません。そこから導いた操作を許可する前に、引用元を読んでください。
トラブルシューティング
| 警告 | 対処 |
|---|---|
malformed context reference | コロン構文、行範囲、正のGit件数を確認 |
reference not found | パス、結果ID、Gitリポジトリ、URLを確認 |
reference blocked | 許可ルート内にし、認証情報／プライベートネットワーク宛先を避ける |
reference too large | 行範囲を選ぶか、情報源の数／サイズを減らす |
reference limit exceeded | 各8参照以下の複数ターンに分割 |
ツールでのファイル操作はファイルとターミナル、過去の会話の検索はセッション検索を参照してください。