Chạy mã tùy chỉnh với Workers (bản beta)

Notion Workers là một phần trong Nền tảng cho nhà phát triển của chúng tôi. Chúng chạy mã tùy chỉnh trên cơ sở hạ tầng của Notion để hỗ trợ:

• Đồng bộ cơ sở dữ liệu

• Công cụ cho Trợ lý tùy chỉnh

• Trình kích hoạt webhook

• Workers có sẵn trên các gói Business và Enterprise.

• Theo mặc định, Workers được bật cho không gian làm việc (chỉ dành cho chủ sở hữu).

• Chủ sở hữu không gian làm việc có thể:

  • Giới hạn việc tạo Worker chỉ dành cho chủ sở hữu.

  • Cho phép các thành viên hoặc nhóm cụ thể tạo Workers.

  • Tắt Workers cho không gian làm việc.

• Nếu bạn đang cố gắng triển khai hoặc quản lý một Worker, bạn thường sẽ làm theo tài liệu dành cho nhà phát triển của chúng tôi và sử dụng Notion CLI.

• Bạn có thể bật Chế độ nhà phát triển để xem Workers trong Notion, đọc nhật ký, cũng như tắt hoặc xóa Workers. Để triển khai một Worker hoặc thay đổi mã hoặc thiết lập của nó, hãy sử dụng Notion CLI hoặc công cụ lập trình của nhóm bạn. Tìm hiểu thêm về chế độ nhà phát triển →

Để tìm hiểu thêm về biểu giá cho Workers, hãy xem bài viết này.

Đồng bộ hóa cơ sở dữ liệu (được hỗ trợ bởi Workers) đưa thông tin từ các công cụ bên ngoài vào cơ sở dữ liệu Notion và tự động cập nhật thông tin đó. Sau khi được thiết lập, cơ sở dữ liệu được đồng bộ sẽ tự cập nhật, vì vậy nhóm và các trợ lý của bạn luôn thấy dữ liệu mới nhất mà không cần bất kỳ ai phải sao chép hoặc dán giữa các công cụ.

Một vài ví dụ phổ biến:

• Đồng bộ hóa các phiếu hỗ trợ Zendesk vào cơ sở dữ liệu phân loại.

• Đồng bộ hóa các tài khoản Salesforce vào trình theo dõi quy trình.

• Đồng bộ hóa dữ liệu từ một công cụ hoặc cơ sở dữ liệu nội bộ.

Sau khi hoạt động, cơ sở dữ liệu được đồng bộ sẽ hoạt động giống như bất kỳ cơ sở dữ liệu nào khác trong Notion. Quyền truy cập được quản lý theo các quyền chia sẻ Notion tiêu chuẩn của bạn.

Các công cụ của trợ lý (được hỗ trợ bởi Workers) mở rộng những gì trợ lý tùy chỉnh của bạn có thể làm ngoài các hành động tích hợp sẵn của Notion và MCP, với các khả năng được tùy chỉnh theo cách làm việc của nhóm bạn.

Một vài ví dụ phổ biến:

• Truy vấn kho dữ liệu.

• Tạo tài sản từ tài liệu Notion.

• Thực hiện hành động trong một ứng dụng khác không được hỗ trợ nguyên bản hoặc không khả dụng qua MCP.

Các trình kích hoạt webhook (được hỗ trợ bởi Workers) cho phép một sự kiện trong công cụ khác khởi chạy quy trình làm việc trong Notion hoặc bất kỳ hệ thống được kết nối nào khác.

Một vài ví dụ phổ biến:

• Đóng một nhiệm vụ khi yêu cầu kéo được hợp nhất.

• Cập nhật bản ghi CRM khi gói đăng ký thay đổi.

• Tạo tài liệu giới thiệu khi một ưu đãi được ký kết.

Sau khi thiết lập, quy trình làm việc sẽ tự động chạy mỗi khi sự kiện xảy ra, vì vậy nhóm của bạn không cần phải di chuyển thông tin giữa các công cụ theo cách thủ công.

Với Chế độ nhà phát triển, bạn có thể mở Workers từ phần nhà phát triển trong thanh bên. Sử dụng chế độ xem này để kiểm tra nhanh và thực hiện các hành động cơ bản. Trong Notion, bạn có thể:

• Xem tất cả Workers trong một danh sách.

• Mở một Worker và xem Tổng quan, nhật ký, Biến môi trường và Cài đặt.

• Đọc nhật ký Worker.

• Tắt hoặc xóa một Worker.

Để triển khai Worker hoặc thay đổi mã hoặc thiết lập của nó, hãy sử dụng Notion CLI hoặc công cụ lập trình của nhóm bạn.

Theo mặc định, chỉ người tạo Worker mới có thể sửa đổi và thêm nó làm kết nối mới. Hãy chia sẻ Worker với các thành viên nhóm để họ có thể kết nối nó với trợ lý tùy chỉnh hoặc hỗ trợ quản lý nó.

Tìm hiểu thêm về cách chia sẻ Worker →

Hãy thử các bước sau theo thứ tự:

1. Đảm bảo không gian làm việc của bạn đủ điều kiện và chủ sở hữu không gian làm việc đã bật Workers. Workers có sẵn trên các gói Business và Enterprise và yêu cầu quản trị viên không gian làm việc kích hoạt.

2. Xác nhận bạn đang sử dụng đúng đường dẫn thiết lập đã định sẵn. Đối với hầu hết các thiết lập, bạn sẽ sử dụng Notion CLI cùng với tài liệu dành cho nhà phát triển.

3. Nếu việc triển khai Worker của bạn thất bại, hãy kiểm tra lại quyền của bạn. Bạn có thể không có quyền triển khai vào không gian làm việc đó, ngay cả khi bạn có thể xem các trang trong đó.

4. Nếu Worker của bạn chạy nhưng không thay đổi bất kỳ điều gì trong Notion, hãy kiểm tra hành động theo cách thủ công trước. Nếu bạn không thể thực hiện thay đổi tương tự trong Notion, đó thường là vấn đề về quyền hoặc cài đặt không gian làm việc.

5. Nếu chi phí cao hơn dự kiến, hãy giảm tần suất lượt chạy. Các Worker lượt chạy thường xuyên hơn sẽ tốn kém hơn. Hãy bắt đầu với lịch trình chậm hơn, sau đó tăng dần khi bạn đã tự tin rằng nó hoạt động ổn định.

6. Vẫn gặp khó khăn? Hãy làm theo tài liệu dành cho nhà phát triển cho thông báo lỗi cụ thể đó. Họ sẽ có cách khắc phục chính xác nhất.