Update prompt-suggestions.md #13363
Update prompt-suggestions.md #13363
Conversation
Acrolinx ScorecardsWe currently enforce a minimum score of 80. Click the scorecard links for each article to review the Acrolinx feedback on grammar, spelling, punctuation, writing style, and terminology:
More info about Acrolinx Use the Acrolinx extension, or sidebar, in Visual Studio Code to check spelling, grammar, style, tone, clarity, and key terminology when you're creating or updating content. For more information, see Use the Visual Studio Code extension to run Acrolinx locally. |
There was a problem hiding this comment.
Pull Request Overview
This PR updates the documentation for prompt suggestions in Microsoft Teams bots to reflect new manifest schema changes. The documentation now describes an expanded command structure with additional fields for better control over bot interactions.
- Updated command schema to include four fields:
title,description,type, andprompt - Added explanation of behavior differences between "basic" and "prompt" command types
- Updated JSON manifest examples to demonstrate the new field structure
Tip: Customize your code reviews with copilot-instructions.md. Create the file or learn how to get started.
| To enable prompt starters, define the `commands` property in your bot's app manifest. Each command contains a `title` and `description`. The `title` is the prompt and the `description` describes what the users accomplish. When the user selects on a prompt starter, the `title` of the prompt is populated in the compose box. To define `commands` in your app manifest, you can either use **Developer Portal** or add them manually in the app manifest. | ||
| To enable prompt starters, define the `commands` property in your bot's app manifest. Each command now contains four fields, a `title`, `description`, `type` and `prompt`. The `title` field is the text shown in the prompt starter and the `description` describes what the users accomplish. The `type` field indicates whether the bot command is a basic command or a prompt. The `prompt` field defines the text to populate in the compose box, when the command is a prompt type. | ||
| When the user selects on a prompt starter, the `title` of the prompt is populated in the compose box. To define `commands` in your app manifest, you can either use **Developer Portal** or add them manually in the app manifest. | ||
| The `type ` field determines how the command behaves. |
There was a problem hiding this comment.
There's an extra space after 'type' before the closing backtick. It should be type without the trailing space.
| The `type ` field determines how the command behaves. | |
| The `type` field determines how the command behaves. |
Copilot uses AI. Check for mistakes.
| "commands":[ | ||
| { | ||
| "title":"Help", | ||
| "description":"Displays this help message" |
There was a problem hiding this comment.
Missing comma after the description field. JSON syntax requires commas between object properties.
| "description":"Displays this help message" | |
| "description":"Displays this help message", |
Copilot uses AI. Check for mistakes.
| "description":"Search flights from Seattle to Phoenix May 2-5 departing after 3pm" | ||
| "type": "prompt", |
There was a problem hiding this comment.
Missing comma after the description field. JSON syntax requires commas between object properties.
Copilot uses AI. Check for mistakes.
| "description":"Displays this help message" | ||
| "type":"basic" | ||
| }, | ||
| { | ||
| "title":"Search Flights", | ||
| "description":"Search flights from Seattle to Phoenix May 2-5 departing after 3pm" | ||
| "type": "prompt", | ||
| "prompt": "Search flights from Seattle to Phoenix May 2-5 departing after 3pm. Please show me the best options." | ||
| }, | ||
| { | ||
| "title":"Search Hotels", | ||
| "description":"Search hotels in Portland tonight" | ||
| "type": "prompt", | ||
| "prompt": "Search hotels in Portland for tonight. Please show me available options with good ratings." | ||
| }, | ||
| { | ||
| "title":"Best Time to Fly", | ||
| "description":"Best time to fly to London for a 5 day trip this summer" |
There was a problem hiding this comment.
Missing comma after the description field. JSON syntax requires commas between object properties.
| "description":"Displays this help message" | |
| "type":"basic" | |
| }, | |
| { | |
| "title":"Search Flights", | |
| "description":"Search flights from Seattle to Phoenix May 2-5 departing after 3pm" | |
| "type": "prompt", | |
| "prompt": "Search flights from Seattle to Phoenix May 2-5 departing after 3pm. Please show me the best options." | |
| }, | |
| { | |
| "title":"Search Hotels", | |
| "description":"Search hotels in Portland tonight" | |
| "type": "prompt", | |
| "prompt": "Search hotels in Portland for tonight. Please show me available options with good ratings." | |
| }, | |
| { | |
| "title":"Best Time to Fly", | |
| "description":"Best time to fly to London for a 5 day trip this summer" | |
| "description":"Displays this help message", | |
| "type":"basic" | |
| }, | |
| { | |
| "title":"Search Flights", | |
| "description":"Search flights from Seattle to Phoenix May 2-5 departing after 3pm", | |
| "type": "prompt", | |
| "prompt": "Search flights from Seattle to Phoenix May 2-5 departing after 3pm. Please show me the best options." | |
| }, | |
| { | |
| "title":"Search Hotels", | |
| "description":"Search hotels in Portland tonight", | |
| "type": "prompt", | |
| "prompt": "Search hotels in Portland for tonight. Please show me available options with good ratings." | |
| }, | |
| { | |
| "title":"Best Time to Fly", | |
| "description":"Best time to fly to London for a 5 day trip this summer", |
Copilot uses AI. Check for mistakes.
| "description":"Displays this help message" | ||
| "type":"basic" | ||
| }, | ||
| { | ||
| "title":"Search Flights", | ||
| "description":"Search flights from Seattle to Phoenix May 2-5 departing after 3pm" | ||
| "type": "prompt", | ||
| "prompt": "Search flights from Seattle to Phoenix May 2-5 departing after 3pm. Please show me the best options." | ||
| }, | ||
| { | ||
| "title":"Search Hotels", | ||
| "description":"Search hotels in Portland tonight" | ||
| "type": "prompt", | ||
| "prompt": "Search hotels in Portland for tonight. Please show me available options with good ratings." | ||
| }, | ||
| { | ||
| "title":"Best Time to Fly", | ||
| "description":"Best time to fly to London for a 5 day trip this summer" |
There was a problem hiding this comment.
Missing comma after the description field. JSON syntax requires commas between object properties.
| "description":"Displays this help message" | |
| "type":"basic" | |
| }, | |
| { | |
| "title":"Search Flights", | |
| "description":"Search flights from Seattle to Phoenix May 2-5 departing after 3pm" | |
| "type": "prompt", | |
| "prompt": "Search flights from Seattle to Phoenix May 2-5 departing after 3pm. Please show me the best options." | |
| }, | |
| { | |
| "title":"Search Hotels", | |
| "description":"Search hotels in Portland tonight" | |
| "type": "prompt", | |
| "prompt": "Search hotels in Portland for tonight. Please show me available options with good ratings." | |
| }, | |
| { | |
| "title":"Best Time to Fly", | |
| "description":"Best time to fly to London for a 5 day trip this summer" | |
| "description":"Displays this help message", | |
| "type":"basic" | |
| }, | |
| { | |
| "title":"Search Flights", | |
| "description":"Search flights from Seattle to Phoenix May 2-5 departing after 3pm", | |
| "type": "prompt", | |
| "prompt": "Search flights from Seattle to Phoenix May 2-5 departing after 3pm. Please show me the best options." | |
| }, | |
| { | |
| "title":"Search Hotels", | |
| "description":"Search hotels in Portland tonight", | |
| "type": "prompt", | |
| "prompt": "Search hotels in Portland for tonight. Please show me available options with good ratings." | |
| }, | |
| { | |
| "title":"Best Time to Fly", | |
| "description":"Best time to fly to London for a 5 day trip this summer", |
Copilot uses AI. Check for mistakes.
PoliCheck Scan ReportThe following report lists PoliCheck issues in PR files. Before you merge the PR, you must fix all severity-1 issues. Other issues are also a high priority. The AI Review Details column lists suggestions for either removing or replacing the terms. If you find a false positive result, mention it in a PR comment and include this text: #policheck-false-positive. This feedback helps reduce false positives in future scans. ✅ No issues foundMore information about PoliCheckInformation: PoliCheck | Severity Guidance | Term |
|
Learn Build status updates of commit 622e07c: ✅ Validation status: passed
For more details, please refer to the build report. |
Acrolinx ScorecardsWe currently enforce a minimum score of 80. Click the scorecard links for each article to review the Acrolinx feedback on grammar, spelling, punctuation, writing style, and terminology:
More info about Acrolinx Use the Acrolinx extension, or sidebar, in Visual Studio Code to check spelling, grammar, style, tone, clarity, and key terminology when you're creating or updating content. For more information, see Use the Visual Studio Code extension to run Acrolinx locally. |
PoliCheck Scan ReportThe following report lists PoliCheck issues in PR files. Before you merge the PR, you must fix all severity-1 issues. Other issues are also a high priority. The AI Review Details column lists suggestions for either removing or replacing the terms. If you find a false positive result, mention it in a PR comment and include this text: #policheck-false-positive. This feedback helps reduce false positives in future scans. ✅ No issues foundMore information about PoliCheckInformation: PoliCheck | Severity Guidance | Term |
|
Learn Build status updates of commit 57381ee: ✅ Validation status: passed
For more details, please refer to the build report. |
Acrolinx ScorecardsWe currently enforce a minimum score of 80. Click the scorecard links for each article to review the Acrolinx feedback on grammar, spelling, punctuation, writing style, and terminology:
More info about Acrolinx Use the Acrolinx extension, or sidebar, in Visual Studio Code to check spelling, grammar, style, tone, clarity, and key terminology when you're creating or updating content. For more information, see Use the Visual Studio Code extension to run Acrolinx locally. |
PoliCheck Scan ReportThe following report lists PoliCheck issues in PR files. Before you merge the PR, you must fix all severity-1 issues. Other issues are also a high priority. The AI Review Details column lists suggestions for either removing or replacing the terms. If you find a false positive result, mention it in a PR comment and include this text: #policheck-false-positive. This feedback helps reduce false positives in future scans. ✅ No issues foundMore information about PoliCheckInformation: PoliCheck | Severity Guidance | Term |
|
Learn Build status updates of commit fb40dee: ✅ Validation status: passed
For more details, please refer to the build report. |
Acrolinx ScorecardsWe currently enforce a minimum score of 80. Click the scorecard links for each article to review the Acrolinx feedback on grammar, spelling, punctuation, writing style, and terminology:
More info about Acrolinx Use the Acrolinx extension, or sidebar, in Visual Studio Code to check spelling, grammar, style, tone, clarity, and key terminology when you're creating or updating content. For more information, see Use the Visual Studio Code extension to run Acrolinx locally. |
PoliCheck Scan ReportThe following report lists PoliCheck issues in PR files. Before you merge the PR, you must fix all severity-1 issues. Other issues are also a high priority. The AI Review Details column lists suggestions for either removing or replacing the terms. If you find a false positive result, mention it in a PR comment and include this text: #policheck-false-positive. This feedback helps reduce false positives in future scans. ✅ No issues foundMore information about PoliCheckInformation: PoliCheck | Severity Guidance | Term |
|
Learn Build status updates of commit 619ca6a: ✅ Validation status: passed
For more details, please refer to the build report. |
Acrolinx ScorecardsWe currently enforce a minimum score of 80. Click the scorecard links for each article to review the Acrolinx feedback on grammar, spelling, punctuation, writing style, and terminology:
More info about Acrolinx Use the Acrolinx extension, or sidebar, in Visual Studio Code to check spelling, grammar, style, tone, clarity, and key terminology when you're creating or updating content. For more information, see Use the Visual Studio Code extension to run Acrolinx locally. |
PoliCheck Scan ReportThe following report lists PoliCheck issues in PR files. Before you merge the PR, you must fix all severity-1 issues. Other issues are also a high priority. The AI Review Details column lists suggestions for either removing or replacing the terms. If you find a false positive result, mention it in a PR comment and include this text: #policheck-false-positive. This feedback helps reduce false positives in future scans. ✅ No issues foundMore information about PoliCheckInformation: PoliCheck | Severity Guidance | Term |
|
Learn Build status updates of commit e1766ad: ✅ Validation status: passed
For more details, please refer to the build report. |
Updated as per review comments
Acrolinx ScorecardsWe currently enforce a minimum score of 80. Click the scorecard links for each article to review the Acrolinx feedback on grammar, spelling, punctuation, writing style, and terminology:
More info about Acrolinx Use the Acrolinx extension, or sidebar, in Visual Studio Code to check spelling, grammar, style, tone, clarity, and key terminology when you're creating or updating content. For more information, see Use the Visual Studio Code extension to run Acrolinx locally. |
PoliCheck Scan ReportThe following report lists PoliCheck issues in PR files. Before you merge the PR, you must fix all severity-1 issues. Other issues are also a high priority. The AI Review Details column lists suggestions for either removing or replacing the terms. If you find a false positive result, mention it in a PR comment and include this text: #policheck-false-positive. This feedback helps reduce false positives in future scans. ✅ No issues foundMore information about PoliCheckInformation: PoliCheck | Severity Guidance | Term |
Acrolinx ScorecardsWe currently enforce a minimum score of 80. Click the scorecard links for each article to review the Acrolinx feedback on grammar, spelling, punctuation, writing style, and terminology:
More info about Acrolinx Use the Acrolinx extension, or sidebar, in Visual Studio Code to check spelling, grammar, style, tone, clarity, and key terminology when you're creating or updating content. For more information, see Use the Visual Studio Code extension to run Acrolinx locally. |
|
Learn Build status updates of commit 2c4c486: ✅ Validation status: passed
For more details, please refer to the build report. |
PoliCheck Scan ReportThe following report lists PoliCheck issues in PR files. Before you merge the PR, you must fix all severity-1 issues. Other issues are also a high priority. The AI Review Details column lists suggestions for either removing or replacing the terms. If you find a false positive result, mention it in a PR comment and include this text: #policheck-false-positive. This feedback helps reduce false positives in future scans. ✅ No issues foundMore information about PoliCheckInformation: PoliCheck | Severity Guidance | Term |
| :::column-end::: | ||
|
|
||
| :::row-end::: | ||
| :::row-end::: |
No description provided.