Skip to content

Conversation

softchris
Copy link
Contributor

@softchris softchris commented Aug 18, 2025

Purpose

Elicitation is about supporting a scenario where the user makes a first selection, for example a booking, and it's not available. The elicitation happens when the server asks the user to make a different choice and "elicits" a new response from the client.

Does this introduce a breaking change?

When developers merge from main and run the server, azd up, or azd deploy, will this produce an error?
If you're not sure, try it out on an old environment.

[ ] Yes
[ ] No

Does this require changes to learn.microsoft.com docs or modules?

which includes deployment, settings and usage instructions.

[ ] Yes
[ ] No

Type of change

[ ] Bugfix
[ ] Feature
[ ] Code style update (formatting, local variables)
[ ] Refactoring (no functional changes, no api changes)
[ ] Documentation content changes
[ ] Other... Please describe:

@Copilot Copilot AI review requested due to automatic review settings August 18, 2025 23:34
Copy link
Contributor

@Copilot Copilot AI left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull Request Overview

This PR introduces a new documentation chapter (3.10) focused on elicitation functionality in MCP (Model Control Protocol) servers. The chapter demonstrates how to implement user preference collection and interactive booking scenarios.

  • Adds a Python server implementation showcasing elicitation patterns for booking scenarios
  • Creates placeholder TypeScript implementation file
  • Establishes new chapter structure in the documentation

Reviewed Changes

Copilot reviewed 3 out of 3 changed files in this pull request and generated 2 comments.

File Description
03-GettingStarted/10-elicitation/code/python/server.py Complete Python MCP server demonstrating elicitation with booking preferences
03-GettingStarted/10-elicitation/code/typescript/src/index.ts Placeholder TypeScript file with basic comment
03-GettingStarted/10-elicitation/README.md Basic chapter title for the elicitation documentation

Tip: Customize your code reviews with copilot-instructions.md. Create the file or learn how to get started.

@@ -0,0 +1 @@
// server for elicitation No newline at end of file
Copy link

Copilot AI Aug 18, 2025

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

The TypeScript implementation is incomplete with only a comment. This placeholder should either contain actual implementation code or a more descriptive comment explaining the intended functionality.

Copilot uses AI. Check for mistakes.

@softchris softchris changed the title docs: ch3.10 - elicitation DRAFT docs: ch3.10 - elicitation Aug 18, 2025
@leestott
Copy link
Contributor

@softchris can you fix the suggestions provided
Also changelog.md needs update
Main readme.md need updating with new chapter context

@leestott leestott marked this pull request as draft August 19, 2025 14:03
@softchris softchris changed the title DRAFT docs: ch3.10 - elicitation DRAFT ch3.10 - elicitation Sep 19, 2025
@softchris softchris changed the title DRAFT ch3.10 - elicitation DRAFT docs, ch3.10 - elicitation Sep 19, 2025
@softchris softchris changed the title DRAFT docs, ch3.10 - elicitation DRAFT docs, ch3 - elicitation Oct 6, 2025
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants