Tùy chỉnh hướng dẫn nhanh chóng

2025-03-04

Thư viện lời nhắc là tập hợp các lời nhắc được viết sẵn, thử nghiệm và tối ưu hóa, được thiết kế để giúp định hình các tương tác và phản hồi của cuộc trò chuyện Copilot. Họ đảm bảo rằng cuộc trò chuyện Copilot cung cấp thông tin có liên quan, chính xác và phù hợp với ngữ cảnh dựa trên nhu cầu và sở thích của người dùng.

Quan trọng

Đây là một tính năng xem trước.
Tính năng xem trước không dành cho mục đích sử dụng sản xuất và có thể có chức năng hạn chế. Các tính năng này phải tuân theo các điều khoản sử dụng bổ sung và có sẵn trước khi phát hành chính thức để khách hàng có thể truy cập sớm và cung cấp phản hồi.

Các bước sau đây trình bày chi tiết cách thêm các truy vấn cụ thể vào hướng dẫn nhắc nhở. Phần Power Apps Trợ giúp được thêm vào hướng dẫn nhắc nhở Copilot có sẵn hiện có. Ngoài ra, bạn có thể sao chép mã mẫu vào chủ đề mới trực tiếp từ mẫu chủ đề tùy chỉnh hướng dẫn Nhắc nhở. Tất cả các lời nhắc hiển thị cho người dùng cuối thông qua hướng dẫn lời nhắc đều được lưu trữ trong tác nhân được sử dụng cho ứng dụng. Copilot Studio

Mở tác nhân hỗ trợ ứng dụng trong Copilot Studio và thêm một chủ đề trống mới.
Đổi tên chủ đề để phản ánh mục đích của chủ đề và thay đổi trình kích hoạt chủ đề thành Sự kiện đã nhận.
Chọn Chỉnh sửa trong Sự kiện đã nhận, sau đó đặt tên sự kiện là Microsoft.PowerApps.Copilot.RequestSparks, đây là tên dành riêng cho hướng dẫn nhắc nhở.
Tùy chọn, bạn có thể đặt điều kiện để nhắc nhập liệu trong trường hợp chúng liên quan cụ thể đến tên ứng dụng, ngữ cảnh trang, v.v. Ví dụ: mục nhắc này sẽ kiểm tra xem tên duy nhất của ứng dụng hiện tại hay tên loại bảng của ngữ cảnh trang có khớp với các giá trị đã chỉ định hay không. Nếu một trong hai điều kiện trên là đúng, trò chuyện Copilot sẽ được kích hoạt.

condition: =Global.PA_Copilot_Model_SessionContext.appUniqueName = "yourAppName" or Global.PA__Copilot_Model_PageContext.pageContext.entityTypeName = "Entity name"
Trong Ưu tiên, hãy thêm giá trị ưu tiên phù hợp để kích hoạt sau các chủ đề có mức độ ưu tiên cao hơn. Giá trị ưu tiên có thể nằm trong phạm vi từ 0 đến 10K, trong đó 0 là giá trị cao nhất. Mặc dù khuyến nghị khoảng 200 vì nó cho phép có nhiều lựa chọn hơn để thêm các chủ đề có mức độ ưu tiên cao hơn sau này, nhưng trong ví dụ này, chúng tôi sử dụng 10.
Chọn + trong Sự kiện đã nhận, sau đó chọn Quản lý biến>Phân tích giá trị để thêm bước tiếp theo cho giá trị phân tích quản lý biến.

Dán công thức sau vào hộp Power Fx Phân tích giá trị , sau đó chọn Chèn.

[{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"}]}]

Đặt Kiểu dữ liệu là Bảng. Liên kết Chỉnh sửa lược đồ sẽ xuất hiện.

Chọn Chỉnh sửa lược đồ và dán lược đồ sau, sau đó chọn Xác nhận.

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

Đặt Lưu thành để lưu thành biến tùy chỉnh mới và đặt tên có ý nghĩa như SparkGroupCustom.
Chọn + trong bước Phân tích giá trị , sau đó chọn Quản lý biến>Đặt giá trị biến.
Định nghĩa tia lửa được lưu trong một biến toàn cục nên bạn cần đặt biến Toàn cục và đặt tên cho biến đó PA_Copilot_Sparks.sparkGroups và/hoặc Global.PA_Copilot_Sparks.sparks. Thao tác này sẽ điền các lời nhắc của bạn vào cửa sổ thả xuống. Tiếp theo, thêm một bước để thiết lập giá trị biến.
Tìm kiếm tên định nghĩa tia lửa từ bước trước, chẳng hạn như Global.PA_Copilot_Sparks.sparkGroups và đặt giá trị thành hàm Power Fx merge sau.
```
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))))
```
Hợp nhất

Thay thế tên biến bằng tên biến mà bạn đã sử dụng cho lời nhắc tùy chỉnh, trong ví dụ này là SparkGroupCustom.
Xuất bản tác nhân và chạy ứng dụng.

Mẫu chủ đề tùy chỉnh hướng dẫn nhanh

Sau đây là mã chủ đề đầy đủ, có thể sao chép trực tiếp vào chủ đề mới.

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))))

Lưu ý

Nếu tác nhân của bạn hỗ trợ nhiều ngôn ngữ và cần dịch hướng dẫn nhanh chóng, tất cả các chuỗi câu hỏi hướng tới người dùng của bạn phải được đặt bằng cách sử dụng SetTextVariable.

Chia sẻ qua

Tùy chỉnh hướng dẫn nhanh chóng

Mẫu chủ đề tùy chỉnh hướng dẫn nhanh

Phản hồi

Tài nguyên bổ sung