สร้างเวิร์กโฟลว์ถามตอบเอกสารด้วย n8n พร้อมการอนุมัติโดยมนุษย์และ API ที่เข้ากันได้กับ OpenAI

ควรให้มีการอนุมัติ ณ จุดใด?

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

แนวทางออกแบบ n8n ที่ใช้ได้จริงมีดังนี้:

1. รับคำถาม
2. ให้ AI Agent เตรียมคำขอค้นหาเอกสาร
3. พักเวิร์กโฟลว์เพื่อรอการอนุมัติจากมนุษย์ก่อนเรียกใช้เครื่องมือค้นหา เมื่อคลังเอกสารมีข้อมูลอ่อนไหว คำค้นอาจเปิดเผยข้อมูลที่จำกัดสิทธิ์ หรือการค้นหามีต้นทุนในการดำเนินงาน
4. ดึงข้อความบางส่วนพร้อม metadata ของแหล่งที่มา
5. ขอให้โมเดลตอบโดยอ้างอิงเฉพาะข้อความเหล่านั้น
6. ส่งคำตอบพร้อมแหล่งอ้างอิง หรือส่งร่างคำตอบไปยังขั้นตอนอนุมัติที่สองก่อนเผยแพร่

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

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

สิ่งที่ต้องเตรียม

คุณต้องมี:

• เวิร์กโฟลว์ n8n ที่มี AI Agent และการเชื่อมต่อกับโมเดล
• แหล่งเอกสารที่ค้นหาได้ เช่น vector store, ฐานข้อมูล หรือบริการค้นหาภายในองค์กร ตัวเชื่อมต่อที่ใช้จริงขึ้นอยู่กับแอปพลิเคชัน และไม่ได้ระบุไว้ในหน้าเอกสาร n8n ที่อ้างถึง
• เครื่องมือค้นคืนที่ส่งคืนข้อความพร้อม metadata ของเอกสาร
• ช่องทางอนุมัติที่ตั้งค่าไว้ใน n8n เอกสารระบุช่องทางที่มีให้ใช้ ได้แก่ Chat, Slack, Discord, Telegram, Microsoft Teams, Gmail, WhatsApp Business Cloud, Google Chat และ Microsoft Outlook
• สิทธิ์เข้าถึงปลายทาง API ที่เข้ากันได้กับ OpenAI OneMux ให้บริการเข้าถึงโมเดล AI ชั้นนำผ่าน API เดียวที่เข้ากันได้กับ OpenAI โปรดดู คู่มือเริ่มต้นใช้งาน OneMux และ เอกสาร API สำหรับข้อมูลปลายทางและวิธีการยืนยันตัวตนล่าสุด

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

โครงสร้างเวิร์กโฟลว์ n8n ที่แนะนำ

แบ่งเวิร์กโฟลว์ออกเป็นห้าขั้นตอนหลัก:

1. รับและปรับรูปแบบคำถามให้เป็นมาตรฐาน

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

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

2. เพิ่มเครื่องมือค้นหาเอกสาร

เชื่อมต่อเครื่องมือค้นหากับ AI Agent โดยกำหนดอินพุตให้แคบและชัดเจน ตัวอย่างเช่น:

{
  "query": "string",
  "document_scope": "string or controlled value",
  "max_results": "integer"
}

ผลการค้นหาควรเก็บ metadata ให้เพียงพอสำหรับการอ้างอิงที่เป็นประโยชน์:

{
  "text": "Approved passage from the document",
  "title": "Document title",
  "url": "Document URL or stable identifier",
  "page": "Page number when available",
  "section": "Section heading when available",
  "chunk_id": "Stable passage identifier"
}

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

3. กำหนดให้เครื่องมือที่เลือกผ่านการตรวจสอบโดยมนุษย์

เปิดแผง Tools ของ AI Agent แล้วไปที่ส่วน Human review เลือกช่องทางอนุมัติ และเชื่อมต่อเครื่องมือค้นหาเอกสารเข้ากับขั้นตอนตรวจสอบนั้น จากนั้นตั้งค่าข้อมูลรับรองและการตั้งค่าของช่องทางที่เลือกใน n8n

ข้อความแจ้งผู้ตรวจสอบสามารถแสดงการดำเนินการและพารามิเตอร์ที่เสนอได้ เอกสารของ n8n ระบุตัวแปร $tool.name และ $tool.parameters สำหรับจุดประสงค์นี้ ตัวอย่างข้อความที่นำไปใช้ได้คือ:

The AI wants to use {{ $tool.name }} with these parameters:
{{ JSON.stringify($tool.parameters, null, 2) }}

Approve only if the query and document scope are appropriate for this request.

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

4. เชื่อมต่อปลายทางโมเดลที่เข้ากันได้กับ OpenAI

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

รูปแบบคำขอทั่วไปอาจมีลักษณะดังนี้ แต่เป็นเพียงตัวอย่างประกอบ ไม่ใช่สูตรการตั้งค่า OneMux ที่ผ่านการทดสอบแล้ว:

curl https://api.example-provider.invalid/v1/chat/completions \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "YOUR_MODEL_ID",
    "messages": [
      {"role": "system", "content": "Answer only from supplied document passages."},
      {"role": "user", "content": "What does the document say about retention?"}
    ]
  }'

แทนที่ URL, วิธีจัดการคีย์ และ model ID ตัวอย่างด้วยค่าจากเอกสารล่าสุดของผู้ให้บริการ อย่าเปิดเผยข้อมูลรับรองในไฟล์ส่งออกเวิร์กโฟลว์หรือข้อความอนุมัติที่ผู้ใช้มองเห็นได้ หาก node โมเดลของ n8n ต้องใช้พารามิเตอร์ที่ปลายทางไม่รองรับ ให้ใช้การตั้งค่าที่เข้ากันได้ หรือออกแบบโดยใช้ HTTP Request เฉพาะเมื่อข้อกำหนดด้านความปลอดภัยและการแยกวิเคราะห์คำตอบของคุณรองรับ

5. กำหนดให้คำตอบระบุแหล่งที่มาในพรอมป์ต์

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

You answer questions about the supplied documents.

Rules:
- Use only the passages in DOCUMENT_CONTEXT.
- If the passages do not support an answer, say that the documents do not establish it.
- Do not create titles, URLs, page numbers, or quotations.
- Cite each factual answer using the supplied title and page, section, URL, or chunk ID.
- Distinguish a direct statement from an inference.

DOCUMENT_CONTEXT:
{{ JSON.stringify($json.documents) }}

QUESTION:
{{ $json.question }}

รูปแบบ expression ที่แน่นอนขึ้นอยู่กับวิธีที่ node ก่อนหน้าใน n8n จัดรูปข้อมูล ให้ใช้พรอมป์ต์นี้เป็นแนวทาง ไม่ใช่ไฟล์ส่งออกเวิร์กโฟลว์ที่นำไปใช้ได้ทันที

การออกแบบการอนุมัติ: ขั้นค้นคืนหรือขั้นเผยแพร่

มีจุดอนุมัติที่เหมาะสมอยู่สองตำแหน่ง:

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

System prompt และการจัดการเมื่อถูกปฏิเสธ

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

นโยบายแบบกระชับ:

The document_search tool requires human approval. If it is denied, do not call it again for the same request. Tell the user that the lookup was not approved. Never answer from memory when document evidence is required.

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

การแก้ปัญหาและข้อจำกัด

คำขออนุมัติไม่มีบริบทที่เป็นประโยชน์

ตรวจสอบว่าอินพุตของเครื่องมือใช้ฟิลด์ที่ชัดเจน และข้อความตรวจสอบมี $tool.name กับ $tool.parameters อย่าซ่อนขอบเขตสำคัญไว้ในสตริงที่ตีความได้ยาก

ไม่มีการอ้างอิงแหล่งที่มา

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

ปลายทางปฏิเสธคำขอ

ตรวจสอบ base URL, authentication header, model ID, การรองรับการเรียกใช้เครื่องมือ ขีดจำกัดบริบท และชื่อพารามิเตอร์ คำว่าเข้ากันได้กับ OpenAI ไม่ได้หมายความว่าเหมือนกันทุกประการ ต้องตรวจสอบความเข้ากันได้ทั้งกับรูปแบบคำขอของ n8n และ API ที่ระบุไว้ในเอกสารของผู้ให้บริการ

การปฏิเสธทำให้คำตอบฟังไม่เป็นธรรมชาติ

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

เวิร์กโฟลว์ทำงานช้าเกินไป

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

การวางแผนต้นทุนและการดำเนินงาน

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

หากต้องการดูข้อมูลการใช้จ่ายและบริบทในการเลือกโมเดล โปรดดู แค็ตตาล็อกโมเดล OneMux เลือกโมเดลโดยพิจารณาจากความสามารถที่เวิร์กโฟลว์ต้องใช้จริง โดยเฉพาะ structured output หรือการเรียกใช้เครื่องมือ

สรุป

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

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

แหล่งข้อมูล

• n8n: Human-in-the-loop for tools — แหล่งข้อมูลเกี่ยวกับการอนุมัติการใช้เครื่องมือ ช่องทางอนุมัติ expression $tool และคำแนะนำในการจัดการเมื่อถูกปฏิเสธ
• เอกสาร OneMux — เอกสารของผู้ให้บริการเกี่ยวกับวิธีใช้ API และรายละเอียดความเข้ากันได้ล่าสุด
• คู่มือเริ่มต้นใช้งาน OneMux — จุดเริ่มต้นสำหรับตั้งค่าปลายทางและการยืนยันตัวตน
• ราคา OneMux — แหล่งอ้างอิงราคาปัจจุบันที่ควรตรวจสอบก่อนนำไปใช้งาน