Заметка
Доступ к этой странице требует авторизации. Вы можете попробовать войти в систему или изменить каталог.
Доступ к этой странице требует авторизации. Вы можете попробовать сменить директорию.
[Данный раздел посвящен предварительному выпуску и может быть изменен.]
Интерфейс с нулевым запросом помогает создателям повысить вовлеченность пользователей и упростить взаимодействие в начале сеанса чата Copilot Chat. При демонстрации адаптивной карточки с нулевыми запросами в начале сеанса чата пользователи сразу получают релевантную информацию и варианты, что уменьшает необходимость в дополнительных запросах и итерациях. Интерфейс с нулевыми запросами может учитывать контекст и, следовательно, показываться выборочно для целевых страниц.
Это важно
- Это предварительная версия функции.
- Предварительные версии функций не предназначены для использования в рабочей среде и могут иметь ограниченные функциональные возможности. Для этих функций действуют дополнительные условия использования и они доступны перед официальным выпуском, чтобы клиенты могли досрочно получить доступ и предоставить отзывы.
Настройка интерфейса с нулевыми запросами
В этих шагах описывается, как настроить взаимодействие без запросов.
Откройте агент, поддерживающий приложение, в Copilot Studio и добавьте новую пустую тему.
Переименуйте тему, чтобы она отражала намерение темы, и измените триггер темы на Получено событие.
Выберите Изменить в разделе Получено событие, затем задайте имя события
Microsoft.PowerApps.Copilot.RequestZeroPrompt, которое зарезервировано для интерфейса с нулевым запросом. Задайте приоритет выше 99, но ниже 100000. Приоритет важен, так как пользовательские интерфейсы с нулевыми запросам должны переопределять интерфейсы, предоставляемые платформой по умолчанию.
По желанию можно также задать условия для интерфейса без запроса, если это относится к контексту страницы. Например, эта запись проверяет, совпадает ли имя типа таблицы контекста страницы с учетной записью. Если условие истинно, отображается пользовательский интерфейс с нулевым запросом.
condition:Global.PA__Copilot_Model_PageContext.pageContext.entityTypeName = "account"После этого шага вы можете создавать сообщения с нулевым запросом с помощью адаптивных карточек. Дополнительные сведения о создании адаптивных карточек см. в следующей статье: https://adaptivecards.microsoft.com/ Если у вас есть карточки интерфейс с нулевым запросом, вы можете задать глобальную переменнуюGlobal.PA_Copilot_ZeroPromptдля определения адаптивной карточки.Нулевой запрос включает в себя всю гибкость адаптивных карточек, и вы можете активировать различные навыки из него. Если адаптивная карточка содержит кнопку или что-либо, для чего требуется
Action.Submit, есть несколько вариантов, которые можно использовать для обработки этого события. Эти обработчики событий вызываютсяSkillTypes.Action.Submitтипы должны содержать следующие свойства: объект данных со свойствамиSkillTypeи сценария. Вы можете использоватьMCSMessageSkill, которые напрямую отправляются в Copilot Studio в качестве пользовательских сообщений илиPromptTextSkillкогда вы хотите заполнить поле ввода чата .PromptTextSkillполезно, если требуется дополнительный вход от пользователя, например указание записи или имени таблицы среди прочего. Например:How many [table name] are active?What are the [table name] assigned to me?При запуске нулевых подсказок выберите структуру действия, которая должна быть аналогична той, что приведена здесь. Значение сценария должно быть
ZeroPromptCardвместе с исходным значениемZeroPrompt. Наконец, значение соответствует текущему запросу.
selectAction: {
type: "Action.Submit",
data: {
scenario: "ZeroPromptCard",
skillType: "MCSMessageSkill",
value: "What are accounts in Redmond?",
source: "ZeroPrompt"
}
},
Пример темы интерфейса с нулевым запросом
Ниже приведен полный код темы, который можно скопировать непосредственно в новую тему. Вы можете редактировать вопросы интерфейса с нулевым запросом в указанных здесь настройках и повторно использовать готовые карточки.
kind: AdaptiveDialog
beginDialog:
kind: OnEventActivity
id: main
condition: =Global.PA__Copilot_Model_PageContext.pageContext.entityTypeName = "account"
priority: 100
eventName: Microsoft.PowerApps.Copilot.RequestZeroPrompt
actions:
- kind: SetVariable
id: setVariable_acI6It
variable: Topic.WelcomeMessage
value: Welcome to the Zero Prompt Experience
- kind: SetTextVariable
id: setTextVariable_g4rSG0
variable: Topic.FooterMessage
value: This is custom ZPE footer message
- kind: SetVariable
id: setVariable_QUoZ5c
variable: Topic.OverviewIcon
value: "=\"data:image/svg+xml;base64,PHN2ZyB3aWR0aD0iMjAiIGhlaWdodD0iMjAiIHZpZXdCb3g9IjAgMCAyMCAyMCIgZmlsbD0ibm9uZSIgeG1sbnM9Imh0dHA6Ly93d3cudzMub3JnLzIwMDAvc3ZnIj4NCjxwYXRoIGQ9Ik0zLjUgNEMyLjY3MTU3IDQgMiA0LjY3MTU3IDIgNS41VjcuNUMyIDguMzI4NDMgMi42NzE1NyA5IDMuNSA5SDUuNUM2LjMyODQzIDkgNyA4LjMyODQzIDcgNy41VjUuNUM3IDQuNjcxNTcgNi4zMjg0MyA0IDUuNSA0SDMuNVpNMyA1LjVDMyA1LjIyMzg2IDMuMjIzODYgNSAzLjUgNUg1LjVDNS43NzYxNCA1IDYgNS4yMjM4NiA2IDUuNVY3LjVDNiA3Ljc3NjE0IDUuNzc2MTQgOCA1LjUgOEgzLjVDMy4yMjM4NiA4IDMgNy43NzYxNCAzIDcuNVY1LjVaTTkuNSA1QzkuMjIzODYgNSA5IDUuMjIzODYgOSA1LjVDOSA1Ljc3NjE0IDkuMjIzODYgNiA5LjUgNkgxNy41QzE3Ljc3NjEgNiAxOCA1Ljc3NjE0IDE4IDUuNUMxOCA1LjIyMzg2IDE3Ljc3NjEgNSAxNy41IDVIOS41Wk05LjUgN0M5LjIyMzg2IDcgOSA3LjIyMzg2IDkgNy41QzkgNy43NzYxNCA5LjIyMzg2IDggOS41IDhIMTUuNUMxNS43NzYxIDggMTYgNy43NzYxNCAxNiA3LjVDMTYgNy4yMjM4NiAxNS43NzYxIDcgMTUuNSA3SDkuNVpNMy41IDExQzIuNjcxNTcgMTEgMiAxMS42NzE2IDIgMTIuNVYxNC41QzIgMTUuMzI4NCAyLjY3MTU3IDE2IDMuNSAxNkg1LjVDNi4zMjg0MyAxNiA3IDE1LjMyODQgNyAxNC41VjEyLjVDNyAxMS42NzE2IDYuMzI4NDMgMTEgNS41IDExSDMuNVpNMyAxMi41QzMgMTIuMjIzOSAzLjIyMzg2IDEyIDMuNSAxMkg1LjVDNS43NzYxNCAxMiA2IDEyLjIyMzkgNiAxMi41VjE0LjVDNiAxNC43NzYxIDUuNzc2MTQgMTUgNS41IDE1SDMuNUMzLjIyMzg2IDE1IDMgMTQuNzc2MSAzIDE0LjVWMTIuNVpNOS41IDEyQzkuMjIzODYgMTIgOSAxMi4yMjM5IDkgMTIuNUM5IDEyLjc3NjEgOS4yMjM4NiAxMyA5LjUgMTNIMTcuNUMxNy43NzYxIDEzIDE4IDEyLjc3NjEgMTggMTIuNUMxOCAxMi4yMjM5IDE3Ljc3NjEgMTIgMTcuNSAxMkg5LjVaTTkuNSAxNEM5LjIyMzg2IDE0IDkgMTQuMjIzOSA5IDE0LjVDOSAxNC43NzYxIDkuMjIzODYgMTUgOS41IDE1SDE1LjVDMTUuNzc2MSAxNSAxNiAxNC43NzYxIDE2IDE0LjVDMTYgMTQuMjIzOSAxNS43NzYxIDE0IDE1LjUgMTRIOS41WiIgZmlsbD0iIzcwNzA3MCIvPg0KPC9zdmc+\""
- kind: SetVariable
id: setVariable_zeAjbE
variable: Topic.ClockIcon
value: "=\"data:image/svg+xml;base64,PHN2ZyB3aWR0aD0iMjAiIGhlaWdodD0iMjAiIHZpZXdCb3g9IjAgMCAyMCAyMCIgZmlsbD0ibm9uZSIgeG1sbnM9Imh0dHA6Ly93d3cudzMub3JnLzIwMDAvc3ZnIj4NCjxwYXRoIGQ9Ik0xMCA2LjUwMDEyQzEwIDYuMjIzOTggOS43NzYxNCA2LjAwMDEyIDkuNSA2LjAwMDEyQzkuMjIzODYgNi4wMDAxMiA5IDYuMjIzOTggOSA2LjUwMDEyVjEwLjUwMDFDOSAxMC43NzYzIDkuMjIzODYgMTEuMDAwMSA5LjUgMTEuMDAwMUgxMi41QzEyLjc3NjEgMTEuMDAwMSAxMyAxMC43NzYzIDEzIDEwLjUwMDFDMTMgMTAuMjI0IDEyLjc3NjEgMTAuMDAwMSAxMi41IDEwLjAwMDFIMTBWNi41MDAxMlpNMy4zNTI3MSA3Ljc5OTk4QzIuNTM0ODEgNy4yMjM4MSAyIDYuMjY3ODIgMiA1LjE4NzA1QzIgMy40MzA2NyAzLjQxMzUzIDIgNS4xNjU2MiAyQzYuMjQyNzQgMiA3LjE5MjE4IDIuNTQxNTEgNy43NjMxNCAzLjM2NTAxQzguNDY1NTMgMy4xMjgzIDkuMjE3NzggMyAxMCAzQzEwLjc3OTQgMyAxMS41MjkgMy4xMjczNyAxMi4yMjkyIDMuMzYyNDNDMTIuODAxIDIuNTM5OTcgMTMuNzUyNiAyIDE0LjgzMTEgMkMxNi41ODIzIDIgMTcuOTk5OSAzLjQyMjY4IDE3Ljk5OTkgNS4xNzUxNkMxNy45OTk5IDYuMjU0NzIgMTcuNDYyIDcuMjA4MjkgMTYuNjQxMiA3Ljc4MTU5QzE2Ljg3MzkgOC40Nzg3IDE3IDkuMjI0NjMgMTcgMTBDMTcgMTEuNzUzIDE2LjM1NTYgMTMuMzU1NSAxNS4yOTA4IDE0LjU4MzZMMTYuODUzNiAxNi4xNDYzQzE3LjA0ODggMTYuMzQxNiAxNy4wNDg4IDE2LjY1ODIgMTYuODUzNiAxNi44NTM0QzE2LjY1ODMgMTcuMDQ4NyAxNi4zNDE3IDE3LjA0ODcgMTYuMTQ2NCAxNi44NTM0TDE0LjU4MzcgMTUuMjkwN0MxMy4zNTU2IDE2LjM1NTYgMTEuNzUzMSAxNyAxMCAxN0M4LjI0Njk2IDE3IDYuNjQ0NDQgMTYuMzU1NiA1LjQxNjM4IDE1LjI5MDdMMy44NTM1NiAxNi44NTM2QzMuNjU4MyAxNy4wNDg5IDMuMzQxNzIgMTcuMDQ4OSAzLjE0NjQ1IDE2Ljg1MzZDMi45NTExOSAxNi42NTg0IDIuOTUxMTggMTYuMzQxOCAzLjE0NjQ0IDE2LjE0NjVMNC43MDkyNyAxNC41ODM2QzMuNjQ0NDEgMTMuMzU1NiAzIDExLjc1MyAzIDEwQzMgOS4yMzE0NCAzLjEyMzg2IDguNDkxODEgMy4zNTI3MSA3Ljc5OTk4Wk0zIDUuMTg3MDVDMyA1Ljg0OTE1IDMuMjkwOTggNi40NDE4NiAzLjc1MDcxIDYuODQyODZDNC40MTk0NiA1LjUyMTc0IDUuNDk0ODMgNC40NDEzNiA2LjgxMjIyIDMuNzY2MzJDNi40MTQwOSAzLjI5NjExIDUuODIzMjYgMyA1LjE2NTYyIDNDMy45NzMzNSAzIDMgMy45NzUzOSAzIDUuMTg3MDVaTTE2LjI0MTYgNi44Mjc2NEMxNi43MDYyIDYuNDI4NDEgMTYuOTk5OSA1LjgzNjE2IDE2Ljk5OTkgNS4xNzUxNkMxNi45OTk5IDMuOTcyNzMgMTYuMDI3OCAzIDE0LjgzMTEgM0MxNC4xNzE0IDMgMTMuNTc5NyAzLjI5NTMgMTMuMTgxMyAzLjc2MzAyQzE0LjQ5NjYgNC40MzUyNCAxNS41NzEyIDUuNTExMjggMTYuMjQxNiA2LjgyNzY0Wk00IDEwQzQgMTMuMzEzNyA2LjY4NjI5IDE2IDEwIDE2QzEzLjMxMzcgMTYgMTYgMTMuMzEzNyAxNiAxMEMxNiA2LjY4NjI5IDEzLjMxMzcgNCAxMCA0QzYuNjg2MjkgNCA0IDYuNjg2MjkgNCAxMFoiIGZpbGw9IiM3MDcwNzAiLz4NCjwvc3ZnPg==\""
- kind: SetVariable
id: setVariable_i1e9qL
variable: Topic.ExclamationIcon
value: "=\"data:image/svg+xml;base64,PHN2ZyB3aWR0aD0iMjAiIGhlaWdodD0iMjAiIHZpZXdCb3g9IjAgMCAyMCAyMCIgZmlsbD0ibm9uZSIgeG1sbnM9Imh0dHA6Ly93d3cudzMub3JnLzIwMDAvc3ZnIj4NCjxwYXRoIGQ9Ik0xMCAyQzE0LjQxODMgMiAxOCA1LjU4MTcyIDE4IDEwQzE4IDE0LjQxODMgMTQuNDE4MyAxOCAxMCAxOEM1LjU4MTcyIDE4IDIgMTQuNDE4MyAyIDEwQzIgNS41ODE3MiA1LjU4MTcyIDIgMTAgMlpNMTAgM0M2LjEzNDAxIDMgMyA2LjEzNDAxIDMgMTBDMyAxMy44NjYgNi4xMzQwMSAxNyAxMCAxN0MxMy44NjYgMTcgMTcgMTMuODY2IDE3IDEwQzE3IDYuMTM0MDEgMTMuODY2IDMgMTAgM1pNMTAgMTIuNUMxMC40MTQyIDEyLjUgMTAuNzUgMTIuODM1OCAxMC43NSAxMy4yNUMxMC43NSAxMy42NjQyIDEwLjQxNDIgMTQgMTAgMTRDOS41ODU3OSAxNCA5LjI1IDEzLjY2NDIgOS4yNSAxMy4yNUM5LjI1IDEyLjgzNTggOS41ODU3OSAxMi41IDEwIDEyLjVaTTEwIDZDMTAuMjQ1NSA2IDEwLjQ0OTYgNi4xNzY4OCAxMC40OTE5IDYuNDEwMTJMMTAuNSA2LjVWMTFDMTAuNSAxMS4yNzYxIDEwLjI3NjEgMTEuNSAxMCAxMS41QzkuNzU0NTQgMTEuNSA5LjU1MDM5IDExLjMyMzEgOS41MDgwNiAxMS4wODk5TDkuNSAxMVY2LjVDOS41IDYuMjIzODYgOS43MjM4NiA2IDEwIDZaIiBmaWxsPSIjNzA3MDcwIi8+DQo8L3N2Zz4=\""
- kind: SetVariable
id: setVariable_x6BNry
variable: Topic.OptionOne
value: "={skillType: \"PromptTextSkill\", optionGroup: \"Redmond Accounts!\", prompt: \"What are the accounts located in Redmond?\" }"
- kind: SetVariable
id: setVariable_4jjXcz
variable: Topic.OptionTwo
value: "={skillType: \"MCSMessageSkill\", optionGroup: \"Missing Phone Numbers\", prompt: \"Which accounts have missing phone numbers?\" }"
- kind: SetVariable
id: setVariable_DzjFpB
variable: Topic.OptionThree
value: "={skillType: \"MCSMessageSkill\", optionGroup: \"Active Accounts\", prompt: \"How many active accounts are there?\" }"
- kind: SetVariable
id: setVariable_q8Ne5M
variable: Global.PA_Copilot_ZeroPrompt
value: |-
={
type: "AdaptiveCard",
body: [
{
type: "ColumnSet",
id: "ms-platform-zpe-columnsetheader-dc291457-0726-4472-9264-ab644fe9b13e",
columns: [
{
type: "Column",
items: [
{
type: "TextBlock",
wrap: true,
text: "Hi "&System.User.FirstName&","
},
{
type: "TextBlock",
wrap: true,
text: ""&Topic.WelcomeMessage&"",
id: "ms-platform-zpe-header-74453ffe-b4e3-4c81-9a6c-5c03dc4a3661",
spacing: "Medium"
},
]
}
]
},
{
type: "Container",
id: "ms-platform-zpe-actionscontainer-d44c003a-b977-4e0b-a3fc-f8d30d60110b",
isVisible: ""&!IsBlank(Topic.OptionOne.prompt)&"",
showBorder: true,
roundedCorners: true,
selectAction: {
type: "Action.Submit",
data: {
scenario: "ZeroPromptCard",
skillType: Topic.OptionOne.skillType,
value: ""&Topic.OptionOne.prompt&"",
source: "ZeroPrompt"
}
},
items: [
{
type: "ColumnSet",
columns: [
{
type: "Column",
width: "auto",
items: [
{
type: "Image",
url: ""&Topic.ExclamationIcon&"",
altText: ""&Topic.OptionOne.optionGroup&""
}
]
},
{
type: "Column",
width: "stretch",
items: [
{
type: "TextBlock",
text: ""&Topic.OptionOne.optionGroup&"",
weight: "bolder"
},
{
type: "TextBlock",
text: ""&Topic.OptionOne.prompt&""
}
]
}
]
}
]
},
{
type: "Container",
id: "ms-platform-zpe-actionscontainer-477da7ce-bd52-4870-a8c2-04071daa56e2",
isVisible: ""&!IsBlank(Topic.OptionTwo.prompt)&"",
showBorder: true,
roundedCorners: true,
selectAction: {
type: "Action.Submit",
data: {
scenario: "ZeroPromptCard",
skillType: Topic.OptionTwo.skillType,
value: ""&Topic.OptionTwo.prompt&"",
source: "ZeroPrompt"
}
},
items: [
{
type: "ColumnSet",
columns: [
{
type: "Column",
width: "auto",
items: [
{
type: "Image",
url: ""&Topic.ClockIcon&"",
altText: ""&Topic.OptionTwo.optionGroup&""
}
]
},
{
type: "Column",
width: "stretch",
items: [
{
type: "TextBlock",
text: ""&Topic.OptionTwo.optionGroup&"",
weight: "bolder"
},
{
type: "TextBlock",
text: ""&Topic.OptionTwo.prompt&""
}
]
}
]
}
]
},
{
type: "Container",
id: "ms-platform-zpe-actionscontainer-ff8b54c0-ba5a-435f-a66f-3978115ef39a",
isVisible: ""&!IsBlank(Topic.OptionThree.prompt)&"",
showBorder: true,
roundedCorners: true,
selectAction: {
type: "Action.Submit",
data: {
scenario: "ZeroPromptCard",
skillType: Topic.OptionThree.skillType,
value: ""&Topic.OptionThree.prompt&"",
source: "ZeroPrompt"
}
},
items: [
{
type: "ColumnSet",
columns: [
{
type: "Column",
width: "auto",
items: [
{
type: "Image",
url: ""&Topic.OverviewIcon&"",
altText: ""&Topic.OptionThree.optionGroup&""
}
]
},
{
type: "Column",
width: "stretch",
items: [
{
type: "TextBlock",
text: ""&Topic.OptionThree.optionGroup&"",
weight: "bolder"
},
{
type: "TextBlock",
text: ""&Topic.OptionThree.prompt&""
}
]
}
]
}
]
},
{
type: "Container",
id: "ms-platform-zpe-collapsed-footer-79fb882f-ec4e-4abd-bc65-8c523849da40",
items: [
{
type: "ColumnSet",
columns: [
{
type: "Column",
width: "auto",
items: [
{
type: "TextBlock",
wrap: true,
text: ""&Topic.FooterMessage&"",
id: "fsFooterId"
},
]
}
]
},
]
},
],
'$schema': "http://adaptivecards.io/schemas/adaptive-card.json",
version: "1.5"
}