Sử dụng Notion từ dòng lệnh của bạn với Notion CLI (bản beta)

Notion CLI ntn là công cụ cho phép các nhà phát triển và trợ lý lập trình AI làm việc với Notion bằng cách nhập lệnh trong terminal. Bạn có thể đọc và ghi nội dung Notion, đồng thời (nếu có quyền truy cập) quản lý Workers từ dòng lệnh.

Bạn cũng có thể xem Workers và đọc nhật ký trong Notion với Chế độ nhà phát triển. Sử dụng CLI khi bạn cần triển khai Workers hoặc thay đổi mã hoặc thiết lập của chúng.

Bài viết này là bản tổng quan cấp cao. Để biết cách thiết lập kỹ thuật, hãy xem tài liệu dành cho nhà phát triển.

• CLI được thiết kế cho các nhà phát triển và trình tạo kỹ thuật.

• CLI khả dụng trên tất cả các gói dịch vụ. Tuy nhiên, việc triển khai và quản lý Notion Workers yêu cầu gói Business hoặc Enterprise.

• Một số tính năng của nền tảng cho nhà phát triển mà bạn sử dụng qua CLI có thể yêu cầu các gói cụ thể hoặc được quản trị viên bật.

• Nếu có gì đó trông không ổn, trước tiên hãy đảm bảo bạn đang sử dụng phiên bản CLI mới nhất.

• Nếu bạn chỉ cần xem Worker, đọc nhật ký, tắt hoặc xóa Worker, bạn có thể thực hiện việc đó trong Notion sau khi bật Chế độ nhà phát triển.

CLI hoạt động trên Mac, Linux và Windows. Trên bất kỳ hệ điều hành nào trong số này, bạn có thể cài đặt CLI bằng npm install -g ntn.

Để biết thêm thông tin về cách cài đặt, hãy xem tài liệu dành cho nhà phát triển.

Hãy bắt đầu với các bước kiểm tra nhanh sau:

1. Cập nhật CLI, sau đó thử lại. CLI được thiết kế để luôn cập nhật và các phiên bản cũ hơn có thể hoạt động khác đi.

2. Xác nhận bạn đã đăng nhập vào đúng tài khoản Notion. Nếu bạn có nhiều tài khoản hoặc không gian làm việc, hãy đăng xuất và đăng nhập lại.

3. Trước tiên, hãy kiểm tra quyền truy cập của bạn trong Notion. Nếu bạn không thể mở trang hoặc cơ sở dữ liệu trong Notion, CLI cũng sẽ không thể đọc hoặc thay đổi nội dung đó.

4. Nếu bạn đang cố gắng sử dụng các lệnh Workers, hãy xác nhận rằng Workers đã được bật. Quyền truy cập Workers có thể phụ thuộc vào gói của bạn và việc chủ sở hữu không gian làm việc đã bật tính năng này hay chưa.

5. Vẫn gặp khó khăn? Hãy sử dụng tài liệu dành cho nhà phát triển để biết lỗi chính xác và cách khắc phục, vì các bước có thể khác nhau đối với từng lệnh.