# Personal AI Agent Pilot Kit

เปรียบเทียบ **Grok Bot / OpenAI Your dot / Meta Muse** ด้วย workflow และเกณฑ์เดียวกัน

ชุดนี้เป็นเอกสารให้คนหรือ AI กรอก ไม่ใช่โปรแกรมที่เชื่อมแอป รัน benchmark หรือสร้าง automation ให้เอง ไม่มีผลทดสอบจริงติดมาด้วย

## ใช้ตามลำดับ

1. กรอก 01-pilot-plan.md ก่อนเริ่ม เพื่อกำหนดคำถาม ขอบเขตและเกณฑ์ตัดสิน
2. ทำสำเนา 02-product-configuration.md หนึ่งไฟล์ต่อผลิตภัณฑ์และ configuration
3. ทำสำเนา 03-task-spec.md ต่อ workflow แล้ว freeze prompt, fixture, answer key
4. ใช้ 08-prompt-pack.md เป็นจุดเริ่มต้น แล้วปรับ prompt เดียวกันให้พร้อมก่อน freeze
5. บันทึกทุก attempt ใน 04-run-log.md หรือ CSV พร้อม evidence
6. ใช้นิยามและตัวหารใน 05-metric-dictionary.md คำนวณผล
7. รวมผลทั้งสามใน 06-comparison-scorecard.md แล้วตัดสินผ่าน 07-decision-record.md
8. อ่าน 09-worked-example.md เพื่อดูการนับ denominator, timeout และต้นทุน ตัวเลขในตัวอย่างเป็นข้อมูลสมมติ

## โครงสร้างโฟลเดอร์ที่แนะนำ

```text
pilot/
  plan.md
  configurations/
  task-specs/
  fixtures/
  answer-keys/
  runs/{run-id}/
  evidence/{run-id}/
  scorecard.md
  decision.md
```

## กติกาสำคัญ

- N/A คือเข้าใช้/ความสามารถไม่พร้อมก่อนเริ่ม ไม่ใช่ 0% และไม่ใช่ pass
- ถ้ากดเริ่มแล้วเจอ tool error, quota, approval ค้าง หรือ timeout ต้องเก็บเป็น attempt ที่ไม่ผ่าน
- attempt คือหนึ่งการมอบหมายตาม task spec; internal tool retry ในรอบเดียวบันทึกในรอบนั้น การสั่งเริ่มใหม่เป็น attempt ใหม่
- ไม่ลบรอบล้มเหลว ไม่ให้ AI ให้คะแนนงานตัวเองเป็นผู้ตัดสินคนเดียว
- ใช้ sandbox, test recipient และ fixture ที่ไม่เปิดเผยข้อมูลลูกค้าจริง
- ไม่รวมเงินซื้อสินค้าเข้ากับ agent operating cost; ถ้าจะวัดต้องรายงานแยก
- ก่อนส่ง log ออกนอกทีม ปิดบัง token, cookie, รหัสผ่าน ข้อมูลส่วนบุคคลและเนื้อหาลูกค้า
- ใช้ timezone Asia/Bangkok และ timestamp แบบ ISO 8601 พร้อม offset

## CSV และ ZIP

10-run-log.csv มีเฉพาะ header ไม่มีแถวผลสมมติ ใช้กรอกเองใน spreadsheet ได้
ZIP รวม Markdown 10 ไฟล์และ CSV 1 ไฟล์ แต่ละ Markdown ดู preview ก่อน download ได้จากบทความ