Chuyển đến nội dung chính
Kết nối Notion để các agent CloudThinker tìm kiếm các trang và database bạn chia sẻ, trả lời câu hỏi từ runbook và sổ tay của bạn, và cập nhật nội dung khi bạn yêu cầu. Kết nối đăng nhập bằng internal integration secret của Notion (một token thuộc về một workspace Notion), và chỉ thấy các trang bạn chia sẻ rõ ràng với integration đó.

​
Điều kiện tiên quyết

  • Một tài khoản Notion có quyền tạo integration trong workspace. Ở hầu hết workspace, đó là Workspace Owner.
  • Quyền Full access hoặc Can edit trên các trang và database mà agent cần tiếp cận, để bạn chia sẻ chúng với integration.
  • Quyền sửa kết nối trong workspace CloudThinker của bạn.

​
Thiết lập

1

Tạo internal integration trong Notion

Vào notion.so/profile/integrations và nhấn New integration. Đặt tên cloudthinker, chọn workspace Notion, giữ loại Internal và lưu.Sao chép Internal Integration Secret. Secret bắt đầu bằng ntn_ (secret cũ bắt đầu bằng secret_).
2

Chọn capability của integration

Ở tab Configuration của integration, trong Capabilities, chỉ giữ những gì quy trình của bạn cần. Xem Quyền yêu cầu để biết bộ quyền chỉ đọc và đọc-ghi.Nếu Resolve sẽ đăng postmortem, hãy bật thêm Insert content. Xem Dùng Notion cho postmortem.
3

Chia sẻ trang và database với integration

Mở tab Access của integration và chọn các trang và database mà agent cần tiếp cận. Trang con kế thừa quyền truy cập từ trang cha, nên chia sẻ một trang cấp cao như Engineering sẽ bao phủ mọi thứ bên dưới.Bạn cũng có thể chia sẻ một trang từ chính trang đó: mở menu •••, chọn Connections và thêm cloudthinker.
4

Thêm kết nối trong CloudThinker

Trong thanh bên, nhấn More → Workspace settings → Connections. Ở tab Builtin Connections, tìm Notion và nhấn Connect.Dán secret vào NOTION_TOKEN và nhấn Connect.Trạng thái thành công: hộp thoại đóng và kết nối Notion hiển thị Connected.
Notion kiểm tra secret khi agent gọi lần đầu. Hãy chạy prompt xác minh bên dưới trước khi dựa vào kết nối, để phát hiện ngay secret gõ sai hoặc đã bị thu hồi, thay vì đến giữa một sự cố mới biết.

​
Chi tiết kết nối

Mỗi secret chỉ bao phủ một workspace Notion. Để tiếp cận workspace Notion thứ hai, hãy tạo integration ở đó và thêm thành một kết nối riêng.

​
Quyền yêu cầu

Hai yếu tố trong Notion đặt giới hạn trên cho những gì agent làm được: Capabilities của integration và các trang trên tab Access của nó. CloudThinker không bao giờ tiếp cận được trang chưa được chia sẻ với integration. Giữ thông tin người dùng ở No user information trừ khi một quy trình cần xác định người theo tên. Không có quyền này, agent thấy người trong thuộc tính Person dưới dạng ID, không phải tên.
Bắt đầu chỉ đọc với Read content, và chỉ chia sẻ các teamspace hoặc trang cấp cao mà agent cần, chẳng hạn runbook và postmortem. Thêm capability ghi sau nếu một quy trình cần.

​
Khả năng của agent

CloudThinker chạy MCP server chính thức của Notion (Model Context Protocol, một chuẩn để agent gọi công cụ). Sửa và comment là thao tác ghi, nên Approvals quyết định từng thao tác được chạy, phải chờ người duyệt hay bị từ chối. Tìm kiếm và đọc chạy mà không hỏi.

​
Dùng Notion cho postmortem

Resolve có thể soạn và đăng postmortem lên Notion sau khi một sự cố được giải quyết. Trong thanh bên, mở Resolve → Integrations, chọn Notion, bật Publish postmortems trong What Resolve can do, và nhập Notion parent page ID, trang mà các postmortem mới sẽ nằm dưới. Chia sẻ trang cha đó với integration và bật Insert content. Xem tích hợp Resolve để biết thiết lập đầy đủ. Page ID là chuỗi 32 ký tự ở cuối URL của trang. Bỏ phần tiêu đề phía trước và mọi phần ?v= hoặc ?pvs= phía sau. Với https://www.notion.so/Postmortems-1a2b3c4d5e6f7a8b9c0d1e2f3a4b5c6d?pvs=4, page ID là 1a2b3c4d5e6f7a8b9c0d1e2f3a4b5c6d.

​
Xác minh kết nối

Kết nối hoạt động sẽ nêu tên trang thực tế tìm thấy và trích dẫn nội dung. Câu trả lời báo không tìm thấy trang nào nghĩa là integration chưa được chia sẻ với trang đó. Lỗi ủy quyền nghĩa là secret sai.

​
Ví dụ prompt

​
Khắc phục sự cố

Notion từ chối secret. Secret có thể gõ sai, đã bị thu hồi hoặc thuộc một integration đã bị xóa. Sao chép Internal Integration Secret hiện tại từ tab Configuration của integration. Trong CloudThinker, mở Notion trong More → Workspace settings → Connections, nhấn biểu tượng bút chì trên hàng của tài khoản, nhấn Replace… trong Edit Instance, dán secret và nhấn Save and test.
Trang chưa được chia sẻ với integration. Thêm trang ở tab Access của integration, hoặc từ menu ••• → Connections của trang. Chia sẻ trang cha cũng chia sẻ các trang con.
Integration thiếu Update content hoặc Insert content. Bật chúng trong Capabilities ở Notion. Nếu bạn muốn giữ kết nối chỉ đọc, lỗi này là kết quả mong đợi.
Thao tác ghi đang chờ một người. Tìm thẻ phê duyệt trong chat và nhấn Approve. Nếu thẻ ghi “Waiting for an approver,” nhấn Notify approvers. Xem Approvals để thay đổi ai phê duyệt và khi nào.
Kiểm tra Notion parent page ID trong Resolve khớp với một trang được chia sẻ với integration, và Insert content đã được bật.

​
Bảo mật

  • Quyền tối thiểu — chỉ cấp các quyền mà agent cần cho trường hợp sử dụng của bạn; bắt đầu với quyền chỉ đọc và mở rộng sau.
  • Chỉ đọc theo mặc định — sử dụng thông tin xác thực chỉ đọc trừ khi bạn muốn agent thực hiện thay đổi qua kết nối này.
  • Xoay vòng thông tin xác thực — xoay vòng khóa và token theo lịch trình thông thường của bạn; CloudThinker sẽ lấy giá trị mới khi bạn cập nhật kết nối.
  • Thu hồi khi bàn giao — xóa thông tin xác thực tại nhà cung cấp khi bạn xóa một kết nối hoặc khi đồng nghiệp rời nhóm.
  • Tab Access là phạm vi của bạn. Integration chỉ thấy các trang được chia sẻ với integration. Xem lại danh sách đó khi các nhóm sắp xếp lại nội dung.
  • Không đưa secret vào chat. Chỉ dán secret vào hộp thoại kết nối, không bao giờ vào tin nhắn chat hay repository.
  • Xoay vòng bằng cách làm mới secret. Làm mới secret trong Notion sẽ vô hiệu secret cũ ngay lập tức, nên hãy thay trong CloudThinker ngay (biểu tượng bút chì → Replace… → Save and test). Xem Xoay vòng thông tin xác thực.
  • Thay đổi hiển thị dưới tên integration. Notion hiển thị thay đổi qua kết nối dưới tên integration cloudthinker, nên nhóm bạn phân biệt được chúng với thay đổi của con người.

​
Liên quan

Knowledge

Tải lên tài liệu để agent tìm kiếm ngay trong CloudThinker

Kết nối Atlassian

Kết nối Jira và Confluence cho ticket và tài liệu nhóm