เชื่อมต่ออินทิเกรชัน

TaskGoblin เชื่อมต่อกับเครื่องมือสองประเภท และความต่างนี้กำหนดวิธีที่คุณสมัครใช้งาน

• ผู้ให้บริการ git — GitLab หรือ GitHub — ให้ repository และจัดเตรียมองค์กรของคุณ หนึ่งรายต่อหนึ่งองค์กรพอดี เลือกตอนล็อกอิน
• ผู้ให้บริการความสามารถ — Linear, Jira, Slack และ Microsoft Teams — เพิ่มพื้นที่ที่ลูปจะทำงานและก็อบลินจะรายงานผลได้ กลุ่มนี้คุณเชื่อมต่อเข้ากับองค์กรที่มีอยู่แล้ว

จัดการทั้งหมดได้จาก อินทิเกรชัน ในเมนูองค์กรของคุณ (/{organisation}/integrations)

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

ผู้ให้บริการ git (GitLab หรือ GitHub)

การล็อกอิน คือ การเชื่อมต่อผู้ให้บริการ git ของคุณ — การให้ความยินยอม OAuth ครั้งเดียวทั้งยืนยันตัวตนและจัดเตรียมองค์กรพร้อม repository นี่คือเหตุผลที่ไม่มีขั้นตอน "เชื่อมต่อ repo" แยกต่างหาก

GitLab

การเชื่อมต่อ GitLab จะไล่รายชื่อกลุ่มที่คุณสังกัด และจัดเตรียมองค์กร TaskGoblin ให้แต่ละกลุ่ม พร้อมองค์กรส่วนตัวอีกหนึ่ง ก็อบลินจะโพสต์ในนาม @taskgoblin บนเมิร์จรีเควสต์และอิชชู หากโทเคนต้องรีเฟรช หน้าอินทิเกรชันมีปุ่ม เชื่อมต่อใหม่ เพียงคลิกเดียว

ติดตั้ง: รีวิวเมิร์จรีเควสต์, ทำงานกับอิชชูที่ได้รับมอบหมาย

GitHub

GitHub เป็น GitHub App ไม่ใช่แอป OAuth แบบเดิม คุณติดตั้งแอป TaskGoblin บนองค์กรที่ต้องการ และการติดตั้งแต่ละครั้งจะกลายเป็นองค์กร TaskGoblin หนึ่งองค์กร แอปจะออกโทเคนติดตั้งอายุสั้นตามต้องการ และก็อบลินโพสต์ในนาม taskgoblin[bot] เพราะสิทธิ์รีเฟรชผ่านตัวการติดตั้งเอง องค์กร GitHub จึงไม่ต้องเชื่อมต่อใหม่ด้วยมือเลย

ติดตั้ง: รีวิวพูลรีเควสต์, ทำงานกับอิชชูที่ติดเลเบล

องค์กรที่จัดเตรียมผ่าน git จะผูกกับผู้ให้บริการที่สร้างมันขึ้น — การ์ดของผู้ให้บริการนั้นจะแสดง เชื่อมต่อใหม่ แทนการยกเลิกการเชื่อมต่อ

ผู้ให้บริการความสามารถ

Linear

การให้ความยินยอม OAuth เพียงคลิกเดียวเข้ากับองค์กรที่ใช้งานอยู่ เมื่อเชื่อมต่อแล้ว ก็อบลินจะรับอิชชูที่มอบหมายให้เอเจนต์ TaskGoblin อ่านอิชชูและคอมเมนต์เป็นบริบท และโพสต์สถานะ ความเคลื่อนไหว และลิงก์เมิร์จรีเควสต์กลับไปที่อิชชู

ติดตั้ง: ทำงานกับอิชชูที่ได้รับมอบหมาย

Jira

การให้ความยินยอม OAuth ของ Atlassian ที่เชื่อมไซต์ Jira ของคุณเข้ากับองค์กรที่ใช้งานอยู่ ก็อบลินจะรับอิชชูที่มอบหมายให้บัญชี TaskGoblin และตอบการกล่าวถึงในคอมเมนต์ของอิชชู โดยตอบเป็นคอมเมนต์บนอิชชู และเลื่อนสถานะตามเวิร์กโฟลว์ของคุณเมื่อคุณสั่ง

อิชชูใน Jira แทบไม่เคยระบุ repository ก็อบลินจึงคิดหาปลายทางจากตัวคำขอเอง จากหน่วยความจำองค์กร และจาก repository ที่คุณเชื่อมต่อไว้ — และจะถามแทนที่จะเดา เมื่อมันไม่มีทางรู้จริง ๆ บอกครั้งเดียวก็พอ เพราะมันจะจดคำตอบไว้

ติดตั้ง: ทำงานกับอิชชูที่ได้รับมอบหมาย

Slack

การเชื่อมต่อ Slack ทำให้ใครก็ตามกล่าวถึงก็อบลินในเธรดแล้วได้รับคำตอบตรงที่บทสนทนากำลังเกิดขึ้น โทเคนของบอตไม่หมดอายุ จึงไม่มีอะไรต้องรีเฟรช Slack ยังเป็นที่ที่ลูปตามตารางเวลาส่งสรุปและคำเตือนมาให้ เมื่อคำสั่งระบุชื่อแชนแนลไว้

ไม่ติดตั้งลูปของตัวเอง — มันเป็นพื้นที่ ไม่ใช่ทริกเกอร์

Microsoft Teams

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

ไม่ติดตั้งลูปของตัวเอง

ก็อบลินยืนยันตัวตนเป็นตัวเองอย่างไร

คุณไม่ต้องวางโทเคนการเข้าถึงส่วนตัวลงใน TaskGoblin เลย และก็อบลินก็ไม่เคยเห็นข้อมูลรับรองของคุณ

ผู้ให้บริการแต่ละรายมีตัวตนบอตของตัวเอง — @taskgoblin บน GitLab, Slack และ Teams, taskgoblin[bot] บน GitHub ภายในแซนด์บ็อกซ์ ข้อมูลรับรอง git จะถูกจัดเตรียมรายองค์กรตอนรันไทม์ (โทเคน OAuth ของ GitLab หรือโทเคนติดตั้ง GitHub ที่เพิ่งออกใหม่) แล้วฉีดเข้าไปในสภาพแวดล้อม รอบ ๆ เอเจนต์ แทนที่จะยื่นให้มันอ่าน

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

การยกเลิกการเชื่อมต่อ

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

ไปต่อที่ไหน

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