Edge function

Thực thi mã phía máy chủ

Edge function là các hàm JavaScript/TypeScript chạy trên thời gian chạy Deno, cho phép bạn triển khai logic không nên hoặc không thể chạy trong trình duyệt. AI tạo các hàm này khi bạn mô tả các tính năng cần xử lý phía máy chủ, tích hợp API bên ngoài hoặc bảo mật nâng cao.

Edge function cho phép bạn làm gì:

  • Xử lý biểu mẫu với xác thực và lệnh gọi API bên ngoài
  • Tích hợp các dịch vụ như gửi email, xử lý thanh toán hoặc gọi API AI
  • Bảo vệ logic nhạy cảm không được hiển thị trong mã trình duyệt
  • Truy cập secret một cách an toàn mà không để lộ cho người dùng
  • Thực hiện các thao tác phức tạp quá chậm hoặc tốn nhiều tài nguyên cho trình duyệt

Các hàm hoạt động như thế nào

Khi AI tạo edge function cho bạn, nó sẽ:

  1. Viết mã JavaScript để thực hiện tác vụ bạn đã mô tả
  2. Thiết lập kiểm soát truy cập để xác định ai có thể gọi hàm
  3. Định cấu hình quyền truy cập secret nếu hàm này cần thông tin xác thực API bên ngoài
  4. Kiểm tra hàm để đảm bảo nó hoạt động chính xác
  5. Cung cấp một URL ứng dụng của bạn có thể gọi để thực thi hàm

Các hàm chạy trong môi trường biệt lập, an toàn. Mỗi lần thực thi đều được ghi lại với thông tin về thời gian, mọi lỗi và nguyên nhân người dùng đã kích hoạt nó. Bạn có thể xem các nhật ký này tại Cài đặt > Cấu hình trang web > Giám sát > Nhật ký để theo dõi cách các hàm của bạn hoạt động và gỡ lỗi mọi sự cố.

Kiểm soát truy cập cho các hàm

Cũng giống như các bảng cơ sở dữ liệu, các edge function có các chính sách bảo mật kiểm soát ai có thể thực thi chúng. AI thiết lập những thứ này dựa trên những gì bạn đang xây dựng:

Hàm công cộng

Bất kỳ ai cũng có thể gọi chúng, ngay cả khi không cần đăng nhập. Được sử dụng cho trình xử lý webhook (như thông báo thanh toán Stripe), API công khai hoặc endpoint kiểm tra tình trạng.

Hàm xác thực

Chỉ người dùng đã đăng nhập mới có thể gọi chúng. Hầu hết các hàm đều sử dụng chính sách này — nó phù hợp với các tính năng giao diện người dùng, gửi biểu mẫu hoặc tìm nạp dữ liệu cho ứng dụng của bạn.

Truy cập dựa trên nhóm

Chỉ người dùng trong các nhóm cụ thể (như "quản trị viên") mới có thể gọi hàm. Hoàn hảo cho các hoạt động quản trị, công cụ kiểm duyệt hoặc các tính năng dành riêng cho nhóm.

Truy cập dựa trên siêu dữ liệu

Truy cập dựa trên thuộc tính người dùng tùy chỉnh. Ví dụ: chỉ những người dùng có department = "engineering" có thể gọi một số hàm nhất định. Điều này cho phép các mô hình phân quyền tùy chỉnh, linh hoạt.

Hàm có thể làm gì

Truy cập cơ sở dữ liệu

Các hàm có thể truy vấn và sửa đổi cơ sở dữ liệu của bạn với tất cả các quy tắc bảo mật tương tự được áp dụng.

Gọi API bên ngoài

Các hàm có thể giao tiếp với các dịch vụ bên ngoài bằng cách sử dụng các secret được lưu trữ của bạn.

Logic phức tạp

Các hàm có thể thực hiện tính toán, chuyển đổi dữ liệu, xác thực hoặc quy trình công việc gồm nhiều bước.

Email và thông báo

Gửi email giao dịch, tin nhắn SMS hoặc thông báo đẩy để phản hồi hành động của người dùng.

Xử lý thanh toán

Xử lý các luồng thanh toán, xử lý webhook hoặc quản lý đăng ký bằng các dịch vụ như Stripe.

Tích hợp AI

Gọi các API AI như OpenAI hoặc Anthropic để tạo nội dung, phân tích dữ liệu hoặc cung cấp các tính năng thông minh.

Giám sát và ghi nhật ký

Mọi thực thi hàm đều được tự động ghi lại với:

  • Khi nào nó được gọi và bởi ai
  • Mất bao lâu để thực hiện
  • Thành công hay gặp lỗi
  • Bất kỳ thông báo lỗi hoặc đầu ra console nào
  • Phản hồi nó trả về

Thực hành tốt nhất

✅ Mô tả rõ ràng - Khi yêu cầu AI tạo một hàm, hãy nêu cụ thể nó nên làm gì và ai có thể gọi nó.

✅ Theo dõi nhật ký - Kiểm tra nhật ký thực thi hàm để hiểu hiệu suất và sớm phát hiện lỗi.

✅ Giữ secret trong trình quản lý secret - AI sẽ sử dụng các secret được lưu trữ thay vì mã hóa cứng chúng trong các hàm.

❌ Không để lộ các thao tác nhạy cảm - Hãy để AI định cấu hình các biện pháp kiểm soát truy cập phù hợp. Các hàm quản trị không bao giờ nên được công khai.


Tài liệu liên quan: