Gỡ lỗi và di chuyển flow giữa các môi trường

Hãy tin vào bằng chứng chứ không phải cảm xúc

Bài 6 cung cấp cho bạn các đường dẫn lỗi trong flow và những thông báo lỗi trung thực. Nhưng việc xử lý lỗi chỉ có tác dụng nếu bạn có thể thấy điều gì đã xảy ra. “Nó không hoạt động” là một cảm giác; bản ghi lần chạy có bước màu đỏ và thông tin đầu vào được ghi lại là chẩn đoán. Bài học này nói về bằng chứng - và sau đó là về việc chuyển flow của bạn đến môi trường nơi nó thực sự tồn tại.

Flow có 3 tab - Tìm hiểu những gì mỗi tab nắm giữ

Mở bất kỳ agent flow nào trong Copilot Studio và bạn nhận được 3 tab bên cạnh Designer:

Overview - Thẻ nhận dạng của flow: tên, mô tả, chủ sở hữu và người đồng sở hữu, các kết nối của flow, các lần chạy gần đây và nút bật/tắt. Bạn đã kiểm tra các kết nối ở đây trong Bài học 4; nó vẫn là điểm dừng đầu tiên của bạn khi thông tin xác thực hoạt động sai.

Activity - Lịch sử chạy. Mỗi lần chạy đều có trạng thái và thời lượng; chọn một để thực hiện từng bước hành động và xem chính xác vị trí dừng cũng như dữ liệu mà mỗi bước nắm giữ. Chạy nhiều lựa chọn để gửi lại hoặc hủy những lựa chọn vẫn đang được tiến hành. Tab này gần như theo thời gian thực, điều này khiến nó trở thành nguồn thông tin đáng tin cậy trong quá trình gỡ lỗi.

Analytics - số lần chạy, tỷ lệ thất bại, xu hướng. Hữu ích hàng tuần, gây hiểu lầm từng phút: các lần chạy mất tới 30 phút để xuất hiện trong hình ảnh trực quan, xu hướng được thực hiện bởi hành động sẽ làm mới khoảng 24 giờ một lần và số liệu phân tích lần chạy chỉ bao gồm những flow giải pháp. Khi Activity và Analytics không đồng ý, hãy tin vào Activity.

Ngoài ra còn có Version history trên menu trên cùng của Designer - mọi lần lưu đều được ghi lại, nhóm theo ngày, với các phiên bản đã xuất bản được đánh dấu. Lưu bản nháp khi bạn làm việc; lịch sử được xây dựng từ những lần lưu, và việc mở được "bản vẫn chạy" đã giải cứu được nhiều buổi chiều.

Vai trò của yếu tố agent trong câu chuyện

Lịch sử chạy cho bạn biết flow đã làm gì. Để biết agent đã làm gì với nó, hãy sử dụng các công cụ mà bạn biết từ bài học đầu tiên: Trong khung kiểm tra, Activity map hiển thị kế hoạch của từng lượt trò chuyện - công cụ nào mà orchestrator đã chọn, thông tin đầu vào mà nó điền vào, kết quả đầu ra mà nó nhận được. Một flow có thể thành công trong khi agent bỏ qua đầu ra của nó; chỉ có phía agent mới tiết lộ điều đó. Đối với các cuộc trò chuyện trước đây trong thực tế, trang Activity của agent sẽ lưu giữ những hoạt động lịch sử bằng các bộ lọc như Failed và Completed.

Quá trình gỡ lỗi, theo thứ tự: Bản đồ hoạt động (có kích hoạt đúng công cụ, với đầu vào phù hợp không?) → flow tab Activity (điều gì đã xảy ra bên trong?) → Kết nối tổng quan (với tư cách là ai?).

Giải pháp: Flow di chuyển như thế nào?

Cho đến nay mọi thứ đều tồn tại ở nơi bạn đã xây dựng nó. Các hoạt động triển khai thực sự tách biệt nơi bạn xây dựng với nơi đồng nghiệp sử dụng - môi trường phát triển và môi trường sản xuất - và phương tiện giữa chúng chính là giải pháp: Một gói chứa flow của bạn cộng với các thành phần mà nó phụ thuộc vào.

Các flow được xây dựng từ Copilot Studio đã nhận biết được giải pháp (đó là một phần lý do tại sao chúng hiển thị dưới dạng công cụ). Điều khiến một giải pháp có thể mang theo được chính là những gì bạn đã học được trong Bài học 3–6, gói gọn một cách có chủ ý:

Hai yếu tố giúp quá trình triển khai diễn ra suôn sẻ. Các tham chiếu kết nối (Bài 4) đảm bảo rằng khi nhập giải pháp, hệ thống sẽ hỏi "tham chiếu SharePoint này nên sử dụng kết nối nào ở môi trường sản xuất?" thay vì chuyển giao thông tin xác thực từ môi trường phát triển của bạn. Các biến môi trường lưu trữ những cấu hình thay đổi tùy theo môi trường - chẳng hạn như URL trang web hay tên danh sách - nhờ đó flow sẽ đọc giá trị từ biến, còn bạn chỉ cần thiết lập giá trị cho môi trường sản xuất ngay khi nhập mà không cần chỉnh sửa trực tiếp bên trong flow. Việc sử dụng các URL được hardcode chính là nguyên nhân khiến các flow ở môi trường phát triển vô tình ghi dữ liệu vào danh sách ở môi trường phát triển ngay cả khi đang chạy ở môi trường sản xuất.

So sánh giữa giải pháp được quản lý và không được quản lý, tóm tắt trong một dòng cho mỗi loại: Gói xuất dạng không được quản lý vẫn có thể chỉnh sửa tại đích đến - phù hợp để di chuyển giữa các môi trường xây dựng; gói xuất dạng được quản lý sẽ bị khóa - phù hợp cho môi trường sản xuất, nơi mọi thay đổi cần được thực hiện thông qua flow triển khai chuẩn thay vì các bản sửa lỗi nhanh.

Thử ngay: Lập danh mục kiểm tra trước khi triển khai cho agent flow!

Nơi dán nội dung: claude.ai hoặc chatgpt.com.

Sao chép câu lệnh (prompt) này và điền thông tin về flow dự án của bạn:

Hãy lập danh mục kiểm tra trước khi triển khai cho một Copilot Studio agent flow
khi chuyển từ môi trường phát triển sang môi trường sản xuất.

Flow của tôi: [một câu mô tả]
Các connector được sử dụng: [danh sách]
Các giá trị khác nhau giữa môi trường phát triển và sản xuất: [ví dụ: "URL trang SharePoint,
tên danh sách, kênh thông báo"]

Xuất ra một danh sách kiểm tra gồm 3 phần:
1. Nội dung giải pháp - flow cùng với mọi tham chiếu kết nối và
  biến môi trường cần thiết, kèm tên gọi cụ thể
2. Các bước nhập - ai cung cấp kết nối sản xuất nào, và
  những giá trị biến môi trường nào cần thay đổi
3. Xác minh sau khi nhập - 3 lệnh gọi kiểm thử chứng minh flow hoạt động
  với dữ liệu và thông tin xác thực của môi trường sản xuất

Kết quả nhận được: Một danh mục kiểm tra triển khai mà bạn có thể giao cho đồng nghiệp để họ thực hiện triển khai flow của bạn mà không cần hỏi thêm bất kỳ điều gì.

Cách sử dụng kết quả: Đây chính là phần triển khai trong danh sách kiểm tra đưa vào vận hành của Bài 8 - hãy lưu giữ nó cùng với các phần còn lại.

Những điểm chính cần ghi nhớ

• Tab Activity = thông tin thực tế gần như theo thời gian thực với dữ liệu chi tiết từng bước; Dữ liệu Analytics có độ trễ theo thiết kế (30 phút / ~24 giờ) - tuyệt đối không dùng Analytics để gỡ lỗi
• Bản đồ hoạt động (activity map) của agent hiển thị những gì orchestrator đã gửi và nhận - thông tin mà lịch sử chạy không thể hiện hết
• Lịch sử phiên bản được tạo từ các lần lưu: Hãy lưu bản nháp để luôn có thể khôi phục lại trạng thái cũ
• Các giải pháp bao gồm flow, tham chiếu kết nối và biến môi trường; khi nhập giải pháp, thông tin xác thực và cấu hình sẽ được thiết lập lại cho phù hợp với từng môi trường dạng "không được quản lý" dùng giữa các môi trường xây dựng; dạng "được quản lý" dùng cho môi trường sản xuất