GitHub AI Connector

Trong tài liệu trợ giúp này

Tìm hiểu cách mở khóa kiến thức GitHub của bạn trong Notion AI 🤖

Tính năng này có trên Business và gói Enterprise.
Notion AI tạo câu trả lời bằng cách sử dụng các LLM như GPT-5 và Claude. Hãy nhớ kiểm tra kỹ tất cả các câu trả lời để đảm bảo độ chính xác.
Có rất nhiều cách khác để sử dụng Slack và Notion cùng nhau. Tìm hiểu thêm về kết nối Slack → của chúng tôi.

Kết nối GitHub với Notion AI

Ai có thể kết nối GitHub với Notion AI?

Bạn phải là chủ sở hữu tổ chức GitHub và chủ sở hữu không gian làm việc Notion.
Không gian làm việc của bạn phải thuộc gói Business hoặc gói Enterprise và có nhiều hơn một thành viên.

Sau khi Trình kết nối AI GitHub được thiết lập cho không gian làm việc, các thành viên có thể sử dụng tích hợp để truy xuất câu trả lời:

Kho lưu trữ công khai: Không yêu cầu xác thực bổ sung sau khi chủ sở hữu thiết lập trình kết nối ban đầu.
Kho lưu trữ riêng tư: Mỗi thành viên phải đăng nhập/xác thực với GitHub để xác minh quyền truy cập.

Làm sao để kết nối GitHub?

Có hai cách khác nhau để kết nối GitHub với Notion AI. Để kết nối tổ chức GitHub, bạn cần phải là chủ sở hữu không gian làm việc và chủ sở hữu GitHub. Để kết nối các kho lưu trữ riêng tư, bạn có thể là thành viên không gian làm việc.

Nếu bạn là chủ sở hữu không gian làm việc Notion và chủ sở hữu GitHub:

Để kết nối GitHub với không gian làm việc Notion của bạn:

Đi tới Cài đặt → Notion AI.
Chọn + bên cạnh GitHub.
Bạn sẽ được chuyển đến GitHub. Hãy đảm bảo bạn đã đăng nhập bằng đúng tài khoản GitHub. Đừng đóng Notion trong quá trình thiết lập!
Trên trang mở ra, hãy kết nối với GitHub và chọn tổ chức bạn muốn đồng bộ hóa. Lưu ý rằng nếu bạn muốn kết nối một kho lưu trữ GitHub cá nhân, trước tiên bạn phải tạo một tổ chức rồi chuyển kho lưu trữ đó vào tổ chức đó.
Chọn Tất cả kho lưu trữ (được khuyến nghị) hoặc Chọn kho lưu trữ, sau đó chọn Cài đặt.
Quay lại Notion.

Sau khi tích hợp được thiết lập, nó sẽ có thể lập chỉ mục các PR và vấn đề quay ngược lại một năm kể từ khi quá trình thiết lập hoàn tất. Bạn cũng sẽ có quyền truy cập vào tất cả các tệp mã bao gồm tệp markdown và README mà không bị giới hạn thời gian.

Lưu ý: Tại thời điểm này, các wiki và kho lưu trữ được phân nhánh (forked repositories) không được hỗ trợ.

Có thể mất tới 72 giờ để kết nối hoàn tất. Sau đó, mỗi người dùng trong không gian làm việc Notion của bạn phải xác thực với GitHub riêng lẻ để sử dụng tích hợp và quyền của họ sẽ được ánh xạ tương ứng.

Nếu bạn là thành viên không gian làm việc Notion:

Nếu bạn không phải là chủ sở hữu không gian làm việc Notion hoặc tổ chức GitHub của mình, bạn sẽ cần một chủ sở hữu kết nối Notion với GitHub trước khi có thể sử dụng tích hợp này. Sau khi tích hợp đã được thiết lập bởi chủ sở hữu, bạn sẽ phải đăng nhập để kết nối các kho lưu trữ riêng tư của mình. Để thực hiện việc này:

Trong Notion, hãy mở Notion AI ở cuối màn hình của bạn và nhấp vào ••• → Kết nối GitHub.
Chọn Đăng nhập và kết nối tài khoản GitHub của bạn.

Nội dung nào từ GitHub có thể được kết nối với Notion AI?

Sau khi Trình kết nối AI đã được thiết lập cho không gian làm việc, nó có thể lập chỉ mục mã, pull request, Vấn đề, Tệp và README.

Mỗi người dùng sẽ chỉ có thể sử dụng Notion AI để xem và tìm kiếm nội dung mà họ có quyền truy cập trong GitHub. Notion AI có thể truy xuất thông tin của một năm qua từ các yêu cầu kéo.

Tôi có thể sử dụng Trình kết nối Notion AI cho GitHub của mình ở đâu?

Bạn có thể tìm kiếm GitHub thông qua Trình kết nối Notion AI tại các vị trí sau:

Trò chuyện Notion AI ở góc dưới bên phải của Notion.
Tiện ích Notion AI ở đầu Trang chủ.
Tìm kiếm trong thanh bên của bạn.

Bạn có thể thu hẹp phạm vi tìm kiếm chỉ trong GitHub bằng cách mở nút thu gọn/mở rộng Tất cả nguồn trong trò chuyện và Trang chủ rồi chọn GitHub. Bạn cũng có thể lọc kết quả Tìm kiếm của Notion AI để chỉ hiển thị thông tin từ GitHub.

Các phương pháp hay nhất và ví dụ về câu lệnh gợi ý

Trình kết nối AI của GitHub hữu ích nhất cho việc:

Hỏi về các thay đổi gần đây và cập nhật dự án.
Tìm các triển khai mã.
Tra cứu các vấn đề và trạng thái của chúng.
Gỡ lỗi các vấn đề. Ví dụ: bạn có thể nhận ngữ cảnh khi các tính năng bị hỏng hoặc gây ra lỗi bằng cách đọc qua các yêu cầu kéo gần đây.
Tìm các mẫu bảo mật.

Bạn có thể thử yêu cầu Notion AI bằng các câu lệnh sau:

"Có gì mới với {project name}?"
"Chúng ta đã thực hiện những yêu cầu kéo nào trong tuần qua?"
"Những thay đổi gần đây đối với hệ thống xác thực của chúng ta là gì?"
"Cho tôi xem các ví dụ về cách chúng ta đang triển khai xử lý lỗi trong cơ sở mã của mình."
"Các quan hệ phụ thuộc chính được sử dụng trong các thành phần giao diện người dùng của chúng ta là gì?"
"Tìm các triển khai của các hàm di chuyển cơ sở dữ liệu."
"Chúng ta đang sử dụng các mẫu bảo mật nào cho các điểm cuối API?"

Tìm hiểu thêm

Câu hỏi thường gặp

Tôi đã kết nối sai không gian làm việc Notion. Làm cách nào để ngắt kết nối Kho lưu trữ GitHub của tôi?

Chủ sở hữu không gian làm việc có thể ngắt kết nối hoặc chỉnh sửa các kênh sau khi quá trình tích hợp ban đầu hoàn tất bằng cách đi tới Cài đặt → Notion AI. Chọn ⚙️ bên cạnh GitHub → Cài đặt → Ngắt kết nối.

Mất bao lâu để quá trình tích hợp hoàn tất?

Việc thiết lập tích hợp có thể mất tới 72 giờ tùy thuộc vào kích thước của kho lưu trữ và loại gói GitHub.

Mất bao lâu để nội dung mới trong GitHub được phản ánh trong Notion AI?

Sau khi thiết lập ban đầu, dữ liệu mới có thể mất tới 3 giờ để được Notion AI lập chỉ mục. Khối lượng dữ liệu lớn hơn có thể mất thêm thời gian.

Mọi người trong không gian làm việc Notion của tôi có thể truy cập thông tin từ GitHub không?

Các thành viên trong không gian làm việc phải xác thực và đăng nhập riêng lẻ để truy xuất thông tin từ các kho lưu trữ riêng tư mà họ đã có quyền truy cập trong GitHub.

Tôi có thể đặt câu hỏi về GitHub trong khoảng thời gian bao xa?

Bạn có thể truy xuất các yêu cầu kéo và vấn đề trong tối đa một năm trong kho lưu trữ của họ. Tất cả các tệp README sẽ khả dụng mà không có bất kỳ hạn chế về thời gian nào.

Notion AI có quyền truy cập vào những gì?

Trong quá trình giới thiệu, sau khi bạn chọn tổ chức GitHub mà bạn muốn kết nối, bạn có thể chọn xem Notion AI có quyền truy cập vào:

Tất cả kho lưu trữ: Điều này áp dụng cho tất cả các kho lưu trữ hiện tại và tương lai thuộc sở hữu của chủ sở hữu tài nguyên. Cũng bao gồm các kho lưu trữ công khai (chỉ đọc).
Chỉ chọn các thuộc tính: Chọn ít nhất một kho lưu trữ. Cũng bao gồm các kho lưu trữ công khai (chỉ đọc).

Các trình kết nối Notion AI có tôn trọng các quyền Notion AI hiện có không?

Chắc chắn rồi. Notion AI sẽ tôn trọng các quyền hiện có theo Các thực tiễn bảo mật của Notion AI hiện tại của chúng tôi. Người dùng sẽ không thể tạo nội dung hoặc nhận phản hồi từ Notion AI dựa trên các tài nguyên của bên thứ ba mà họ không có quyền truy cập.

Đối với nội dung của bên thứ ba, Notion AI xử lý cả nội dung riêng tư và công khai với sự chú trọng đến bảo mật, chỉ thu thập nội dung theo ánh xạ quyền giữa người dùng GitHub và Notion.

Notion AI xử lý ánh xạ quyền như thế nào?

Người dùng sẽ chỉ thấy nội dung GitHub (ví dụ: mã, PR, vấn đề) trong Notion AI mà họ có quyền truy cập cá nhân trong GitHub. Ngay cả khi ai đó cố gắng truy vấn một kho lưu trữ mà họ không có quyền truy cập trong GitHub, Notion AI sẽ không trả về kết quả từ kho lưu trữ đó.

Người dùng phải là thành viên của cả GitHub và Notion để xác thực ứng dụng này ở cấp độ người dùng.
Người dùng không cần phải sử dụng cùng một địa chỉ email trong Notion và GitHub.
Quyền được ánh xạ dựa trên việc xác thực thành công của mỗi người dùng với tài khoản GitHub của họ, không phải bằng cách so sánh các địa chỉ email. Notion AI dựa vào đăng nhập OAuth để xác nhận danh tính và phạm vi quyền—không phải khớp email.
Chúng tôi đồng bộ hóa quyền từ GitHub mỗi giờ và cập nhật quyền trong Notion cho phù hợp.

Notion lưu trữ hoặc tham chiếu dữ liệu GitHub của tôi trong hệ thống của họ như thế nào?

Tương tự như sản phẩm Notion AI cốt lõi của chúng tôi, chúng tôi tạo và lưu trữ các nhúng trong cơ sở dữ liệu vectơ do Turbopuffer lưu trữ, cơ sở dữ liệu này hỗ trợ khả năng cung cấp phản hồi cho các câu hỏi tận dụng nội dung của bên thứ ba (ví dụ: GitHub). Turbopuffer đã được đội ngũ bảo mật của chúng tôi cũng như một kiểm toán viên bên ngoài kiểm duyệt để đạt được chứng nhận SOC2 Loại II. Tìm hiểu thêm về bảo mật của Turbopuffer tại đây →

Ghi lại

Tìm kiếm

Tự động hóa