Skip to content

Commit a1b9fce

Browse files
DanWahlinCopilot
andauthored
docs: add auto model selection and document file attachment features
Document two new beginner-friendly features introduced in Copilot CLI v1.0.32: - Chapter 01: Update Switching Models section to mention the 'auto' model option, which lets Copilot automatically pick the best available model - Chapter 02: Add new 'Attaching Document Files' optional section explaining how to attach PDFs and other documents to prompts using the @ syntax Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
1 parent 31099db commit a1b9fce

File tree

2 files changed

+28
-1
lines changed

2 files changed

+28
-1
lines changed

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

Lines changed: 5 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -481,9 +481,13 @@ Copilot CLI supports multiple AI models from OpenAI, Anthropic, Google, and othe
481481
copilot
482482
> /model
483483

484-
# Shows available models and lets you pick one. Select Sonnet 4.5.
484+
# Shows available models and lets you pick one.
485+
# Select "auto" to let Copilot automatically choose the best model for each task.
486+
# Or select a specific model like Sonnet 4.5.
485487
```
486488

489+
> 💡 **Not sure which model to choose?** Select `auto` when prompted. Copilot will automatically pick the best available model for each session based on the task. It's the simplest option and a great starting point.
490+
487491
> 💡 **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.
488492
489493
</details>

02-context-conversations/README.md

Lines changed: 23 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -427,6 +427,7 @@ These topics build on the essentials above. **Pick what interests you, or skip a
427427
| Token limits and `/compact` | [Understanding Context Windows](#understanding-context-windows) |
428428
| How to pick the right files to reference | [Choosing What to Reference](#choosing-what-to-reference) |
429429
| Analyzing screenshots and mockups | [Working with Images](#working-with-images) |
430+
| Attaching PDF and other document files | [Attaching Document Files](#attaching-documents) |
430431
431432
<details>
432433
<summary><strong>Additional @ Patterns & Session Commands</strong></summary>
@@ -689,6 +690,28 @@ copilot
689690
690691
</details>
691692
693+
<details>
694+
<summary><strong>Attaching Document Files</strong></summary>
695+
<a id="attaching-documents"></a>
696+
697+
### Attaching Document Files
698+
699+
In addition to code files and images, you can attach supported **document files** (such as PDFs) to your prompts. This lets Copilot read and reason about the contents of documents alongside your code.
700+
701+
```bash
702+
copilot
703+
704+
> @requirements.pdf @samples/book-app-project/ Does the book app satisfy these requirements?
705+
706+
> @architecture-diagram.pdf Summarize the key design decisions and check if @samples/book-app-project/ follows them
707+
```
708+
709+
> 💡 **When is this useful?** Suppose you have a PDF of technical requirements, a design document, or a user manual. You can attach it directly so Copilot can understand the context without you having to copy-paste the contents manually.
710+
711+
> ⚠️ **Note**: Not all document formats are supported. PDFs are a common format that works well. If Copilot cannot read a file, try converting it to a plain text or Markdown format first.
712+
713+
</details>
714+
692715
---
693716
694717
# Practice

0 commit comments

Comments
 (0)