การใช้งาน

API ของเราอยู่ในมาตรฐาน GraphQL ซึ่งผู้ใช้สามารถขอข้อมูล (Query) ได้ที่ https://politigraph.wevis.info/graphql ผ่าน GraphQL Client หรือ HTTP Request

นอกจากนี้เรายังมี

• GraphQL Playground ให้เข้าไปทดลองสร้าง Query ต่างๆ และสำรวจผลลัพธ์ที่ได้
• พื้นที่สำรวจข้อมูล ผ่าน Interactive Visualization

การระบุชื่อแอปพลิเคชัน

หากเรียกใช้ API จาก server, script หรือ SSR กรุณาส่ง Header apollographql-client-name และ apollographql-client-version (ไม่บังคับ) เพื่อให้เราทราบสถิติการใช้งาน ส่วน Request ที่มาจากเบราว์เซอร์นั้นระบุที่มาจาก Origin โดยอัตโนมัติ

การใช้งานร่วมกับ AI Agent

คุณสามารถใช้ Politigraph กับ AI Agent หรือ Chatbot ได้ 2 ช่องทาง

ผลลัพธ์จาก AI อาจคลาดเคลื่อนหรือไม่ตรงกับข้อมูลจริง

AI Agent อาจสร้าง Query ที่ไม่ตอบคำถามของคุณ ตีความ Schema ผิด หรือสรุปตัวเลขที่ไม่ได้มาจาก Politigraph เลย ก่อนนำผลลัพธ์ไปใช้อ้างอิงหรือเผยแพร่ โปรดตรวจสอบผลลัพธ์ด้วยตนเองอีกครั้ง เช่น รันซ้ำผ่าน GraphQL Playground

llms.txt

เราเตรียมคู่มือการใช้ที่ AI สามารถอ่านได้ตามมาตรฐาน llms.txt ดังนี้

• /llms.txt: สารบัญของเอกสารต่างๆ พร้อมลิงก์
• /llms-full.txt: เอกสารทั้งหมดพร้อม GraphQL Schema ฉบับเต็ม รวมอยู่ในไฟล์เดียว
• /schema.graphql: GraphQL Schema (SDL) ฉบับเต็ม

คุณสามารถส่ง URL https://politigraph.wevis.info/llms.txt ให้ AI Agent เลือกอ่านเฉพาะส่วนที่ต้องการ หรือส่ง https://politigraph.wevis.info/llms-full.txt เพื่อให้ข้อมูลทั้งหมดในครั้งเดียว

ตัวอย่าง Prompt

ทำความเข้าใจ Politigraph จาก https://politigraph.wevis.info/llms.txt แล้วหาว่า ส.ส. คนไหนขาดลงมติมากที่สุดในสมัยปัจจุบัน จากนั้นอธิบาย Query ที่ใช้และผลลัพธ์ที่ได้จาก Politigraph อย่างเป็นขั้นตอน

MCP Server

หาก AI Agent ของคุณรองรับ Model Context Protocol สามารถเชื่อมต่อกับ MCP Endpoint ของเราได้ที่ https://politigraph.wevis.info/mcp โดยไม่ต้องยืนยันตัวตนหรือใช้ API Key

ตัวอย่างการตั้งค่า MCP Client

{ "type": "http", "url": "https://politigraph.wevis.info/mcp" }

การใช้งานผ่านช่องทางต่างๆ

AI Agent ที่ทำงานบนเครื่องของคุณสามารถอ่านคู่มือและส่ง Query เองเพื่อเข้าถึงข้อมูลจริงได้ ส่วน Chatbot บนเว็บโดยพื้นฐานทำได้เพียงแค่อ่านคู่มือและช่วยคุณเขียน Query เท่านั้น คุณต้องรันเองที่ GraphQL Playground หากต้องการให้ Chatbot ตอบด้วยข้อมูลจริง ให้เชื่อมต่อกับ MCP Server ของเราแทน

Chatbot บนเว็บ

ผู้ให้บริการ	llms.txt	MCP Server
ChatGPT	อ่านได้ ช่วยเขียน Query	Custom Connector ใน Developer Mode สำหรับแพ็กเกจแบบเสียเงิน
Claude	อ่านได้ ช่วยเขียน Query	Custom Connector ได้ทุกแพ็กเกจ ทั้งเว็บและ Desktop โดยแพ็กเกจฟรีเชื่อมได้ 1 รายการ
Gemini	อ่านได้ ช่วยเขียน Query	เพิ่มเป็น Custom App ใน Spark สำหรับ AI Pro และ Ultra หรือให้ผู้ดูแลระบบเพิ่มในแพ็กเกจ Business
Perplexity	อ่านได้ ช่วยเขียน Query	Custom Remote Connector สำหรับแพ็กเกจแบบเสียเงิน
Microsoft Copilot	อ่านได้ ช่วยเขียน Query	ใช้ได้ผ่าน Agent ที่สร้างใน Copilot Studio เท่านั้น

AI Agent บนเครื่อง

Client	llms.txt	MCP Server
Claude Code	อ่านได้และรัน Query ได้	ได้
Codex CLI	ต้องตั้งค่า network_access = true	ได้
Gemini CLI	อ่านได้และรัน Query ได้	ได้ โดยตั้งค่าผ่าน httpUrl
Cursor	อ่านได้และรัน Query ได้	ได้
VS Code ที่ใช้ GitHub Copilot	อ่านได้และรัน Query ได้	ได้

ตรวจสอบล่าสุดเมื่อ 7 กันยายน 2569

ข้อจำกัด

การเข้าถึง

ข้อมูลส่วนใหญ่จาก Politigraph API เป็นแบบเปิดให้เข้าถึงโดยสาธารณะ ไม่จำเป็นต้องยืนยันตัวตน ยกเว้น

• ข้อมูลที่มี Field publish_status และไม่ได้มีค่าเป็น PUBLISHED จะถูกซ่อนจาก Response เนื่องจากอยู่ระหว่างการตรวจสอบและยังไม่พร้อมเปิดเผย
• การ Mutate ผ่าน GraphQL ใดๆ เราป้องกันไม่ให้คนภายนอกแก้ไขข้อมูลบนระบบของเรา

ทั้งสองข้อสงวนสิทธ์การเข้าถึงให้กับทีมดูแลระบบของ WeVis เท่านั้น

การจำกัดการใช้งาน API

เพื่อป้องกัน API ให้สามารถรองรับผู้ใช้งานได้ดีที่สุด เราจำกัดการใช้งานผ่าน GraphQL และ MCP รวมกันดังนี้:

• การเรียกใช้ API สูงสุดอยู่ที่ 30 Requests ต่อ 10 วินาที
• จำนวน Batched Request สูงสุดอยู่ที่ 5 Operations ต่อ Batched Request
• จำนวน Alias: 120 ต่อ Operation
• ความลึก: 10 ระดับของ Operation ที่ซ้อนกัน
• จำนวน Token: 10,000 Token ต่อ Request

จะได้รับ Error Response หากใช้งานเกินข้อกำหนด

การจำกัดจำนวน Node

ข้อมูลบางประเภท ได้แก่ คน (People) และ การลงคะแนนรายบุคคล (Vote) เป็นข้อมูลที่มี Node อยู่จำนวนมากในระบบ เราจำเป็นต้องจำกัดจำนวน Node ที่จะส่งกลับมายังผู้ใช้ ไม่เกิน 1,000 Node ต่อการ Query 1 ครั้ง หากต้องการเรียกข้อมูลมากกว่าจำนวนที่จำกัดไว้ อ่านเพิ่มเติมเกี่ยวกับการใช้ Pagination บน GraphQL

การอนุญาตใช้งาน (License)

ด้านข้อมูล ทีมงานตั้งใจเปิดข้อมูลเป็น Open Data ภายใต้เงื่อนไข Attribution-NonCommercial 4.0 International ซึ่งหมายถึง สามารถนำข้อมูลไปใช้ ดัดแปลง ต่อยอดได้ แต่ห้ามนำไปใช้ทางการค้าหรือแสวงหาผลกำไรจากผลงาน และต้องให้เครดิตกับ WeVis

ด้าน Source Code ทางทีมมีความตั้งใจที่พัฒนาทุกโปรเจ็กต์ให้เป็น Open Source ภายใต้เงื่อนไข Attribution-NonCommercial-ShareAlike 4.0 International ซึ่งหมายถึง สามารถนำผลงานไปใช้ ดัดแปลง ต่อยอดได้ แต่ห้ามนำไปใช้ทางการค้าหรือแสวงหาผลกำไรจากผลงาน และต้องแจ้งทราบและให้เครดิตกับเจ้าของผลงาน โดยที่ผลงานที่เกิดขึ้นมาจะต้องอยู่ภายใต้เงื่อนไขแบบเดียวกันกับใบอนุญาต Creative Commons ของต้นฉบับ โดย WeVis Ltd. และ Punch Up Ltd. เป็น ผู้อนุญาต (licensor) ร่วมกัน