GitHub AI Connector

ในเอกสารช่วยเหลือนี้

เรียนรู้วิธีปลดล็อกความรู้ GitHub ของคุณใน Notion AI

ข้ามไปยังคำถามที่พบบ่อย

  • ฟีเจอร์นี้มีให้ใช้ในแพ็คเกจ Business และแพ็คเกจ Enterprise

ใครสามารถเชื่อมต่อ GitHub กับ Notion AI ได้บ้าง?

  • คุณต้องเป็นเจ้าขององค์กร GitHub และเจ้าของพื้นที่ทำงาน Notion.

  • พื้นที่ทำงานของคุณต้องอยู่บนแพ็คเกจ Business หรือแพ็คเกจ Enterprise และมีสมาชิกมากกว่าหนึ่งคน

เมื่อตั้งค่า GitHub AI Connector สำหรับพื้นที่ทำงานแล้ว สมาชิกสามารถใช้การเชื่อมต่อเพื่อดึงคำตอบได้:

  • ที่เก็บข้อมูลสาธารณะ: ไม่จำเป็นต้องมีการยืนยันตัวตนเพิ่มเติมหลังจากเจ้าของตั้งค่าตัวเชื่อมต่อในตอนแรกแล้ว

  • ที่เก็บข้อมูลส่วนตัว: สมาชิกแต่ละคนต้องลงชื่อเข้าใช้/ยืนยันตัวตนกับ GitHub เพื่อตรวจสอบสิทธิ์การเข้าถึง

ฉันจะเชื่อมต่อ GitHub ได้อย่างไร?

มีสองวิธีในการเชื่อมต่อ GitHub กับ Notion AI ในการเชื่อมต่อองค์กร GitHub คุณจะต้องเป็นเจ้าของพื้นที่ทำงานและเจ้าของ GitHub ในการเชื่อมต่อที่เก็บข้อมูลส่วนตัว คุณสามารถเป็นสมาชิกของพื้นที่ทำงานได้

หากคุณเป็นเจ้าของพื้นที่ทำงาน Notion และเจ้าของ GitHub:

ในการเชื่อมต่อ GitHub กับพื้นที่ทำงาน Notion ของคุณ:

  1. ไปที่ การตั้งค่า → Notion AI

  2. เลือก + ถัดจาก GitHub

    hc: github connector entry point
  3. คุณจะถูกนำไปยัง GitHub ตรวจสอบให้แน่ใจว่าคุณได้ลงชื่อเข้าใช้ด้วยบัญชี GitHub ที่ถูกต้อง อย่าปิด Notion ระหว่างขั้นตอนการตั้งค่า!

    hc: github connector setup
  4. ในหน้าที่เปิดขึ้นมา ให้เชื่อมต่อกับ GitHub และเลือกองค์กรที่คุณต้องการซิงค์ โปรดทราบว่าหากคุณต้องการเชื่อมต่อที่เก็บข้อมูล GitHub ส่วนตัว คุณต้องสร้างองค์กรก่อนแล้วจึงย้ายที่เก็บข้อมูลนั้นเข้าไปในองค์กร

  5. เลือก ที่เก็บข้อมูลทั้งหมด (แนะนำ) หรือ เลือกที่เก็บข้อมูล จากนั้นเลือก ติดตั้ง

  6. กลับไปที่ Notion

เมื่อตั้งค่าการเชื่อมต่อเรียบร้อยแล้ว ระบบจะสามารถจัดทำดัชนี PR และปัญหาต่างๆ ย้อนหลังได้หนึ่งปีนับจากวันที่ตั้งค่าเสร็จสมบูรณ์ นอกจากนี้ คุณยังสามารถเข้าถึงไฟล์โค้ดทั้งหมด รวมถึงไฟล์ markdown และไฟล์ README ได้โดยไม่มีข้อจำกัดด้านเวลา

หมายเหตุ: ในขณะนี้ ยังไม่รองรับวิกิและ ที่เก็บข้อมูลที่ถูก fork

การเชื่อมต่ออาจใช้เวลาสูงสุด 72 ชั่วโมงในการเสร็จสมบูรณ์ หลังจากนั้น แต่ละผู้ใช้ในพื้นที่ทำงาน Notion ของคุณจะต้องยืนยันตัวตนผ่าน GitHub แยกกันเพื่อใช้งานการเชื่อมต่อ และสิทธิ์การเข้าถึงของพวกเขาจะถูกแมปให้เหมาะสม.

หากคุณเป็นสมาชิกพื้นที่ทำงาน Notion:

หากคุณไม่ใช่เจ้าของพื้นที่ทำงาน Notion หรือองค์กร GitHub ของคุณ คุณจะต้องให้เจ้าของเชื่อมต่อ Notion กับ GitHub ก่อน จึงจะสามารถใช้การเชื่อมต่อได้ เมื่อการเชื่อมต่อถูกตั้งค่าโดยเจ้าของแล้ว คุณจะต้องเข้าสู่ระบบเพื่อเชื่อมต่อที่เก็บข้อมูลส่วนตัวของคุณ โดยทำดังนี้:

  1. ใน Notion ให้เปิด Notion AI ที่ด้านล่างของหน้าจอแล้วคลิกที่ ••• → เชื่อมต่อ GitHub

  2. เลือก เข้าสู่ระบบ และเชื่อมต่อบัญชี GitHub ของคุณ

hc: github connector for members

เมื่อตั้งค่าตัวเชื่อมต่อ AI สำหรับพื้นที่ทำงานเรียบร้อยแล้ว ระบบจะสามารถจัดทำดัชนีโค้ด, PR, ปัญหา, ไฟล์ และไฟล์ README ได้

ผู้ใช้แต่ละคนจะสามารถใช้ Notion AI เพื่อดูและค้นหาเนื้อหาที่ตนเองมีสิทธิ์เข้าถึงใน GitHub ได้เท่านั้น. Notion AI สามารถดึงข้อมูลย้อนหลังได้หนึ่งปีจาก PR

คุณสามารถค้นหา GitHub ผ่านตัวเชื่อมต่อ Notion AI ได้ในตำแหน่งต่อไปนี้:

  • แชท Notion AI ที่มุมขวาล่างของ Notion

  • วิดเจ็ต Notion AI ที่ด้านบนของ หน้าแรก

  • ค้นหา ในแถบด้านข้างของคุณ

คุณสามารถจำกัดการค้นหาให้เหลือเพียง GitHub ได้โดยการเปิดปุ่มเปิด/ปิด แหล่งข้อมูลทั้งหมด ในแชทและ หน้าแรก แล้วเลือก GitHub นอกจากนี้ คุณยังสามารถกรองผลลัพธ์ การค้นหา ของ Notion AI เพื่อแสดงเฉพาะข้อมูลจาก GitHub ได้อีกด้วย

ตัวเชื่อมต่อ AI ของ GitHub มีประโยชน์ที่สุดสำหรับ:

  • การสอบถามเกี่ยวกับการเปลี่ยนแปลงล่าสุดและอัปเดตของโปรเจกต์

  • การค้นหาการใช้งานโค้ด

  • การค้นหาปัญหาและสถานะของปัญหาเหล่านั้น

  • การดีบั๊กปัญหา ตัวอย่างเช่น คุณสามารถรับบริบทเมื่อฟีเจอร์ต่างๆ เสียหายหรือเกิดข้อผิดพลาดได้โดยการอ่าน PR ล่าสุด

  • การค้นหารูปแบบความปลอดภัย

คุณสามารถลองใช้พรอมท์ Notion AI ดังต่อไปนี้:

  • "มีอะไรใหม่บ้างเกี่ยวกับ {project name}?"

  • "เราได้ทำ pull request อะไรไปบ้างในช่วงสัปดาห์ที่ผ่านมา?"

  • "มีการเปลี่ยนแปลงอะไรบ้างในระบบการยืนยันตัวตนของเรา?"

  • "แสดงตัวอย่างวิธีที่เราใช้จัดการข้อผิดพลาดในฐานโค้ดของเราให้ดูหน่อย"

  • "อะไรคือ dependencies หลักที่ใช้ในคอมโพเนนต์ส่วนหน้าของเรา?"

  • "ค้นหาการใช้งานฟังก์ชันการย้ายฐานข้อมูล"

  • "เรากำลังใช้รูปแบบความปลอดภัยใดสำหรับ API ปลายทาง?"


คำถามที่พบบ่อย

ฉันได้เชื่อมต่อพื้นที่ทำงาน Notion ผิดที่แล้ว ฉันจะยกเลิกการเชื่อมต่อ GitHub Repository ของฉันได้อย่างไร?

เจ้าของพื้นที่ทำงานสามารถยกเลิกการเชื่อมต่อหรือแก้ไขช่องทางต่างๆ ได้หลังจากที่การเชื่อมต่อเสร็จสมบูรณ์แล้ว โดยไปที่ การตั้งค่า → Notion AI เลือก ⚙️ ถัดจาก GitHub → การตั้งค่า → ยกเลิกการเชื่อมต่อ

การเชื่อมต่อต้องใช้เวลานานเท่าใดจึงจะเสร็จสมบูรณ์?

การตั้งค่าการเชื่อมต่ออาจใช้เวลาสูงสุด 72 ชั่วโมง ขึ้นอยู่กับขนาดของที่เก็บข้อมูลและประเภทแผนของ GitHub

ต้องใช้เวลานานเท่าใดกว่าเนื้อหาใหม่ใน GitHub จะแสดงใน Notion AI?

หลังจากการตั้งค่าเริ่มต้น ข้อมูลใหม่อาจใช้เวลาสูงสุด 3 ชั่วโมงในการจัดทำดัชนีโดย Notion AI. ข้อมูลที่มีปริมาณมากอาจใช้เวลาเพิ่มเติม

ทุกคนในพื้นที่ทำงาน Notion ของฉันสามารถเข้าถึงข้อมูลจาก GitHub ได้หรือไม่?

สมาชิกในพื้นที่ทำงานจะต้องยืนยันตัวตนและเข้าสู่ระบบแยกต่างหากเพื่อดึงข้อมูลจากที่เก็บข้อมูลส่วนตัวที่พวกเขามีสิทธิ์เข้าถึงอยู่แล้วใน GitHub

ฉันสามารถถามคำถามเกี่ยวกับข้อมูลย้อนหลังใน GitHub ได้นานแค่ไหน?

คุณสามารถดึงข้อมูล PR และ issue ย้อนหลังได้สูงสุดหนึ่งปีในที่เก็บข้อมูลของพวกเขา. ไฟล์ README ทั้งหมดจะพร้อมใช้งานโดยไม่มีข้อจำกัดด้านเวลา

Notion AI สามารถเข้าถึงอะไรได้บ้าง?

ในระหว่างขั้นตอนการเริ่มต้นใช้งาน หลังจากที่คุณเลือกองค์กร GitHub ที่คุณต้องการเชื่อมต่อแล้ว คุณสามารถเลือกได้ว่าต้องการให้ Notion AI เข้าถึง:

  • ที่เก็บข้อมูลทั้งหมด: สิ่งนี้ใช้กับที่เก็บข้อมูลปัจจุบันและอนาคตทั้งหมดที่เป็นเจ้าของโดยเจ้าของทรัพยากร รวมถึงที่เก็บข้อมูลสาธารณะ (อ่านอย่างเดียว) ด้วย

  • เลือกเฉพาะที่เก็บข้อมูล: เลือกที่เก็บข้อมูลอย่างน้อยหนึ่งแห่ง รวมถึงที่เก็บข้อมูลสาธารณะ (อ่านอย่างเดียว) ด้วย

Notion AI Connectors เคารพสิทธิ์ที่มีอยู่ของ Notion AI หรือไม่?

แน่นอน Notion AI จะเคารพสิทธิ์ที่มีอยู่ตาม แนวทางปฏิบัติด้านความปลอดภัยของ Notion AI ของเรา ผู้ใช้จะไม่สามารถสร้างเนื้อหาหรือรับการตอบกลับจาก Notion AI โดยอิงจากทรัพยากรของบุคคลที่สามที่ตนเองไม่มีสิทธิ์เข้าถึงได้

สำหรับเนื้อหาของบุคคลที่สามโดยเฉพาะ Notion AI จะจัดการทั้งเนื้อหาส่วนตัวและเนื้อหาสาธารณะโดยคำนึงถึงความปลอดภัย โดยจะนำเข้าเนื้อหาตามการแมปสิทธิ์ระหว่างผู้ใช้ GitHub และ Notion เท่านั้น

Notion AI จัดการการแมปสิทธิ์อย่างไร?

ผู้ใช้จะเห็นเฉพาะเนื้อหา GitHub (เช่น โค้ด, PR, ปัญหา) ใน Notion AI ที่ตนเองมีสิทธิ์เข้าถึงใน GitHub เท่านั้น แม้ว่าจะมีคนพยายามสอบถามข้อมูลจากที่เก็บข้อมูลที่ตนไม่มีสิทธิ์เข้าถึงใน GitHub แต่ Notion AI จะไม่ส่งคืนผลลัพธ์จากที่เก็บข้อมูลนั้น

  • ผู้ใช้จะต้องเป็นสมาชิกทั้ง GitHub และ Notion เพื่อยืนยันตัวตนแอปนี้ในระดับผู้ใช้

  • ผู้ใช้ไม่จำเป็นต้องใช้อีเมลเดียวกันใน Notion และ GitHub

  • สิทธิ์จะถูกแมปตามการตรวจสอบสิทธิ์ที่สำเร็จของผู้ใช้แต่ละคนด้วยบัญชี GitHub ของตน ไม่ใช่โดยการเปรียบเทียบอีเมล Notion AI อาศัยการเข้าสู่ระบบ OAuth เพื่อยืนยันตัวตนและขอบเขตของสิทธิ์ ไม่ใช่การจับคู่อีเมล

  • เราซิงค์สิทธิ์จาก GitHub ทุกชั่วโมงและอัปเดตสิทธิ์ใน Notion ตามนั้น

Notion จัดเก็บหรืออ้างอิงข้อมูล GitHub ของฉันในระบบอย่างไร?

เช่นเดียวกับผลิตภัณฑ์ Notion AI หลักของเรา เราสร้างและจัดเก็บการฝัง (embeddings) ในฐานข้อมูลเวกเตอร์ที่โฮสต์โดย Turbopuffer ซึ่งช่วยให้ตอบคำถามที่อ้างอิงเนื้อหาบุคคลที่สามได้ (เช่น GitHub) โดย Turbopuffer ได้รับการตรวจสอบจากทีมรักษาความปลอดภัยของเราและผู้ตรวจสอบภายนอกเพื่อให้ได้รับใบรับรอง SOC2 Type II ดูข้อมูลเพิ่มเติมเกี่ยวกับความปลอดภัยของ Turbopuffer ที่นี่ →


ให้ข้อเสนอแนะ

แหล่งข้อมูลนี้มีประโยชน์หรือไม่?