Skip to content

Commit 70f6361

Browse files
DanWahlinCopilot
andauthored
docs: document auto model selection and document file attachments (v1.0.32)
- Chapter 01: Add note about 'auto' model option that lets Copilot automatically pick the best available model for each session - Chapter 02: Add document file (.pdf, etc.) support to the @ patterns table and 'Working with Images' section, now titled 'Working with Images and Documents' Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
1 parent 31099db commit 70f6361

File tree

2 files changed

+14
-1
lines changed

2 files changed

+14
-1
lines changed

01-setup-and-first-steps/README.md

Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -484,6 +484,8 @@ copilot
484484
# Shows available models and lets you pick one. Select Sonnet 4.5.
485485
```
486486

487+
> 💡 **Not sure which model to pick?** Select **`auto`** from the model list to let Copilot automatically choose the best available model for each session. This is a great option when you're just getting started and don't want to worry about model selection.
488+
487489
> 💡 **Tip**: Some models cost more "premium requests" than others. Models marked **1x** (like Claude Sonnet 4.5) are a great default. They're capable and efficient. Higher-multiplier models use your premium request quota faster, so save those for when you really need them.
488490
489491
</details>

02-context-conversations/README.md

Lines changed: 12 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -75,6 +75,9 @@ copilot
7575
| `@file.py` | Reference a single file | `Review @samples/book-app-project/books.py` |
7676
| `@folder/` | Reference all files in a directory | `Review @samples/book-app-project/` |
7777
| `@file1.py @file2.py` | Reference multiple files | `Compare @samples/book-app-project/book_app.py @samples/book-app-project/books.py` |
78+
| `@document.pdf` | Reference a document file | `Summarize @requirements.pdf` |
79+
80+
> 💡 **Document files**: In addition to code files and images, you can attach supported document files (such as PDFs) to your prompts using the same `@` syntax. This lets the agent read and reason about specs, requirements, or any document alongside your code.
7881

7982
### Reference a Single File
8083

@@ -673,7 +676,7 @@ This staged approach keeps context focused and efficient.
673676
<summary><strong>Working with Images</strong></summary>
674677
<a id="working-with-images"></a>
675678
676-
### Working with Images
679+
### Working with Images and Documents
677680
678681
You can include images in your conversations using the `@` syntax, or simply **paste from your clipboard** (Cmd+V / Ctrl+V). Copilot CLI can analyze screenshots, mockups, and diagrams to help with UI debugging, design implementation, and error analysis.
679682
@@ -685,6 +688,14 @@ copilot
685688
> @images/mockup.png Write the HTML and CSS to match this design. Place it in a new file called index.html and put the CSS in styles.css.
686689
```
687690
691+
You can also attach **document files** (such as PDFs) to provide requirements, specs, or any written reference material:
692+
693+
```bash
694+
copilot
695+
696+
> @requirements.pdf Implement the feature described in this document for @samples/book-app-project/book_app.py
697+
```
698+
688699
> 📖 **Learn more**: See [Additional Context Features](../appendices/additional-context.md#working-with-images) for supported formats, practical use cases, and tips for combining images with code.
689700
690701
</details>

0 commit comments

Comments
 (0)