API และ AI เอเจนต์ · API and AI agents

เมื่อสมัคร Premium แล้ว AI เอเจนต์อย่าง Claude และ ChatGPT รวมถึงโปรแกรมของคุณเอง จะทำงานกับข้อมูลบัญชีของคุณผ่าน Panya API ได้ เช่น ถามเอเจนต์ว่า "ลูกค้าค้างชำระเราเท่าไร" ให้เอเจนต์บันทึกบิลผู้จำหน่ายกองโตเป็นร่าง หรือให้โปรแกรมบันทึกยอดขายออนไลน์ทุกวัน

โปรแกรมเชื่อมต่อด้วย คีย์ API ซึ่งทำงานในนามของสมาชิกผู้สร้างคีย์ เห็นเฉพาะกิจการที่สมาชิกคนนั้นเห็น และทำได้เท่าที่บทบาทของเขาอนุญาตเท่านั้น การตรวจสอบทุกอย่างที่ใช้ในแอปก็ใช้กับคีย์ด้วย ได้แก่ สิทธิ์ งวดที่ปิดแล้ว กฎการผ่านรายการ และประวัติการใช้งาน

บทนี้อธิบายเรื่องต่อไปนี้

• Premium และการสมัคร
• การสร้าง ใช้ และเพิกถอนคีย์ API
• การเชื่อมต่อ AI เอเจนต์ด้วย Panya skill
• สิ่งที่คีย์เข้าถึงได้และเข้าถึงไม่ได้
• ข้อความที่อาจพบ

Premium#

Premium · ที่ ตั้งค่าองค์กร → แพ็กเกจ และ API และ AI เอเจนต์

Premium ราคา ฿199 ต่อเดือน สำหรับทั้งองค์กร ไม่ว่าจะมีกี่กิจการหรือสมาชิกกี่คน ประกอบด้วย

• Panya API สำหรับทุกกิจการในองค์กร
• คีย์ API สำหรับสมาชิกทุกคน แบบอ่านอย่างเดียวหรือแก้ไขได้
• Panya skill ที่สอน AI เอเจนต์ให้ใช้ Panya

ข้อมูลบัญชี แอป การส่งออกข้อมูล และ Panya AI ไม่ต้องใช้ Premium การใช้ Panya AI ผ่าน API ใช้เครดิต AI เช่นเดียวกับในแอป ดูเพิ่มเติมที่ ผู้ดูแลองค์กร

เฉพาะเจ้าขององค์กรเป็นผู้สมัคร

1. เปิด ตั้งค่าองค์กร → API และ AI เอเจนต์ (หรือการ์ด Premium ในหน้า แพ็กเกจ)
2. คลิก สมัคร · ฿199/เดือน
3. เลือกวิธีชำระเงิน
   • ชำระด้วยบัตร จะเปิดหน้าชำระเงินของ Stripe และ Stripe จะตัดเงินทุกเดือน
   • ชำระผ่านพร้อมเพย์ Stripe จะส่งใบแจ้งหนี้พร้อม QR พร้อมเพย์ทางอีเมล ครบกำหนดภายใน 7 วัน
4. เมื่อ Stripe ยืนยันการชำระเงิน การ์ดจะแสดง ใช้งานอยู่ และวันต่ออายุ Premium

ยกเลิก Premium ได้ที่ จัดการการชำระเงิน ในแท็บ แพ็กเกจ โดยยังใช้ได้จนครบเดือนที่ชำระแล้ว หากชำระเงินไม่สำเร็จ การ์ดจะแจ้งเตือน และคีย์ API ยังใช้ได้อีก 7 วัน หลังจากนั้นจะหยุดทำงานจนกว่าจะชำระค่า Premium โดยไม่มีคีย์ใดถูกลบ

คีย์ API#

API keys · ตั้งค่าองค์กร → API และ AI เอเจนต์

การ์ด คีย์ API แสดงคีย์ของคุณ

สมาชิกเห็นคีย์ของตนเอง ส่วนเจ้าของและผู้ดูแลเห็นคีย์ของทุกคนและเพิกถอนได้

สร้างคีย์#

1. คลิก สร้างคีย์ API… ปุ่มนี้ใช้ได้เมื่อองค์กรมี Premium แล้ว
2. กรอก ชื่อ ที่บอกว่าจะใช้คีย์ที่ไหน เช่น Claude บนโน้ตบุ๊ก
3. เลือก สิทธิ์
   • อ่านอย่างเดียว: รายงาน เอกสาร รายการต่าง ๆ เป็นค่าเริ่มต้น และเพียงพอสำหรับการถามคำถามและดูรายงาน
   • อ่านและแก้ไข: สร้างและผ่านรายการเอกสารได้ด้วย หน้าต่างจะเตือนว่าเอเจนต์จะสร้าง ผ่านรายการ และยกเลิกเอกสารในนามของคุณได้
4. เลือก หมดอายุหลังจาก 30 วัน 90 วัน 1 ปี หรือ ไม่หมดอายุ
5. คลิก สร้างคีย์

ระบบจะแสดงคีย์เพียง ครั้งเดียว เช่น panya_sk_3f9a1c… ตามด้วยตัวอักษรและตัวเลข 64 ตัว คลิก คัดลอก แล้วเก็บรักษาไว้อย่างปลอดภัยเหมือนรหัสผ่าน Panya เก็บไว้เพียงลายนิ้วมือของคีย์ คุณและทีมสนับสนุน Panya จึงดูคีย์นี้อีกไม่ได้ หากทำหายให้เพิกถอนแล้วสร้างใหม่

สมาชิกแต่ละคนมีคีย์ได้สูงสุด 20 คีย์ต่อองค์กร

คีย์ทำอะไรได้บ้าง#

คีย์ทำได้เท่าที่ คุณ ทำได้ ไม่มากกว่านั้น

• เข้าถึงกิจการที่คุณเปิดได้ ด้วยบทบาทของคุณในแต่ละกิจการ (ดู บทบาทและสิทธิ์)
• คีย์อ่านอย่างเดียวอ่านได้อย่างเดียว แม้บทบาทของคุณจะผ่านรายการได้
• คีย์ของผู้ใช้งานบทบาทผู้ดูข้อมูลผ่านรายการไม่ได้ แม้จะเป็นคีย์แบบแก้ไขได้
• ข้อมูลเงินเดือนและงานบุคคลต้องมีสิทธิ์เหมือนบนหน้าจอ

สิ่งที่คีย์ทำจะบันทึกในประวัติการใช้งานภายใต้ชื่อของคุณ พร้อมป้าย คีย์ API (ดู ผู้ดูแลองค์กร)

คีย์เข้าถึงได้เฉพาะข้อมูลบัญชี การเข้าสู่ระบบ สมาชิกและคำเชิญ แพ็กเกจและการชำระเงิน คีย์ API อื่น การส่งออกข้อมูล และสิทธิ์ทีมสนับสนุน ยังต้องทำในแอป Panya

เพิกถอนคีย์#

คลิก เพิกถอน ในแถวของคีย์ แล้วยืนยัน ทุกโปรแกรมที่ใช้คีย์นี้จะหยุดทำงานทันที คีย์ที่เพิกถอนแล้วยังแสดงเป็นสีจางในรายการอีก 30 วัน

คีย์จะหยุดทำงานด้วยเมื่อ

• หมดอายุ
• สมาชิกเจ้าของคีย์ถูกนำออกจากองค์กร (คีย์ของเขาในองค์กรนั้นจะถูกเพิกถอน แม้จะถูกเพิ่มกลับมาภายหลัง)
• บัญชี Panya ของสมาชิกเจ้าของคีย์ถูกระงับ
• Premium ขององค์กรสิ้นสุด (คีย์จะกลับมาใช้ได้เมื่อชำระค่า Premium)

เชื่อมต่อ AI เอเจนต์#

การ์ด เชื่อมต่อ AI เอเจนต์ มีสามขั้นตอน

1. ดาวน์โหลด skill.md skill นี้สอนเอเจนต์ให้ใช้ Panya
   • ต้องค้นหาข้อมูลอะไรก่อน
   • ให้บันทึกเอกสารเป็นร่างและถามคุณก่อนผ่านรายการ
   • รูปแบบของจำนวนเงินและวันที่
   • งานที่ทำบ่อย ได้แก่ การขาย การรับชำระ ค่าใช้จ่าย การจ่ายผู้จำหน่ายพร้อมภาษีหัก ณ ที่จ่าย สมุดรายวัน และรายงาน

สำหรับ Claude Code ให้บันทึกไฟล์เป็น ~/.claude/skills/panya/SKILL.md สำหรับเอเจนต์อื่นให้ใส่ไว้ในคำสั่งหรือคลังความรู้ของเอเจนต์

2. ตั้งคีย์ของคุณเป็นตัวแปรสภาพแวดล้อม PANYA_API_KEY และที่อยู่เซิร์ฟเวอร์เป็น PANYA_BASE_URL (https://panyaplus.com สำหรับ Panya Cloud)
3. ทดสอบคีย์ด้วยคำสั่งบนการ์ด

`` curl -H "Authorization: Bearer $PANYA_API_KEY" $PANYA_BASE_URL/api/key ``

ระบบจะตอบชื่อของคุณ องค์กร และกิจการที่คีย์เข้าถึงได้

ดาวน์โหลด skill ได้ที่ https://panyaplus.com/skill.md ด้วย

ข้อแนะนำในการใช้เอเจนต์

• เริ่มด้วยคีย์ อ่านอย่างเดียว และสร้างคีย์แบบแก้ไขได้เฉพาะงานที่จำเป็น
• ให้เอเจนต์ บันทึกเป็นร่าง และแสดงให้คุณดู คุณผ่านรายการเองบนหน้าจอ หรือบอกให้เอเจนต์ผ่านรายการก็ได้
• ตรวจสอบสิ่งที่เอเจนต์ทำในรายการเอกสารและประวัติการใช้งาน

สำหรับนักพัฒนา#

API นี้เป็นตัวเดียวกับที่แอป Panya ใช้ เป็น JSON ผ่าน HTTPS ภายใต้ /api/companies/{company_id}/…

• ส่งคีย์ใน Authorization: Bearer panya_sk_…
• จำนวนเงินส่งและรับเป็นข้อความ ("642.00") และวันที่เป็น YYYY-MM-DD แบบคริสต์ศักราช
• การสร้างเอกสารรับ header Idempotency-Key เพื่อไม่ให้การส่งซ้ำสร้างเอกสารใบที่สอง

แต่ละคีย์เรียกใช้ได้สูงสุด 300 ครั้งต่อนาที ไฟล์ skill ใช้เป็นเอกสารอ้างอิง API ได้ด้วย ในไฟล์มีรายการ endpoint รูปแบบคำขอของเอกสารที่ใช้บ่อย และรหัสข้อผิดพลาด

ข้อความ#