# การใช้งาน

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

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

- [GraphQL Playground](https://politigraph.wevis.info/graphql) ให้เข้าไปทดลองสร้าง Query ต่างๆ และสำรวจผลลัพธ์ที่ได้
- [พื้นที่สำรวจข้อมูล](https://politigraph.wevis.info/explore) ผ่าน Interactive Visualization

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

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

> **Caution: ผลลัพธ์จาก AI อาจคลาดเคลื่อนหรือไม่ตรงกับข้อมูลจริง**
>
> AI Agent อาจสร้าง Query ที่ไม่ตอบคำถามของคุณ ตีความ Schema ผิด หรือสรุปตัวเลขที่ไม่ได้มาจาก Politigraph เลย
> ก่อนนำผลลัพธ์ไปใช้อ้างอิงหรือเผยแพร่ โปรดตรวจสอบผลลัพธ์ด้วยตนเองอีกครั้ง เช่น รันซ้ำผ่าน [GraphQL Playground](https://politigraph.wevis.info/graphql)

### llms.txt

เราเตรียมคู่มือการใช้ที่ AI สามารถอ่านได้ตามมาตรฐาน [llms.txt](https://llmstxt.org) ดังนี้

- [`/llms.txt`](https://politigraph.wevis.info/llms.txt): สารบัญของเอกสารต่างๆ พร้อมลิงก์
- [`/llms-full.txt`](https://politigraph.wevis.info/llms-full.txt): เอกสารทั้งหมดพร้อม GraphQL Schema ฉบับเต็ม รวมอยู่ในไฟล์เดียว
- [`/schema.graphql`](https://politigraph.wevis.info/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](https://modelcontextprotocol.io) สามารถเชื่อมต่อกับ 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](https://politigraph.wevis.info/graphql) หากต้องการให้ Chatbot ตอบด้วยข้อมูลจริง ให้เชื่อมต่อกับ MCP Server ของเราแทน

#### Chatbot บนเว็บ

| ผู้ให้บริการ                                                                                                     | llms.txt                | MCP Server                                                                                      |
| ---------------------------------------------------------------------------------------------------------------- | ----------------------- | ----------------------------------------------------------------------------------------------- |
| [ChatGPT](https://platform.openai.com/docs/guides/developer-mode)                                                | อ่านได้ ช่วยเขียน Query | Custom Connector ใน Developer Mode สำหรับแพ็กเกจแบบเสียเงิน                                     |
| [Claude](https://support.claude.com/en/articles/11175166-get-started-with-custom-connectors-using-remote-mcp)    | อ่านได้ ช่วยเขียน Query | Custom Connector ได้ทุกแพ็กเกจ ทั้งเว็บและ Desktop โดยแพ็กเกจฟรีเชื่อมได้ 1 รายการ              |
| [Gemini](https://support.google.com/g/answer/17106276)                                                           | อ่านได้ ช่วยเขียน Query | เพิ่มเป็น Custom App ใน Spark สำหรับ AI Pro และ Ultra หรือให้ผู้ดูแลระบบเพิ่มในแพ็กเกจ Business |
| [Perplexity](https://www.perplexity.ai/help-center/en/articles/13915507-adding-custom-remote-connectors)         | อ่านได้ ช่วยเขียน Query | Custom Remote Connector สำหรับแพ็กเกจแบบเสียเงิน                                                |
| [Microsoft Copilot](https://learn.microsoft.com/en-us/microsoft-copilot-studio/mcp-add-existing-server-to-agent) | อ่านได้ ช่วยเขียน Query | ใช้ได้ผ่าน Agent ที่สร้างใน Copilot Studio เท่านั้น                                             |

#### AI Agent บนเครื่อง

| Client                                                                                       | llms.txt                            | MCP Server                   |
| -------------------------------------------------------------------------------------------- | ----------------------------------- | ---------------------------- |
| [Claude Code](https://docs.claude.com/en/docs/claude-code/mcp)                               | อ่านได้และรัน Query ได้             | ได้                          |
| [Codex CLI](https://developers.openai.com/codex/agent-approvals-security)                    | ต้องตั้งค่า `network_access = true` | ได้                          |
| [Gemini CLI](https://google-gemini.github.io/gemini-cli/docs/tools/mcp-server.html)          | อ่านได้และรัน Query ได้             | ได้ โดยตั้งค่าผ่าน `httpUrl` |
| [Cursor](https://cursor.com/docs/context/mcp)                                                | อ่านได้และรัน Query ได้             | ได้                          |
| [VS Code ที่ใช้ GitHub Copilot](https://code.visualstudio.com/docs/copilot/chat/mcp-servers) | อ่านได้และรัน Query ได้             | ได้                          |

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

## ข้อจำกัด

### การเข้าถึง

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

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

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

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

เพื่อป้องกัน API ให้สามารถรองรับผู้ใช้งานได้ดีที่สุด เราจำกัดการใช้งานทั้่ง GraphQL Endpoint และ 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](https://neo4j.com/docs/graphql/current/queries-aggregations/pagination/)

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

ด้านข้อมูล ทีมงานตั้งใจเปิดข้อมูลเป็น Open Data ภายใต้เงื่อนไข [Attribution-NonCommercial 4.0 International](https://creativecommons.org/licenses/by-nc/4.0/) ซึ่งหมายถึง สามารถนำข้อมูลไปใช้ ดัดแปลง ต่อยอดได้ แต่ห้ามนำไปใช้ทางการค้าหรือแสวงหาผลกำไรจากผลงาน และต้องให้เครดิตกับ WeVis

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