Налаштування швидкого посібника

2025-03-04

Бібліотека швидких повідомлень — це колекція попередньо написаних, перевірених і оптимізованих підказок, призначених для формування взаємодії та реакцій чату Copilot. Вони гарантують, що чат Copilot надає актуальну, точну та контекстуально відповідну інформацію на основі потреб і вподобань користувача.

Важливо

Це функція попереднього перегляду.
Функції попереднього перегляду не призначені для використання в робочій версії та можуть мати обмежену функціональність. Ці функції регулюються додатковими умовами використання та доступні перед офіційним випуском, щоб клієнти могли отримати ранній доступ і залишити відгук.

У наведених нижче кроках докладно описано, як додати конкретні запити до посібника з підказок. Розділ Power Apps «Довідка » додано до існуючого готового посібника з підказок Copilot. Крім того, ви можете скопіювати зразок коду в нову тему безпосередньо зі зразка теми налаштувань Prompt guide. Усі підказки, які відображаються кінцевому користувачеві в посібнику з підказок, зберігаються в агенті, Copilot Studio який використовується для програми.

Відкрийте агента, який підтримує додаток Copilot Studio , і додайте нову порожню тему.
Перейменуйте тему, щоб вона відповідала її меті, і змініть активатор теми на Подія отримана.
Виберіть «Редагувати » в розділі «Отримано подію», а потім встановіть назву події як Microsoft.PowerApps.Copilot.RequestSparks, яка є зарезервованою назвою для керівництва по запиту.
За бажанням ви можете встановити умови для надсилання записів, якщо вони стосуються назви програми, контексту сторінки тощо. Наприклад, цей запис запиту перевіряє, чи збігається унікальне ім'я поточної програми або назва типу контексту таблиці сторінки з указаними значеннями. Якщо будь-яка з умов виконується, активується чат Copilot.

condition: =Global.PA_Copilot_Model_SessionContext.appUniqueName = "yourAppName" or Global.PA__Copilot_Model_PageContext.pageContext.entityTypeName = "Entity name"
У розділі Пріоритет додайте відповідне значення пріоритету, щоб активатор запускався після тем із вищим пріоритетом. Значення пріоритету можуть мати діапазон від 0 до 10K, де 0 є найвищим. Хоча рекомендується близько 200, оскільки це дозволяє додати більше пріоритетних тем пізніше, у цьому прикладі використовується 10.
Виберіть + пункт Отримано подію, а потім виберіть Значення> аналізу керування змінними, щоб додати наступний крок для значення аналізу керування змінними.

Вставте наведену нижче Power Fx формулу в поле значення Аналіз, а потім натисніть кнопку Вставити.

[{displayName:"Power Apps Help",displaySubtitle:"Power Apps Help",iconName:"List24Regular",sparks:[{displayName:"What is Copilot chat?",type:"PromptText"},{displayName:"How can I use the record picker?",type:"PromptText"},{displayName:"What types of questions can I ask Copilot?",type:"PromptText"},{displayName:"How do I provide feedback on Copilot’s responses?",type:"PromptText"}]}]

Встановіть тип даних як Таблиця. З'явиться посилання Редагувати схему .

Виберіть Редагувати схему та вставте наведену нижче схему, а потім натисніть Підтвердити .

kind: Table
properties:
  displayName: String
  displaySubtitle: String
  iconName: String
  sparks:
    type:
      kind: Table
      properties:
        displayName: String
        eventName: String
        iconName: String
        payload: String
        type: String

Встановіть Зберегти як , щоб зберегти як нову користувацьку змінну, і назвіть її щось значуще, наприклад SparkGroupCustom.
Виберіть + на кроці Парсичний параметр Значення аналізу , а потім виберіть пункт Керування змінними Встановити значення> змінної.
Визначення sparks зберігається в глобальній змінній, тому вам потрібно встановити змінну Global та назвати її PA_Copilot_Sparks.sparkGroups та/або Global.PA_Copilot_Sparks.sparks. Це заповнить випадаюче вікно вашими підказками. Далі додайте крок для встановлення значення змінної.
Знайдіть ім'я визначення sparks з попереднього кроку, наприклад Global.PA_Copilot_Sparks.sparkGroups, і встановіть значення на наступну Power Fx функцію злиття.
```
ForAll(Sequence(CountRows(Global.PA_Copilot_Sparks.sparkGroups)+CountRows(Topic.SparkGroupCustom)), If(Value<=CountRows(Global.PA_Copilot_Sparks.sparkGroups),Index (Global.PA_Copilot_Sparks.sparkGroups,Value), Index(Topic.SparkGroupCustom, Value - CountRows(Global.PA_Copilot_Sparks.sparkGroups))))
```
Об'єднати

Замініть ім'я змінної на ім'я змінної, яке ви використовували для користувацьких підказок, яке в цьому прикладі називається SparkGroupCustom.
Опублікуйте агента та відтворіть додаток.

Зразок теми підказкового посібника з налаштувань

Ось повний код теми, який можна скопіювати безпосередньо в нову тему.

kind: AdaptiveDialog
beginDialog:
  kind: OnEventActivity
  id: main
  priority: 200
  eventName: Microsoft.PowerApps.Copilot.RequestSparks
  actions:
    - kind: ParseValue
      id: iCepPf
      variable: Topic.SparkGroupCustom
      valueType:
        kind: Table
        properties:
          displayName: String
          displaySubtitle: String
          iconName: String
          sparks:
            type:
              kind: Table
              properties:
                displayName: String
                eventName: String
                iconName: String
                payload: String
                type: String
      value: |-
        =[{displayName:"Power Apps Help",displaySubtitle:"Power Apps Help",iconName:"List24Regular",
        sparks:[
        {displayName:"What is Copilot chat?",type:"PromptText"},
        {displayName:"How can I use the record picker?",type:"PromptText"},
        {displayName:"What types of questions can I ask Copilot?",type:"PromptText"},
        {displayName:"How do I provide feedback on Copilot’s responses?",type:"PromptText"}
        ]}]

    - kind: SetVariable
      id: setVariable_pDu9cr
      variable: Global.PA_Copilot_Sparks.sparkGroups
      value: =ForAll(Sequence(CountRows(Global.PA_Copilot_Sparks.sparkGroups)+CountRows(Topic.SparkGroupCustom)), If(Value<=CountRows(Global.PA_Copilot_Sparks.sparkGroups),Index (Global.PA_Copilot_Sparks.sparkGroups,Value), Index(Topic.SparkGroupCustom, Value - CountRows(Global.PA_Copilot_Sparks.sparkGroups))))

Нотатка

Якщо ваш агент підтримує кілька мов і потребує швидкого перекладу посібника, усі рядки запитань, що стикаються з користувачем, повинні бути встановлені за допомогою a SetTextVariable.

Поділитися через

Налаштування швидкого посібника

Зразок теми підказкового посібника з налаштувань

Зворотний зв’язок

Додаткові ресурси