GuidesOneMux

สร้างเวิร์กโฟลว์สกัดข้อมูลใน n8n ที่กู้คืนได้

ออกแบบเวิร์กโฟลว์สกัดข้อมูลใน n8n ที่ตรวจสอบระเบียน ลองซ้ำเมื่อเกิดความขัดข้องชั่วคราว และส่งกรณีผิดปกติให้ผู้ตรวจสอบโดยไม่เขียนข้อมูลซ้ำ

AI

สรุป · TL;DR

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

ประเด็นสำคัญ

  • ตรวจสอบฟิลด์ที่สกัดได้ก่อนเขียนข้อมูลไปยังระบบปลายทาง และส่งระเบียนที่ไม่ถูกต้องไปตรวจทานแทนการลองซ้ำไปเรื่อย ๆ
  • จำกัดจำนวนครั้งที่ลองซ้ำสำหรับความขัดข้องชั่วคราว พร้อมเก็บบันทึกการลองซ้ำไว้อย่างคงทนและกำหนดแนวทางส่งต่อเมื่อถึงขีดจำกัด
  • ป้องกันการเขียนข้อมูลปลายทางด้วยกลไก idempotency ที่ทำงานแบบ atomic และตรวจสอบผลลัพธ์ที่ไม่ชัดเจนก่อนลองซ้ำ
  • ใช้การอนุมัติการเรียกใช้เครื่องมือของ AI Agent ใน n8n สำหรับการกระทำที่มีความเสี่ยงซึ่ง Agent เป็นผู้เริ่ม และสร้างเส้นทางตรวจทานแยกต่างหากสำหรับแก้ไขข้อมูลที่สกัดได้
ในหน้านี้ (8)

เริ่มจากกำหนดข้อตกลงในการกู้คืน

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

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

สิ่งที่ต้องเตรียมและโครงสร้างเวิร์กโฟลว์

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

ใช้ลำดับการทำงานเชิงตรรกะดังนี้:

  1. ทริกเกอร์และลงทะเบียน: รับข้อมูลอ้างอิงเอกสาร แล้วสร้างหรือค้นหางานที่จัดเก็บไว้อย่างคงทนโดยใช้ ID ต้นทางที่คงที่และเวอร์ชันเอกสาร
  2. สกัดข้อมูล: ดึงเอกสารและขอฟิลด์ที่มีโครงสร้างจากตัวสกัดข้อมูลที่เลือก
  3. ตรวจสอบ: ตรวจข้อมูลที่ส่งกลับมาเทียบกับข้อกำหนดที่ระบุไว้อย่างชัดเจน
  4. ส่งต่อ: ส่งระเบียนที่ถูกต้องไปยังเส้นทางการเขียนข้อมูล และส่งระเบียนที่ไม่ถูกต้องไปยังคิวตรวจทาน
  5. เขียนและตรวจสอบผล: เขียนข้อมูลโดยใช้ idempotency key ที่คงที่ จากนั้นบันทึก ID ของระเบียนปลายทางและผลลัพธ์
  6. กู้คืน: ใช้เวิร์กโฟลว์แยกต่างหากที่ทำงานตามกำหนดเวลาเพื่อค้นหางานที่ถึงเวลาลองซ้ำหรือติดค้างเกินเกณฑ์ปฏิบัติการ

ID การทำงานของทริกเกอร์มีประโยชน์สำหรับการติดตาม แต่ไม่ใช่ตัวระบุเอกสารที่เชื่อถือได้เมื่อมีการรันซ้ำ ควรใช้ ID เอกสารจากระบบต้นทางร่วมกับเวอร์ชันหรือ content digest และกำหนดวิธีให้เวอร์ชันใหม่แก่เอกสารที่แก้ไขแล้วก่อนเปิดใช้การประมวลผลซ้ำอัตโนมัติ

ตรวจสอบระเบียนที่สกัดได้ก่อนเขียนข้อมูล

สำหรับตัวอย่างนี้ ให้กำหนดว่าต้องมี invoice_id, currency และ amount_minor โดยแทนจำนวนเงินด้วยหน่วยย่อยของสกุลเงิน เช่น เซนต์ เพื่อหลีกเลี่ยงการปัดเศษแบบ floating-point ระหว่างการตรวจสอบ ข้อกำหนดนี้ตั้งอยู่บนสมมติฐานว่าตัวสกัดข้อมูลแปลงจำนวนเงินตามกฎของสกุลเงินนั้นแล้ว ส่วนการใช้งานจริงต้องตรวจด้วยว่ารองรับสกุลเงินดังกล่าวและการแปลงใด ๆ นั้นเหมาะสม

วาง Code node หลังขั้นตอนสกัดข้อมูล JavaScript ตัวอย่างต่อไปนี้ตรวจสอบแต่ละ item ที่เข้ามาและส่งผลลัพธ์ที่นำไปตรวจทานได้กลับมา แทนที่จะ throw เมื่อพบข้อมูลผิดพลาด ตั้งค่าโหนดให้ประมวลผล item ที่เข้ามาทั้งหมด และตรวจสอบว่า JSON ของแต่ละ item เป็นระเบียนที่สกัดได้ก่อนที่โหนดนี้จะทำงาน

return $input.all().map((item) => {
  const record = item.json;
  const errors = [];

  if (typeof record.invoice_id !== 'string' || !record.invoice_id.trim()) {
    errors.push('invoice_id must be a non-empty string');
  }
  if (typeof record.currency !== 'string' || !/^[A-Z]{3}$/.test(record.currency)) {
    errors.push('currency must be a three-letter uppercase code');
  }
  if (!Number.isSafeInteger(record.amount_minor) || record.amount_minor < 0) {
    errors.push('amount_minor must be a non-negative safe integer');
  }

  return {
    json: {
      record,
      validation: { valid: errors.length === 0, errors },
    },
  };
});

ตามด้วย IF node ที่ตรวจสอบ validation.valid เก็บ job ID และข้อมูลอ้างอิงต้นทางไว้ควบคู่กับผลลัพธ์นี้ โดยเก็บไว้ใน item หรือค้นหาจากที่เก็บสถานะของคุณก็ได้ regex ตรวจสอบเพียง รูปแบบ ของรหัสสกุลเงิน ไม่ได้ตรวจว่าเป็นสกุลเงินจริงที่รองรับหรือไม่ เพิ่มการตรวจสอบทางธุรกิจ เช่น การจับคู่ซัพพลายเออร์และการตรวจหาใบแจ้งหนี้ซ้ำ ก่อนเขียนข้อมูล

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

กำหนดกฎการลองซ้ำและการส่งต่อ

กำหนดหลักเกณฑ์การตัดสินใจลองซ้ำให้ชัดเจน นโยบายต่อไปนี้เป็นเพียงจุดเริ่มต้น ไม่ได้รับประกันว่าทุกบริการจะใช้รหัสสถานะเหล่านี้ในลักษณะเดียวกัน

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

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

ใช้การตั้งค่าจัดการข้อผิดพลาดและการลองซ้ำที่มีใน n8n ตามความเหมาะสม แต่อย่าใช้ execution log เพียงอย่างเดียวเป็นคิว เวิร์กโฟลว์กู้คืนที่ทำงานตามกำหนดเวลาควรค้นหาสถานะงานที่จัดเก็บไว้อย่างคงทนและจับจองงานที่เข้าเกณฑ์แบบ atomic เพื่อไม่ให้ worker สองตัวประมวลผลงานเดียวกันพร้อมกัน ตรวจสอบการตั้งค่าโหนดและพฤติกรรมการล็อกฐานข้อมูลที่ใช้จริงในระบบของคุณ

ทำให้การเขียนข้อมูลกู้คืนได้อย่างปลอดภัย

ก่อนเขียนข้อมูลไปยังปลายทางครั้งแรก ให้บันทึก operation key ที่คงที่ซึ่งสร้างจากตัวระบุและเวอร์ชันของเอกสารต้นทาง แล้วใช้ key เดิมทุกครั้งที่ลองซ้ำ ระบบปลายทางต้องบังคับความไม่ซ้ำหรือรองรับ idempotency key แบบ atomic การตรวจว่ามีระเบียนอยู่แล้วหรือไม่แล้วจึงแทรกข้อมูลแยกต่างหากอาจเกิดปัญหาเมื่อมี worker ทำงานพร้อมกัน

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

ติดตามสถานะ เช่น received, extracting, review_required, ready_to_write, write_unknown และ completed กำหนด lease หรือเส้นตายสำหรับงานที่กำลังดำเนินการ และให้กระบวนการกู้คืนตรวจสอบ lease ที่หมดอายุ เก็บ ID ของระเบียนปลายทางหลังยืนยันว่าการเขียนสำเร็จแล้วเท่านั้น เก็บประวัติความพยายามและการเปลี่ยนสถานะไว้เพื่อให้ผู้ปฏิบัติงานอธิบายสิ่งที่เกิดขึ้นได้ โดยไม่เปิดเผยเนื้อหาเอกสารใน log เกินความจำเป็น

เพิ่มการตรวจทานโดยคนในจุดที่เหมาะสม

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

ฟีเจอร์อีกส่วนหนึ่งของ n8n ใช้ในกรณีที่ AI Agent เรียกใช้เครื่องมือ เอกสาร human-in-the-loop ของ n8n ระบุว่าสามารถหยุดการเรียกใช้เครื่องมือที่เลือกไว้เพื่อรอการอนุมัติหรือปฏิเสธ โดยแสดงเครื่องมือและพารามิเตอร์ที่เสนอต่อผู้ตรวจทาน ในแผง Tools ของ Agent ให้เพิ่มขั้นตอน human review ตั้งค่าช่องทางที่รองรับ และเชื่อมต่อเครื่องมือที่ต้องได้รับการอนุมัติ เอกสารยังแนะนำให้ระบุใน system prompt ของ Agent ด้วยว่าเครื่องมือใดต้องได้รับการอนุมัติและควรจัดการอย่างไรเมื่อถูกปฏิเสธ

การอนุมัติการใช้เครื่องมือนี้ไม่ใช่สิ่งทดแทนการตรวจสอบ schema หรือคิวแก้ไขระเบียนอเนกประสงค์ เครื่องมือที่ได้รับอนุมัติจะทำงานด้วย input ที่ AI เสนอ หากผู้ตรวจทานต้องเปลี่ยนฟิลด์ที่สกัดได้ ให้ใช้เส้นทางแก้ไขและตรวจสอบอีกครั้งก่อนเขียนข้อมูลใด ๆ

ตรวจสอบการปฏิบัติการก่อนเปิดใช้งาน

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

เริ่มจากกำหนดขีดจำกัดการลองซ้ำและกฎการตรวจทานอย่างระมัดระวัง แล้วปรับตามประเภทความขัดข้องที่พบจริง คงจุดควบคุมการตรวจสอบและ idempotency ไว้แม้จะขยายระบบอัตโนมัติมากขึ้น

แหล่งข้อมูล

  • n8n: Human-in-the-loop for tools — พฤติกรรมการอนุมัติการใช้เครื่องมือ การตั้งค่า ช่องทาง และคำแนะนำเกี่ยวกับ prompt ของ Agent

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

เวิร์กโฟลว์ n8n ควรลองซ้ำกับระเบียนที่ไม่ผ่านการตรวจสอบ schema หรือไม่?

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

การตรวจทานโดยคนใน n8n ตรวจสอบข้อมูลที่สกัดได้โดยอัตโนมัติหรือไม่?

ไม่ ฟีเจอร์ตรวจทานการใช้เครื่องมือของ AI Agent ที่ระบุในเอกสารให้คนอนุมัติหรือปฏิเสธการเรียกใช้เครื่องมือที่เสนอ ส่วนการตรวจสอบ schema และกระบวนการแก้ไขระเบียนต้องออกแบบเวิร์กโฟลว์แยกต่างหาก

เวิร์กโฟลว์จะหลีกเลี่ยงการเขียนข้อมูลซ้ำหลังหมดเวลาได้อย่างไร?

ใช้ operation key ที่คงที่ซ้ำและให้ระบบปลายทางบังคับใช้ key นั้นแบบ atomic หากไม่ทราบผลลัพธ์ ให้ตรวจสอบกระทบยอดกับระบบปลายทางก่อนลองซ้ำ และส่งต่อให้ผู้รับผิดชอบเมื่อไม่สามารถยืนยันผลลัพธ์ได้

บทความที่เกี่ยวข้อง

Guides

สร้างเวิร์กโฟลว์ถามตอบจากเอกสารใน n8n พร้อมตรวจสอบการอ้างอิงและให้มนุษย์ทบทวน

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

阅读全文 →

Guides

สร้างเวิร์กโฟลว์ดึงข้อมูลใน n8n ที่ทำซ้ำได้ พร้อมการตรวจสอบ การลองใหม่ และการตรวจทานโดยมนุษย์

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

阅读全文 →

Guides

Gemini 4 Hydrogen เทียบกับ Carbon สำหรับการดำเนินงานเวิร์กโฟลว์ในระบบจริง

หลักฐานที่มีอยู่บอกอะไรเกี่ยวกับ Gemini 4 Hydrogen และ Carbon ในด้านการเขียนโค้ด การเรียกใช้เครื่องมือ ผลลัพธ์แบบมีโครงสร้าง และเวิร์กโฟลว์ในระบบจริงที่กู้คืนได้

阅读全文 →

Guides

สร้างเวิร์กโฟลว์ n8n สำหรับดึงข้อมูลเหตุขัดข้องจาก API ที่ทนทาน

ออกแบบเวิร์กโฟลว์ n8n เพื่อดึงข้อมูลเหตุขัดข้องจาก API ตรวจสอบโครงสร้าง แสดงข้อผิดพลาดจากการลองใหม่และการตรวจสอบ พร้อมส่งการดำเนินการต่อที่มีความเสี่ยงให้มนุษย์อนุมัติ

阅读全文 →