Native playbooks

เครื่องมือ get_playbook ส่ง workflow เหล่านี้ให้โมเดลที่เชื่อมต่อโดยตรง playbook เป็นลำดับขั้นตอน ไม่ใช่สิทธิ์ และไม่ได้ให้สิทธิ์เพิ่มแม้แต่น้อย ทุกขั้นตอนใช้เครื่องมือเท่าที่ connector ถืออยู่แล้ว ดังนั้น connector ที่อ่านได้อย่างเดียวจะทำเฉพาะขั้นตอนที่เป็นการอ่าน และหยุดตรงจุดที่ playbook จะเขียนข้อมูล

กฎสำคัญ

1. ค้นหาร้านและภูมิภาคด้วย list_shopee_shops, list_lazada_shops หรือ list_tiktok_shops ห้ามเดารหัส
2. เริ่มจาก diagnostics หรือข้อมูลสรุปขนาดเล็ก
3. เรียกเครื่องมือที่ signal แนะนำเมื่อคำถามต้องใช้รายละเอียดนั้นเท่านั้น
4. ระบุช่วงวันที่ สกุลเงินท้องถิ่น และความไม่แน่นอนจาก COGS ที่ประเมินหรือ settlement ที่ยังไม่ครบ
5. รายงานหรือจำลองก่อนเสมอ ถ้าขั้นตอนถัดไปคือการเขียนข้อมูล ให้ระบุชื่อเครื่องมือและสิ่งที่จะเปลี่ยนอย่างชัดเจน รอให้ผู้ใช้ยืนยันก่อน แล้วจึงบอกตรงๆ ว่าเปลี่ยนอะไรไปแล้ว

cite-basis

ใช้กับทุกตัวเลขที่ผู้ช่วยรายงาน เป็น playbook เดียวที่ใช้ร่วมกับทุก playbook อื่น

Workflow

1. ระบุชื่อเครื่องมือ ร้าน และช่วงวันที่ที่เครื่องมือ ส่งกลับมาจริง ไม่ใช่ช่วงที่ผู้ใช้ถาม
2. ระบุสมมติฐาน ได้แก่ มุมมอง VAT, COGS ที่กรอกจริงหรืออนุมาน และค่าที่เกิดขึ้นจริงหรืออิงวันที่สั่งซื้อ
3. ส่งต่อบล็อก [DataGlass call basis] ที่ปิดท้ายผลลัพธ์ทุกครั้ง แทนการสรุปความจนข้อมูลหาย
4. เมื่อตัวเลขไม่ตรงกับ Seller Center ให้ตรวจนิยามก่อนสงสัยว่าข้อมูลขาด GMV ใน Seller Center นับทุกออเดอร์ที่ ถูกสร้าง ส่วนภาพรวมค่าที่เกิดขึ้นจริงของ DataGlass นับเฉพาะรายการที่ settle แล้ว วันที่ใกล้ปัจจุบันจึงต่ำโดยธรรมชาติ
5. จำไว้ว่า Shopee จัดรายการที่ settle แล้วตามวันที่สั่งซื้อและจะเติมย้อนหลัง ส่วน TikTok Shop และ Lazada จัดตามวันที่ settle และจะไม่เติมย้อนหลัง

ตัวอย่างสถานการณ์

• ทำไมตัวเลขนี้ไม่ตรงกับที่เห็นใน Seller Center
• ตัวเลขนี้ใช้ช่วงวันที่ไหนและตั้งค่า VAT อย่างไร
• ตัวเลขนี้เป็นค่าที่เกิดขึ้นจริงหรืออิงวันที่สั่งซื้อ

getting-started

ใช้เมื่อเพิ่งเชื่อมต่อ DataGlass หรือยังไม่ทราบว่ามีร้านและข้อมูลใดให้ใช้งาน

Workflow

1. แสดงรายการร้านของ Marketplace ที่เกี่ยวข้อง
2. อธิบายว่าเครื่องมือระดับร้านต้องใช้รหัสร้านและภูมิภาคจากผลลัพธ์
3. ชี้แจงว่าค่าที่เกิดขึ้นจริงได้ปรับการยกเลิกแล้ว เงินเป็นสกุลท้องถิ่น และ connector จะอ่านได้อย่างเดียวจนกว่าจะอนุมัติสิทธิ์เขียน

ตัวอย่างสถานการณ์

• แสดงร้านทั้งหมดที่วิเคราะห์ได้และจัดกลุ่มตาม Marketplace
• แต่ละร้านใช้ภูมิภาคและสกุลเงินใด
• ก่อนเลือกร้าน DataGlass ช่วยวิเคราะห์อะไรได้บ้าง

shop-health-check

ใช้เมื่อต้องการประเมินร้านหนึ่งแบบรอบด้านอย่างรวดเร็ว หรือดูภาพรวมร้านทั้งหมด

Workflow

1. เรียก diagnose_shop โดยใช้ช่วงย้อนหลัง 30 วันสำหรับร้านหนึ่ง
2. สรุป headline และ signal ระดับ warning หรือ critical
3. เรียก suggestedTool ของ signal เมื่อผู้ใช้ต้องการหลักฐานเพิ่ม
4. ใช้ get_financial_overview เมื่อคำถามครอบคลุมทุกร้าน

ตัวอย่างสถานการณ์

• ตรวจสุขภาพ {shopName} ย้อนหลัง 30 วันและแจ้งความเสี่ยงเร่งด่วน
• สัปดาห์นี้เปลี่ยนจากสัปดาห์ก่อนอย่างไร
• สรุปกำไรและ margin ของร้านทั้งหมดที่เชื่อมต่อ

why-profit-dropped

ใช้ค้นหาสาเหตุของกำไรที่เกิดขึ้นจริง GMV หรือยอดขายที่ลดลง

Workflow

1. เริ่มจาก diagnose_shop แล้วอ่านการเปลี่ยนแปลง KPI และ signals[]
2. หาก GMV หรือกำไรลด ให้ดู product breakdown และอันดับกำไรของแพลตฟอร์ม
3. หาก margin ลด ให้ดูต้นทุน คอมมิชชั่น และผลกระทบจากคอมมิชชั่น
4. ตรวจ COGS ที่หายและ settlement lag ก่อนสรุปว่าการลดลงเป็นผลจริง
5. ตรวจโฆษณาเมื่อค่าใช้จ่ายเพิ่มหรือ True ROAS ลด แล้วสรุปสาเหตุหลักก่อน

ตัวอย่างสถานการณ์

• ทำไมกำไรที่เกิดขึ้นจริงจึงลดลงใน {period} จัดอันดับสาเหตุให้ด้วย
• GMV คงที่แต่ margin ลด ต้นทุนรายการใดเปลี่ยนไป
• การลดลงนี้เกิดขึ้นจริง หรือมาจาก COGS ที่หายกับออเดอร์ที่ยังไม่ settlement

improve-low-margin

ใช้ค้นหาสินค้าที่ margin ต่ำหรือขาดทุน และประเมินทางแก้

Workflow

1. อ่านภาพรวมการเงินของแพลตฟอร์ม แล้วดูจำนวนสินค้าขาดทุนกับความครอบคลุม COGS
2. จัดอันดับหรือดูรายละเอียดสินค้าที่แย่ที่สุด
3. ใช้ get_product_costs ยืนยันว่าต้นทุนเป็นค่าที่บันทึก ประเมิน หรือหาย
4. ทดสอบการเปลี่ยนราคา ส่วนลด หรือ COGS ด้วยเครื่องมือ simulation ของแพลตฟอร์ม
5. ดูคำแนะนำ price buffer หรือ margin defense เมื่อค่าธรรมเนียมเป็นสาเหตุ

ตัวอย่างสถานการณ์

• สินค้าใดขาดทุนมากที่สุดและเพราะอะไร
• หาสินค้า margin ต่ำที่กระทบกำไรรวมมากที่สุด
• เปรียบเทียบการขึ้นราคา ลดส่วนลด และลด COGS สำหรับสินค้าที่แย่ที่สุด

debug-ads

ใช้ค้นหาแคมเปญที่อ่อนแอ และดูคำแนะนำด้าน bid งบ หรือ target ROAS ที่อิงกำไร

Workflow

1. สำหรับ Shopee ให้เรียง get_shopee_ads_performance ตาม profit-adjusted ROAS จากต่ำไปสูง
2. ยืนยันแคมเปญที่น่าสงสัยด้วย corrected ROAS หรือ True ROAS ระดับสินค้า
3. ดูคำแนะนำ target ROAS งบ หรือ GMS ของ Shopee ส่วน TikTok Shop ให้ดู GMV Max, True ROAS งบ และ target ROAS
4. อธิบายคำแนะนำและหลักฐานเบื้องหลัง ถ้าได้รับสิทธิ์ PAT_ADS_WRITE แล้ว สามารถนำไปใช้ด้วย apply_shopee_target_roas หรือแก้แคมเปญที่รันอยู่ด้วย control_ad_campaign ได้ แต่ต้องแจ้งค่าปัจจุบันเทียบค่าที่เสนอและรอให้ผู้ใช้ยืนยันก่อน เพราะทั้งสองอย่างเปลี่ยนค่าโฆษณาจริงทันที revert_shopee_target_roas ใช้ย้อน target ที่นำไปใช้แล้ว หากยังไม่มีสิทธิ์ ให้ส่งตัวเลขและลิงก์ให้ผู้ใช้ไปทำเอง

ตัวอย่างสถานการณ์

• แคมเปญใดมี True ROAS ต่ำที่สุดในเดือนนี้
• หาโฆษณาที่ดูมีกำไรใน Marketplace แต่ขาดทุนหลังหักต้นทุนทั้งหมด
• ควรเพิ่ม คง หรือลดงบตรงไหน พร้อมอธิบายเหตุผล

defend-margin-commission

ใช้เมื่อการเปลี่ยนอัตราคอมมิชชั่นอาจทำให้ margin ลดลง

Workflow

1. ดูภาพรวมคอมมิชชั่นและผลกระทบของแพลตฟอร์มตามวันที่มีผล
2. อ่าน margin-defense actions ของ Shopee หรือ TikTok Shop
3. ยืนยันการปรับราคาหรือส่วนลดด้วย simulation กำไร
4. แสดงผลกระทบ การปรับที่น้อยที่สุดเพื่อรักษา margin และวันที่มีผล

ตัวอย่างสถานการณ์

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

plan-restock

ใช้ตัดสินใจว่าจะสั่งสินค้าใด จำนวนเท่าไร และเพราะเหตุใด

Workflow

1. ดู inventory alert ที่เปิดอยู่
2. อ่านแผนสั่งซื้อแบบ (s,S) ตาม variant
3. ใช้ forecast และ demand chart อธิบายจำนวนที่แนะนำ
4. ตรวจใบสั่งซื้อที่เปิดอยู่เพื่อไม่สั่งสินค้าที่กำลังเข้าซ้ำ

ตัวอย่างสถานการณ์

• SKU ใดต้องเติมสต็อกตอนนี้
• สร้างแผนสั่งซื้อที่รวม forecast ความต้องการและสต็อกที่กำลังเข้า
• สินค้าใดดูมีสต็อกมากเกินหรือหมุนช้า

check-cogs

ใช้ค้นหาสินค้าที่ตัวเลขกำไรยังพึ่งต้นทุนที่หายหรือค่าประเมิน

Workflow

1. อ่าน cogsCoverage จากภาพรวมการเงินของร้าน
2. ดูต้นทุนสินค้าและแยกค่าที่บันทึก ค่าประเมิน และค่าที่หาย
3. ใช้ get_estimated_margin เมื่อต้องดูค่าประเมินระดับร้าน Shopee
4. จัดอันดับสินค้าที่การบันทึกต้นทุนจริงจะช่วยเพิ่มความมั่นใจของกำไรมากที่สุด

ตัวอย่างสถานการณ์

• สินค้าใดยังไม่มี COGS ที่บันทึกไว้
• กำไรที่รายงานพึ่งต้นทุนประเมินมากเท่าไร
• จัดอันดับสินค้าที่ COGS หายตามผลกระทบที่อาจทำให้กำไรคลาดเคลื่อน

simulate-price-change

ใช้ทดสอบราคา ส่วนลด หรือ COGS ก่อนตัดสินใจ

Workflow

1. ค้นหาสินค้าและดู unit economics ปัจจุบัน
2. เรียก simulation เฉพาะแพลตฟอร์มหนึ่งครั้งต่อหนึ่งสถานการณ์
3. เปรียบเทียบกำไรและ margin ปัจจุบันกับค่าจำลอง พร้อมระบุสมมติฐาน
4. ระบุว่าเป็น what-if เท่านั้น ไม่มีการเขียนข้อมูล

ตัวอย่างสถานการณ์

• ถ้าขึ้นราคาสินค้านี้ 5% margin จะเปลี่ยนอย่างไร
• เปรียบเทียบส่วนลด 15% กับ 10%
• สินค้าต้องมี COGS ต่อหน่วยเท่าไรจึงจะได้ margin 20%

conventions

ใช้เมื่อคำขอไม่ผ่านเพราะรูปแบบวันที่ แพลตฟอร์ม รหัส pagination, VAT หรือเงิน

Workflow

1. ค้นหารหัสร้านและสินค้าใหม่แทนการเดา
2. ใช้วันที่ YYYY-MM-DD, conversion datadate แบบ YYYYMMDD และ timestamp แบบ ISO 8601
3. เก็บรหัส TikTok Shop ทุกชนิดเป็น string
4. ใช้ nextCursor เฉพาะเมื่อต้องดึงหน้าถัดไป
5. ระบุสกุลเงินท้องถิ่น และผลจาก COGS ที่ประเมินหรือการตั้งค่า VAT

ตัวอย่างสถานการณ์

• เดือนที่แล้วใช้วันที่ใด และเปรียบเทียบกับช่วงใด
• ค้นหารหัสร้านและสินค้าที่ถูกต้องสำหรับคำถามนี้
• อธิบายว่าทำไม payout กำไรที่เกิดขึ้นจริง และ True ROAS จึงตอบคนละคำถาม

เรียก playbook

เรียก get_playbook โดยไม่ส่ง playbook เพื่อดูรายการทั้งหมด หรือส่งชื่อที่ตรงกัน:

{
  "playbook": "why-profit-dropped"
}

ผลลัพธ์ขณะทำงานเป็นแหล่งข้อมูลหลักของ workflow ที่ผู้ช่วยเชื่อมต่อสามารถใช้ได้