ใช้ Claude API วิเคราะห์เอกสารอย่างไร? พร้อมแนวทางส่งไฟล์และรับผลลัพธ์

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

เอกสารแบบใดส่งให้ Claude API ได้บ้าง

• PDF: ส่งเป็นเอกสารผ่าน Messages API ได้ และ Claude วิเคราะห์ข้อความ ตาราง แผนภูมิ และภาพภายใน PDF ได้
• ไฟล์ข้อความ: ส่งเนื้อหาเป็นข้อความในคำขอ หรืออัปโหลดเป็นไฟล์ข้อความเพื่ออ้างอิงภายหลัง
• ไฟล์ภาพ: ส่งเป็นเนื้อหารูปภาพเพื่อให้วิเคราะห์องค์ประกอบภาพ
• DOCX และ XLSX: หากต้องการวิเคราะห์เนื้อหา ให้แปลงหรือดึงข้อความออกมา แล้วส่งข้อความที่เกี่ยวข้องตามรูปแบบ API
• ไฟล์ข้อมูลขนาดใหญ่: หากต้องการให้ Claude ใช้เครื่องมือวิเคราะห์ข้อมูล ควรตรวจแนวทาง Files API และเครื่องมือที่รองรับก่อน

รูปแบบไฟล์และข้อจำกัดอาจแตกต่างตามโมเดลและแพลตฟอร์ม ควรตรวจเอกสาร API ล่าสุดก่อนวางระบบจริง

เลือกวิธีส่งเอกสาร

① ส่งข้อความตรงในคำขอ
เหมาะกับข้อความสั้นหรือเอกสารที่แปลงเป็นข้อความแล้ว และใช้วิเคราะห์เพียงครั้งเดียว

② ส่ง PDF เป็นส่วนหนึ่งของ Messages API
เหมาะกับการถามคำถามจาก PDF หนึ่งครั้ง โดยสามารถส่งเอกสารพร้อมคำสั่งในข้อความเดียวกัน

③ ใช้ Files API เมื่อจะอ้างอิงไฟล์ซ้ำ
อัปโหลดไฟล์แล้วรับ file_id จากนั้นนำรหัสนั้นไปอ้างอิงในคำขอ Messages ภายหลัง ช่วยลดการส่งเนื้อหาไฟล์ซ้ำทุกครั้ง

ตัวอย่างโครงสร้างคำขอวิเคราะห์เอกสาร

เมื่ออัปโหลด PDF ผ่าน Files API แล้ว สามารถส่ง file_id พร้อมคำถามใน Messages API ได้ ตัวอย่างโครงสร้าง:

{
  "model": "claude-sonnet-5-5",
  "max_tokens": 1000,
  "messages": [
    {
      "role": "user",
      "content": [
        {
          "type": "text",
          "text": "สรุปข้อค้นพบหลักจากเอกสาร พร้อมระบุประเด็นที่ควรตรวจสอบต่อ"
        },
        {
          "type": "document",
          "source": {
            "type": "file",
            "file_id": "file_id_from_upload"
          }
        }
      ]
    }
  ]
}

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

เขียนคำสั่งให้ได้ผลวิเคราะห์ที่ตรวจสอบได้

ระบุเป้าหมาย รูปแบบคำตอบ และวิธีจัดการข้อมูลที่ไม่พบ เช่น:

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

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

วางระบบรับไฟล์บนเว็บไซต์อย่างปลอดภัย

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

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

ข้อจำกัดและค่าใช้จ่ายที่ควรรู้

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

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

สรุป

Claude API วิเคราะห์เอกสารได้โดยส่งข้อความหรือ PDF ใน Messages API และใช้ Files API เมื่อต้องอ้างอิงไฟล์ซ้ำ ระบุคำถามและรูปแบบคำตอบให้ชัด ตรวจผลกับเอกสารจริง และจัดการ file_id กับ API Key ไว้ฝั่งเซิร์ฟเวอร์ ผู้ใช้ ComSiam ควรตรวจชนิดไฟล์ ข้อจำกัด ข้อมูลส่วนบุคคล และค่าใช้จ่ายก่อนเปิดใช้งานกับผู้ใช้จริง