文件、附件与工作目录
为提示提供文件和图像,添加目录并区分直接 Shell 与模型调用。
提供明确的文件上下文,比让智能体从整个仓库猜测目标更直接。CLI 支持文件提及、图片和 PDF 附件,也允许调整会话工作目录;这些操作仍受当前模型能力和权限控制。
提及代码文件
在提示中写 @ 加相对路径,例如:
Explain @config/ci/ci-required-checks.yml
Fix the bug in @src/app.js文件内容会作为上下文加入提示。输入路径时,匹配项显示在输入框下方,使用方向键选择并按 Tab 补全。文件内容同样占用模型上下文,长会话可用上下文检查观察占用。
图片与 PDF
当前官方使用说明列出 JPEG(.jpg、.jpeg)、PNG、GIF、WEBP、PDF、HEIC、HEIF。必须选择支持图像输入的模型;功能面向所有 Copilot 套餐默认启用,无需额外的启用策略。
交互会话中可以用 @路径 引用文件,拖入附件,或从剪贴板粘贴图片。引用图片或 PDF 后,应在提示中说明希望检查什么,例如布局差异或错误信息,而不是只提供附件。
访问其他目录
任务需要修改工作目录以外的文件时,CLI 会请求访问相关目录。也可以主动添加:
/add-dir /path/to/directory如果整个任务都应切换到另一个位置,可使用 /cwd 或别名 /cd:
/cwd /path/to/directory添加可访问目录和切换当前工作目录不是同一操作。前者扩展可用位置,后者改变会话当前目录;具体批准范围见路径与 URL 权限。
直接运行 Shell
在输入前加 ! 会直接运行 Shell 命令,不调用模型。例如,用 !git status 检查本地改动。此时执行的是你输入的命令,不应把它当作自然语言问题期待模型解释。
若希望智能体分析命令结果并继续任务,应在主对话中明确说明需要的分析。需要不进入主会话的临时解释时,可以使用旁支提问,但 /ask 本身不能调用工具。