# วิธีเรียก AI ในโฟลเดอร์นี้

สำหรับ agent ที่กำลังสร้างเว็บ อ่านไฟล์นี้ก่อนเขียนโค้ด

## กฎเรื่อง key
- key อยู่ในไฟล์ key.txt และที่อยู่เว็บไซต์ DTX_API_URL คือ https://dtx-buildathon.vercel.app
- key.txt มี key ของ workshop ใส่ไว้ให้แล้ว ผู้ใช้ไม่ต้องทำอะไร
- ห้ามพิมพ์ key ออกมาในแชต ห้ามเขียน key ลงในไฟล์ HTML ห้ามส่ง key ไปที่อื่นนอกจาก DTX_API_URL
- อ่าน key.txt ด้วยโค้ดเท่านั้น อย่าเปิดไฟล์ให้ข้อความขึ้นในแชต ถ้าต้องตรวจรูปแบบ ให้พิมพ์แค่ว่าใช่หรือไม่ใช่

## ภาษาไทยในไฟล์
- เขียนทุกไฟล์เป็น UTF-8 ถ้าใช้ PowerShell อย่าส่งข้อความไทยผ่านคำสั่ง ให้เขียนลงไฟล์โดยตรง
- ก่อนบอกว่าเสร็จ ตรวจว่าไม่มีภาษาไทยในหน้าเว็บที่กลายเป็นเครื่องหมาย ?

## API
ส่ง key ใน header ทุกครั้ง: `Authorization: Bearer <key>`

`POST {DTX_API_URL}/api/extract`
ส่งไฟล์ PDF หรือ Word ในช่องฟอร์มชื่อ `file` ตอบ `{ "id": "R01", "name": "...", "text": "..." }`
รับเฉพาะไฟล์ใบสมัครฝึกในโฟลเดอร์ resumes ไฟล์อื่นจะถูกปฏิเสธ

`POST {DTX_API_URL}/api/screen`
```json
{
  "resume_id": "R01",
  "model": "gpt-6.1-terra",
  "criteria": {
    "must_have": ["At least 5 years managing projects"],
    "nice_to_have": ["A current PMP, PRINCE2 or Scrum certificate"],
    "flag_for_a_person": ["At the Bangkok head office at least 3 days a week"]
  }
}
```
ตอบ
```json
{
  "resume_id": "R01",
  "name": "...",
  "recommendation": "shortlist",
  "must_have": { "met": 3, "not_met": 0, "not_stated": 0 },
  "nice_to_have_met": 2,
  "criteria": [
    { "criterion": "...", "kind": "must", "verdict": "met", "quote": "...", "quote_found": true, "where": "...", "reason": "..." }
  ],
  "summary": "...",
  "questions_to_ask": [],
  "flags_for_a_person": [],
  "usage": { "cost_usd": 0.0066 }
}
```
- `recommendation` เป็น shortlist, ask more หรือ not now เซิร์ฟเวอร์เป็นผู้ตัดสินตามกฎตายตัว
- `verdict` เป็น met, not met หรือ not stated
- `kind` เป็น must, nice หรือ flag
- `questions_to_ask` และ `flags_for_a_person` เป็นรายการข้อความ
- `reason`, `summary`, `questions_to_ask` และ `flags_for_a_person` ตอบเป็นภาษาไทย ส่วน `quote` เป็นภาษาเดียวกับใบสมัคร
- ถ้า `quote_found` เป็น false ให้แสดงคำเตือนว่า ตรวจข้อความนี้เอง
- criteria รวมทุกกลุ่มได้สูงสุด 12 ข้อ
- เรียกครั้งละหนึ่งใบ แต่ให้ทำพร้อมกัน 5 ใบเสมอ อย่ารอให้เสร็จทีละใบ เพราะแต่ละใบใช้เวลาหลายวินาที ถ้าทำทีละใบ 50 ใบจะใช้เวลาเกิน 10 นาที
- ถ้าผิดพลาดจะตอบ `{ "error": { "code": "...", "message": "..." } }` ให้แสดง message ถ้า code เป็น rate_limited ให้รอ 2 วินาทีแล้วลองใหม่ เพิ่มเวลารอเป็นเท่าตัว ลองได้ไม่เกิน 6 ครั้ง

ค่าใช้จ่ายบนหน้าเว็บ ให้บวก `usage.cost_usd` จากทุกคำตอบของ `api/screen` key นี้ใช้ร่วมกันทั้งห้อง จึงไม่ต้องแสดงงบที่เหลือ

## ให้ไฟล์ HTML ไฟล์เดียวใช้ได้ทั้งบนเครื่องและบนเว็บ
ในหน้าเว็บ เรียก API ด้วย path แบบ relative ไม่มี / นำหน้า เช่น `api/screen` และไม่ใส่ key

ลองบนเครื่องนี้: เขียน server เล็ก ๆ ด้วยเครื่องมือที่มีอยู่ในเครื่อง ให้เสิร์ฟไฟล์ HTML นั้นไฟล์เดียว อย่าเสิร์ฟทั้งโฟลเดอร์ เพราะ key.txt อยู่ในโฟลเดอร์นี้ และส่งต่อทุก path ที่ขึ้นต้นด้วย `api/` ไปที่ DTX_API_URL โดยเติม key จาก key.txt ให้เอง เปิดหน้าเว็บผ่าน server นี้

ขึ้นเว็บ: ก่อน publish ครั้งแรก ถามผู้ใช้คำถามเดียว ขอชื่อสั้น ๆ สำหรับลิงก์เป็นตัวอักษรภาษาอังกฤษ เช่นชื่อเล่น แล้ว `POST {DTX_API_URL}/api/publish` พร้อม key ใน header และ JSON `{ "html": "<ทั้งไฟล์>", "title": "Screening Studio", "name": "<ชื่อที่ได้>" }` คำตอบมี `url` ของหน้าเว็บและ `code` เก็บทั้งสองค่าไว้ในไฟล์ publish.json ข้างไฟล์ HTML

publish ครั้งต่อไป ส่ง `"code"` จาก publish.json แทน `"name"` หน้าใหม่จะแทนที่หน้าเดิมที่ลิงก์เดิม ถ้าส่ง name อีกครั้งจะได้ลิงก์ใหม่

บนเว็บนั้นเซิร์ฟเวอร์จะเติม key ให้เอง หน้าเว็บที่ publish ต้องครบในไฟล์เดียว ไม่โหลด script หรือฟอนต์จากภายนอก และเล็กกว่า 2.5 MB ใครมีลิงก์ก็กดคัดกรองได้ด้วยงบของ workshop บอกผู้ใช้เรื่องนี้ตอนส่งลิงก์
