Suggested actions proposed updates#14329
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. |
PoliCheck Scan ReportThe following report lists PoliCheck issues in PR files. Before you merge the PR, you must fix all severity-1 and severity-2 issues. 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 7166ac4: ✅ Validation status: passed
For more details, please refer to the build report. |
|
|
||
| # Create prompt suggestions | ||
|
|
||
| Prompt suggestions are commands that are presented to the users in the Microsoft Teams chat. |
There was a problem hiding this comment.
Need to find a word other than commands given the debut of agent slash commands.
|
|
||
| >[!NOTE] | ||
| > | ||
| > Your bot can either use a prompt starter or a welcome message. If your bot uses prompt starters, ensure that your bot doesn't send a welcome message. |
There was a problem hiding this comment.
welcome message
Is there a doc you can link to about welcome messages? And does it say the same thing in the other direction?
| * The `type` field indicates whether the bot command is basic or prompt. Set `type` to **prompt** and provide the text in the prompt field. When selected, the prompt text appears in the compose box instead of the title or description. | ||
| * The `prompt` field specifies the text that appears in the compose box for a prompt command. It supports up to 4,000 characters. | ||
|
|
||
| >[!NOTE] |
There was a problem hiding this comment.
Use required or similar above, not in a separate note block here. Are these fields not all required?
| > If you remove any commands from your manifest, you must redeploy your app to implement the changes. In general, any changes to the manifest require you to redeploy your app. | ||
|
|
||
| The following image illustrates an example of prompt suggestions: | ||
| The following image illustrates an example of prompt starters: |
There was a problem hiding this comment.
Move the images up close to the top of the section.
| Prompt starters reappear in the **View Prompts** flyout above the compose box during a conversation. They enable users to review the prompts while interacting with your bot. | ||
| After the user begins a conversation, the prompt starters will disappear from the conversation pane but remain available in the **View Prompts** flyout above the compose box, enabling users to review the prompts while interacting with your bot. | ||
|
|
||
| # [Personal chat](#tab/pc) |
There was a problem hiding this comment.
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. |
nickwalkmsft
changed the title
PoliCheck Scan ReportThe following report lists PoliCheck issues in PR files. Before you merge the PR, you must fix all severity-1 and severity-2 issues. 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 |
| > | ||
| > Your bot can either use a prompt starter or a welcome message. If your bot uses prompt starters, ensure that your bot doesn't send a welcome message. | ||
|
|
||
| Prompt starters are supported in one-on-one chats, group chats, and channels. To enable prompt starters, define the `commands` property in your bot's app manifest. Each command contains four fields: `title`, `description`, `type`, and `prompt`. |
There was a problem hiding this comment.
You need text that describes the UX of prompt starters and suggested actions (below). For suggested actions you do say that it involves buttons, but it should clearly describe when and where the buttons are placed.
|
Learn Build status updates of commit ac46680: ✅ Validation status: passed
For more details, please refer to the build report. |
| > | ||
| > `SuggestedActions` aren't supported for chat bots with attachments for any conversation type. | ||
|
|
||
| Here are some examples that show how to implement and experience suggested actions using `imBack` and `Action.Compose`: |
There was a problem hiding this comment.
This section needs to be much clearer and more completely describe what to do. What are imBack and Action.Compose?
|
|
||
| > [!NOTE] | ||
| > | ||
| > `SuggestedActions` aren't supported for chat bots with attachments for any conversation type. |
There was a problem hiding this comment.
What exactly does this mean? Not sure what "chat bots with attachments" refers to.
| * [Build bots for Teams](~/bots/what-are-bots.md) | ||
| * [App manifest schema for Teams](~/resources/schema/manifest-schema.md) | ||
| * [Messages in bot conversations](~/bots/how-to/conversations/conversation-messages.md) | ||
| * [Adaptive Cards for bot developers](/adaptive-cards/getting-started/bots) |
There was a problem hiding this comment.
| * [Adaptive Cards](https://adaptivecards.microsoft.com/) |
1 participant
@SharanGarcha-MSFT please review proposed changes and comments