Skip to content

[bot] Add auto model selection and document file attachment docs (v1.0.32) #89

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Draft
DanWahlin wants to merge 1 commit into
base: main
Choose a base branch
from
+14 −1
Draft

[bot] Add auto model selection and document file attachment docs (v1.0.32) #89

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
2 changes: 2 additions & 0 deletions 01-setup-and-first-steps/README.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -484,6 +484,8 @@ copilot
# Shows available models and lets you pick one. Select Sonnet 4.5.
```

> 💡 **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.

> 💡 **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.

</details>
Expand Down
13 changes: 12 additions & 1 deletion 02-context-conversations/README.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -75,6 +75,9 @@ copilot
| `@file.py` | Reference a single file | `Review @samples/book-app-project/books.py` |
| `@folder/` | Reference all files in a directory | `Review @samples/book-app-project/` |
| `@file1.py @file2.py` | Reference multiple files | `Compare @samples/book-app-project/book_app.py @samples/book-app-project/books.py` |
| `@document.pdf` | Reference a document file | `Summarize @requirements.pdf` |

> 💡 **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.

### Reference a Single File

Expand Down Expand Up @@ -673,7 +676,7 @@ This staged approach keeps context focused and efficient.
<summary><strong>Working with Images</strong></summary>
<a id="working-with-images"></a>

### Working with Images
### Working with Images and Documents

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.

Expand All @@ -685,6 +688,14 @@ copilot
> @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.
```

You can also attach **document files** (such as PDFs) to provide requirements, specs, or any written reference material:

```bash
copilot

> @requirements.pdf Implement the feature described in this document for @samples/book-app-project/book_app.py
```

> 📖 **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.

</details>
Expand Down
Loading