Chia sẻ qua

executeEvent (bản xem trước)

Quan trọng

  • Đây là một tính năng xem trước.
  • Các tính năng xem trước không được dùng cho sản xuất và có thể có chức năng bị hạn chế. Các tính năng này 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.

Thực hiện chủ đề Microsoft Copilot Studio dựa trên Tên Sự kiện đã đăng ký. Trả về mảng kiểu MCSResponse.

Sẵn dùng cho

Ứng dụng dựa trên mô hình

Cú pháp

context.copilot.executeEvent(eventName, eventParameters).then(successCallback, errorCallback);

Tham số

Tên tham số Loại Bắt buộc Description
eventName chuỗi Có Tên Sự kiện đã đăng ký trong chủ đề Studio Copilot
eventParameters Không biết Có Các tham số cần thiết để thực hiện sự kiện. Những điều này phụ thuộc vào những gì chủ đề thực hiện.
successCallback Hàm Có Một hàm để gọi khi thao tác thành công.
errorCallback Hàm Có Một hàm để gọi khi hoạt động không thành công.

Trả về giá trị

Loại: Promise<MCSResponse>

Xem Promise và MCSResponse

Truy cập ngữ cảnh ứng dụng

Khi một API Đại lý được gọi, ngữ cảnh cho ứng dụng được chuyển đến chủ đề Studio Copilot thông qua một tập hợp các biến. Sau đây là các biến ngữ cảnh có sẵn dưới dạng Copilot Studio biến toàn cục.

Biến Description
Global.PA__Copilot_Model_PageContext.pageContext.id.guid ID của bản ghi bảng trên biểu mẫu chính
Global.PA__Copilot_Model_PageContext.pageContext.entityTypeName Tên logic của bảng trong trang chính
Global.PA__Copilot_Model_PageContext.pageContext.pageName Tên của trang chính
Global.PA__Copilot_Model_PageContext.pageContext.pageType Loại trang chính
Global.PA__Copilot_Model_AppUniqueNameContext.appUniqueNameContext.appUniqueName Tên duy nhất của ứng dụng dựa trên mô hình

Ví dụ: sử dụng Global.PA__Copilot_Model_PageContext.pageContext.id.guid và Global.PA__Copilot_Model_PageContext.pageContext.entityTypeName, có thể truy xuất bản ghi của biểu mẫu từ Dataverse.

Truy nhập eventParameters

Trong chủ đề Copilot Studio, có thể truy eventParameters cập từ lệnh gọi API bằng cách sử dụng biến .Activity.Value Sử dụng nút giá trị Phân tích cú pháp để chuyển đổi JSON thành bản ghi có một hoặc nhiều trường. Việc chọn Từ dữ liệu mẫu cho Kiểu dữ liệu cho phép cung cấp ví dụ về JSON để tạo bản ghi.

Ví dụ:

Trong Microsoft Copilot Studio, nơi một chủ đề được đăng ký chấp nhận ID (ID bản ghi thực thể) làm tham số đầu vào. Dựa trên dữ liệu nhập, nó truy xuất các hoạt động liên quan của bản ghi thực thể đó và trả về kết quả dưới dạng hoạt động sự kiện Copilot Studio. API ngữ cảnh PCF cho phép thực thi các phương pháp này trong ngữ cảnh của điều khiển PCF.

const response = await context.copilot.executeEvent( 
    "Microsoft.PowerApps.Copilot.RelatedActivities", 
    { id:"aaaaaaaa-0000-1111-2222-bbbbbbbbbbbb"});

Câu trả lời

[
    {
        "type": "event",
        "timestamp": "2025-02-05T16:05:53.4074714+00:00",
        "replyToId": "bbbbbbbb-1111-2222-3333-cccccccccccc",
        "attachments": [],
        "value": {
            "@odata.context": "https://*.dynamics.com/api/data/v9.2/$metadata#activitypointers(subject,prioritycode)",
            "value": [
                {
                    "@odata.etag": "W/\"6825587\"",
                    "@odata.type": "#Microsoft.Dynamics.CRM.phonecall",
                    "activityid": "cccccccc-2222-3333-4444-dddddddddddd",
                    "activitytypecode": "phonecall",
                    "prioritycode": 2,
                    "subject": "Discuss new opportunity (sample)"
                },
                {
                    "@odata.etag": "W/\"6826236\"",
                    "@odata.type": "#Microsoft.Dynamics.CRM.phonecall",
                    "activityid": "dddddddd-3333-4444-5555-eeeeeeeeeeee",
                    "activitytypecode": "phonecall",
                    "prioritycode": 2,
                    "subject": "Likes our new products (sample)"
                }
            ]
        },
        "name": "MS.CopilotApiDemo.RelatedActivities"
    }
]

Phi công phụ
executePrompt
Tham khảo API khung thành phần Power Apps
Tổng quan về khuôn khổ cấu phần Power Apps

  • Last updated on