# เอเจนต์

## เอเจนต์คืออะไร?

เอเจนต์คือผู้ช่วย AI ที่แยกตัวกันซึ่งคิดผ่านปัญหา รันงาน และสื่อสารข้ามหลายแพลตฟอร์ม เอเจนต์แต่ละตัวมี workspace ของตัวเอง ประวัติเซสชัน การกำหนดค่า model และการเชื่อมต่อช่องทาง

## การแยกตัวของเอเจนต์

เอเจนต์แต่ละตัวได้รับ:

- **Workspace**, ไดเรกทอรีเฉพาะสำหรับไฟล์ บันทึก และข้อมูลเฉพาะเอเจนต์
- **Sessions**, ประวัติการสนทนาและ transcript ที่เป็นอิสระ
- **Configuration**, การเลือก model สิทธิ์เครื่องมือ ขีดจำกัดการใช้จ่าย
- **Identity**, บุคลิกภาพเฉพาะที่กำหนดในไฟล์ `AGENTS.md` ของเอเจนต์
- **Auth Profiles**, การกำหนดค่า API key และการตรวจสอบสิทธิ์ต่อเอเจนต์

## บุคลิกภาพของเอเจนต์

workspace ของเอเจนต์แต่ละตัวมีไฟล์ `AGENTS.md` ที่กำหนดบุคลิกภาพ คำแนะนำ และแนวทางพฤติกรรม system prompt ที่คงอยู่นี้กำหนดว่าเอเจนต์ตอบสนองอย่างไร, โทน ความเชี่ยวชาญในสาขา การจัดรูปแบบ การใช้เครื่องมือ และนโยบายความปลอดภัย

## การกำหนดเส้นทางหลายเอเจนต์

เมื่อรันหลายเอเจนต์ ข้อความขาเข้าจะถูกกำหนดเส้นทางโดยอัตโนมัติตาม **binding**:

- **Channel binding**, กำหนดเส้นทางข้อความทั้งหมดจากแพลตฟอร์ม (เช่น Telegram ทั้งหมด → เอเจนต์ `personal`)
- **Server/workspace binding**, กำหนดเส้นทาง Discord server หรือ Slack workspace เฉพาะไปยังเอเจนต์เฉพาะ
- **Chat type binding**, กำหนดเส้นทางข้อความส่วนตัวไปยังเอเจนต์หนึ่งและข้อความกลุ่มไปยังอีกเอเจนต์
- **Contact/peer binding**, กำหนดเส้นทางข้อความจากผู้ติดต่อเฉพาะไปยังเอเจนต์เฉพาะ

Binding ถูกประเมินตามลำดับความสำคัญ การจับคู่แรกชนะ ข้อความที่ไม่ตรงไปยังเอเจนต์เริ่มต้น

## Sub-Agent และการมอบหมาย

เอเจนต์สามารถสร้าง sub-agent สำหรับงานเฉพาะ:

- **การมอบหมายงาน**, แบ่งงานที่ซับซ้อนและมอบหมายส่วนต่าง ๆ ให้ sub-agent เฉพาะ
- **การรันแบบแยกตัว**, Sub-agent รันในบริบทเซสชันของตัวเอง
- **การสนทนาแบบ ping-pong**, เอเจนต์สามารถมีการแลกเปลี่ยนแบบไป-กลับ (สูงสุด 5 รอบ) เพื่อทำงานร่วมกัน
- **การประกาศผล**, ผลลัพธ์ sub-agent สามารถโพสต์กลับไปยังช่องทางเดิม

## ทีมและออร์เคสเตรชัน

ทีมหลายเอเจนต์เปิดใช้งานเวิร์กโฟลว์ที่ประสานกัน:

- **การรันแบบขนาน**, รันหลายเอเจนต์พร้อมกันในด้านต่าง ๆ ของงาน
- **Pipeline ตามลำดับ**, เชื่อมต่อเอเจนต์ที่แต่ละตัวสร้างบนเอาต์พุตก่อนหน้า
- **โหมดไฮบริด**, รวมการรันแบบขนานและตามลำดับ
- **การติดตามงาน**, ตรวจสอบสถานะของงานเอเจนต์แต่ละตัว (queued, running, done, error, canceled)

## Tool Profile

ควบคุมสิ่งที่เอเจนต์แต่ละตัวสามารถทำได้:

| Profile | เครื่องมือที่มี |
|---------|----------------|
| **minimal** | สถานะเซสชันเท่านั้น |
| **coding** | File I/O, execution, sessions, memory, images |
| **messaging** | การส่งข้อความ ประวัติเซสชัน |
| **full** | เครื่องมือทั้งหมด (ค่าเริ่มต้น) |

รายการ allow/deny กำหนดเองสามารถตั้งค่าต่อเอเจนต์และต่อผู้ให้บริการ model

## Safe Mode

Safe Mode ให้แซนด์บ็อกซ์การรัน:

- **Master toggle**, เปิดหรือปิดใช้งานทั่วโลก
- **การควบคุมต่อเอเจนต์**, ปิดใช้งานสำหรับเอเจนต์ที่เชื่อถือได้ เปิดไว้สำหรับเอเจนต์อื่น ๆ
- **การอนุมัติการรัน**, การดำเนินการที่ละเอียดอ่อนต้องการการอนุมัติผู้ใช้อย่างชัดแจ้ง
- **การซิงค์นโยบาย**, การตั้งค่าซิงค์กันข้ามไคลเอนต์ที่เชื่อมต่อทั้งหมดแบบ real-time

## หน่วยความจำเอเจนต์

เอเจนต์แต่ละตัวมีสิทธิ์เข้าถึงระบบหน่วยความจำ:

- **MEMORY.md**, บันทึกถาวรและข้อมูลสำคัญข้ามเซสชัน
- **ไฟล์หน่วยความจำ**, ความรู้ที่มีโครงสร้างเพิ่มเติมใน `memory/`
- **Vector search**, ค้นหาหน่วยความจำโดยใช้คำถามภาษาธรรมชาติ

ดูที่ [Sessions & Memory](sessions-memory.md) สำหรับรายละเอียด