สิทธิ์และความปลอดภัย
MCP connector ของ DataGlass เริ่มต้นด้วยการอ่านอย่างเดียว และจะอ่านได้อย่างเดียวต่อไปจนกว่าคุณจะอนุมัติสิทธิ์เขียน โดยแต่ละสิทธิ์ปลดล็อกเพียงหนึ่งด้าน ตั้งแต่วันที่ 3 สิงหาคม 2026 connector เขียนข้อมูลได้ ผู้ช่วยที่มีสิทธิ์ตรงกันจะนำ price tier draft ไปใช้ เปลี่ยนงบของ ads group เขียน COGS ยกเลิกออเดอร์ หรือจัดส่งพัสดุได้ ไม่มีสิทธิ์ใดถูกให้โดยอัตโนมัติ ทุกสิทธิ์ผ่านการอนุมัติของคุณบนหน้าจอ consent และเครื่องมือทุกตัวที่ไปถึง Marketplace จะประกาศตัวเองว่าเป็น destructive เพื่อให้ผู้ช่วยถามก่อนลงมือ
โมเดลสิทธิ์ของ MCP DataGlass สี่ชั้น
- ปฏิเสธเป็นค่าเริ่มต้น connector ที่เพิ่งออกให้จะมีเพียงสิทธิ์อ่านพื้นฐาน ใช้รายงาน เปรียบเทียบ วิเคราะห์ แนะนำ และจำลองได้ แต่เปลี่ยนอะไรไม่ได้เลย
- สิทธิ์เขียนแยกตามด้าน ความสามารถในการเขียนมาจาก OAuth scope ที่คุณอนุมัติเท่านั้น และแต่ละสิทธิ์ครอบคลุมเพียงหนึ่งด้าน ผู้ขายจึงให้ agent ดูแลค่าโฆษณาได้โดยไม่ต้องให้แตะราคา
- การยืนยันก่อนใช้เครื่องมือ destructive เครื่องมือที่เขียนข้อมูลทุกตัวประกาศ
readOnlyHint=falseและdestructiveHint=trueซึ่งเป็นเหตุให้ Claude และ ChatGPT ถามก่อนทำงาน คำอธิบายของเครื่องมือจะบอกชัดว่าอะไรจะเปลี่ยน และถ้ามีเครื่องมือ preview หรือเครื่องมืออ่านย้อนกลับ ก็จะระบุชื่อไว้ให้เรียกก่อน - เขียนผ่านขั้นตอนของ DataGlass เท่านั้น เครื่องมือเขียนทำงานผ่านขั้นตอนด้านราคา โฆษณา สินค้า และการจัดส่งของ DataGlass เอง ซึ่งเป็นขั้นตอนที่คำนวณ margin ที่จะได้และบันทึกสถานะสำหรับย้อนกลับ ส่วนการส่งค่าตรงเข้า Marketplace ไม่ได้เปิดเป็นเครื่องมือเลย
สิทธิ์เขียนเก้าด้าน
| สิทธิ์ | ปลดล็อกอะไร | ตัวอย่างเครื่องมือ |
|---|---|---|
PAT_PRICING_WRITE | price tier draft, การนำ target margin ไปใช้, margin defense และ price buffer | apply_price_tier_draft, apply_shopee_target_margin, apply_margin_defense_action, rollback_price_tier_draft |
PAT_ADS_WRITE | ads optimization group, งบ, target ROAS และ boost | create_ads_group, disable_ads_group_optimization, apply_shopee_target_roas, apply_tiktok_ad_budget |
PAT_CATALOG_WRITE | COGS, สต็อก, ชื่อรายการสินค้า, การผูก canonical และการสร้างสินค้า | apply_shopee_cogs, apply_shopee_stock, create_canonical_product, copy_product_to_shops |
PAT_RETURNS_WRITE | การตัดสินใจเรื่องคืนสินค้าและคืนเงิน | approve_tiktok_return, reject_tiktok_return, decide_lazada_refund, confirm_shopee_return |
PAT_ORDERS_WRITE | การจัดการออเดอร์และเอกสาร | cancel_shopee_order, split_shopee_order, set_shopee_order_note |
PAT_LOGISTICS_WRITE | พัสดุ การจัดส่ง และ AWB | ship_tiktok_package, batch_ship_tiktok_packages, print_shopee_airway_bills |
PAT_RECOMMENDATION_WRITE | การจัดการ Actions ของ DataGlass | reject_recommendation, stop_recommendation, rollback_recommendation |
PAT_INVENTORY_WRITE | การแจ้งเตือน ใบสั่งซื้อ และการตั้งค่า stock sync | acknowledge_inventory_alert, log_purchase_order, set_shopee_stock_sync |
PAT_REPORTS_WRITE | การจัดทำรายงานผลการทำงานของโฆษณา | generate_ads_performance_report, publish_ads_report_workspace |
การตัดสินใจเรื่องคืนสินค้าและคืนเงินอยู่ภายใต้สิทธิ์ของตัวเอง ไม่รวมอยู่กับออเดอร์หรือการจัดส่ง เพราะเป็นการเคลื่อนย้ายเงินจริงและแพลตฟอร์มจะไม่ย้อนให้
การให้สิทธิ์เขียนไม่ได้ขยายสิทธิ์ของคุณใน DataGlass สิทธิ์ PAT_* ปลดล็อกเฉพาะประตูการเขียนของ agent เท่านั้น ส่วนสิทธิ์ระดับ organization การตรวจความเป็นเจ้าของร้าน และกฎเรื่องข้อมูลการเงินที่อ่อนไหว ยังทำงานทุกครั้งเหมือนที่ทำงานในแอป
การเขียนผ่านขั้นตอนของ DataGlass เทียบกับการส่งค่าตรงเข้า Marketplace
connector เขียนผ่าน DataGlass ไม่เคยส่งค่าตรงเข้า API ของ Marketplace เส้นแบ่งนี้คือสิ่งที่ตัดสินว่าความสามารถใดจะมีเป็นเครื่องมือได้บ้าง
ทางที่ผ่านขั้นตอนของ DataGlass เช่น price tier draft การนำ target margin ไปใช้ และการนำคำแนะนำไปใช้ จะคำนวณ margin ที่จะได้ก่อนลงมือ บันทึกสถานะ draft หรือสถานะสำหรับย้อนกลับ และไปในทางเดียวกับส่วนอื่นของระบบราคา ตัวเลขที่คุณเห็นใน DataGlass กับตัวเลขที่ผู้ซื้อเห็นจึงตรงกันหลังจากนั้น ทางเหล่านี้คือทางที่เปิดเป็นเครื่องมือ
การส่งค่าตรง เช่น updatePrice, addDiscount, updateStock และการเรียก partner API ของ voucher, Bundle Deal, flexi combo และการส่งฟรี จะยิงค่าเข้า Marketplace แล้วจบ ทำให้ DataGlass ถือราคาหนึ่งและ Marketplace ถืออีกราคาหนึ่ง handler เหล่านั้นมีไว้ให้แอปใช้เอง และตั้งใจไม่ให้ agent เข้าถึง
ผลที่ตามมาซึ่งต้องบอกกันตรงๆ คือ voucher, Bundle Deal, flexi combo และแคมเปญส่งฟรี ไม่มีทางที่ผ่านขั้นตอนของ DataGlass รองรับ ความสามารถเหล่านี้จึงไม่มีอยู่ในพื้นผิวของ agent เลย ผู้ช่วยสร้างหรือแก้ไขให้ไม่ได้ไม่ว่าจะมีสิทธิ์ใด ต้องทำในแอปหรือใน Seller Center
เครื่องมือสองตัวที่สร้างรายการสินค้าจริงบน Marketplace
เครื่องมือด้านสินค้าสองตัวเรียก API สร้างสินค้าของแพลตฟอร์มโดยตรง และทำให้เกิดรายการสินค้าที่ผู้ซื้อมองเห็นได้
create_canonical_productสร้างรายการสินค้าใหม่บนทุกร้าน Shopee, Lazada และ TikTok Shop ที่เลือก แล้วผูกเข้ากับสินค้า canonical เดียวcopy_product_to_shopsสร้างรายการสินค้าเดิมขึ้นใหม่เป็นรายการจริงบนร้านปลายทางแต่ละร้าน รวมถึงข้ามแพลตฟอร์ม
ทั้งสองตัวถูกระบุว่าเป็น destructive ด้วยเหตุผลนี้ และไม่ใช่การสร้างแถว canonical เฉยๆ ควรอ่าน payload ทั้งชุด ทั้งร้าน ชื่อ ราคา และสต็อก ก่อนอนุมัติ
สองรายการวิเคราะห์กำไรที่ถอดออกจากพื้นผิวของ agent
คิวตรวจสอบราคาตาม price tier ของ Shopee และ รายการแคมเปญที่ขาดทุนตาม profit-adjusted ROAS ถูกถอดออกจากพื้นผิวเครื่องมือโดยตั้งใจเมื่อวันที่ 3 สิงหาคม 2026 เพราะการอยู่ในรายการเหล่านั้น คือ สัญญาณทางการเงินในตัวมันเอง การอยู่ในคิวหมายถึง margin ต่ำกว่าเกณฑ์ และการอยู่ในรายการที่ขาดทุนหมายถึงกำไรจริงติดลบ ต่อให้บังค่าตัวเลขไว้ ข้อมูลนี้ก็ยังรั่วถึงสมาชิกทีมที่ไม่มีสิทธิ์ VIEW_SENSITIVE_FINANCIAL อยู่ดี และการเปิดเป็นเครื่องมือจะทำให้ไล่ดูได้ครบทุกร้านในการเรียกครั้งเดียว
ทั้งสองรายการยังใช้งานได้ตามปกติในแอป DataGlass และผ่าน REST API ภายใต้สิทธิ์ระดับหน้าเดิม มีเพียงพื้นผิวของ agent เท่านั้นที่แคบกว่า
API key จากในแอปอ่านได้อย่างเดียว ส่วน OAuth connector ได้สิทธิ์ตามที่คุณอนุมัติ
การมอบข้อมูลรับรองของ DataGlass ให้ agent มีสองทาง และทั้งสองทางต่างกัน
| ข้อมูลรับรอง | ออกให้อย่างไร | ความสามารถในการเขียน |
|---|---|---|
| API key จาก ตั้งค่า → API keys | หน้าจอในแอป ซึ่งไม่มีตัวเลือกสิทธิ์ให้เลือก | อ่านอย่างเดียวโดยโครงสร้าง key ถูกสร้างด้วยสิทธิ์อ่านพื้นฐานเท่านั้น |
| OAuth connector ใน ChatGPT หรือ Claude | หน้าจอ consent ที่ /connect | ได้สิทธิ์ PAT_* ตามที่แสดงบนหน้าจอนั้นและคุณอนุมัติเท่านั้น |
ดังนั้น token dg_pat_ ที่คุณวางไว้ในสคริปต์จะเขียนข้อมูลไม่ได้ แม้ connector ที่คุณอนุมัติใน Claude อาจเขียนได้ก็ตาม เวลามีคนบอกว่า "API อ่านได้อย่างเดียว" มักหมายถึงความต่างข้อนี้
แผน Pro ที่ต้องมีสำหรับ MCP และ API key
ทั้งการเรียกเครื่องมือ MCP และการสร้าง Personal Access Token ต้องใช้ PlanTier.PRO ผู้เรียกที่อยู่ต่ำกว่าระดับ Pro จะได้รับผลลัพธ์แบบปฏิเสธตามแผน ไม่ใช่ผลลัพธ์ของเครื่องมือ อย่าอธิบายว่าการเข้าถึง API หรือ MCP รวมอยู่ในทุกแผน
rate limit และกฎ fail closed สำหรับ key ที่เขียนได้
แต่ละ key ถูกจำกัดที่ 60 คำขอแบบ burst และ 1 คำขอต่อวินาทีแบบต่อเนื่อง โดยนับแยกรายคีย์ agent ที่ทำงานผิดปกติจึงไม่ทำให้แดชบอร์ดของคุณใช้ไม่ได้ การเรียกภายในที่เครื่องมือ MCP กระจายออกไปไม่กินโควตาเพิ่ม เพราะการเรียก /mcp ชั้นนอกใช้ไปแล้วหนึ่งครั้ง
เมื่อตัวจำกัดอัตราเองใช้งานไม่ได้ พฤติกรรมจะแยกตามความสามารถของ key key ที่อ่านอย่างเดียวจะ fail open เพราะ token ผ่านการตรวจแล้ว และเหตุขัดข้องไม่ควรทำให้การอ่านล่มทั้งหมด ส่วน key ที่เขียนได้จะ fail closed เพราะ agent ที่วนเรียกเครื่องมือเขียนโดยไม่มีตัวจำกัดจะเปลี่ยนราคาจริงและค่าโฆษณาจริง ซึ่งไม่คุ้มกับการรักษาให้การอ่านทำงานต่อไปได้
การแยกข้อมูลระหว่างผู้ใช้ในพื้นผิวของ API key
การไล่ตรวจ endpoint ทุกตัวที่ API key เข้าถึงได้ทั้งหมด 625 handler ไม่พบการอ่านหรือการเขียนข้ามผู้ใช้เลย การเรียกเครื่องมือทุกครั้งถูกส่งเป็นคำขอที่ยืนยันตัวตนด้วย token ของคุณเอง การตรวจความเป็นเจ้าของจึงทำงานเหมือนคำขอที่มาจากแอปทุกประการ
การบังข้อมูลการเงินที่อ่อนไหวยังทำงานข้ามฝั่ง agent
ค่าที่ถูกซ่อนด้วย VIEW_SENSITIVE_FINANCIAL จะไปถึงผู้ช่วยในรูป string "***" หรือเป็น null เมื่อเป็น object หรือ list ไม่ใช่ตัวเลขจริง ให้แสดงเป็นฟิลด์ที่ถูกล็อก อย่าแปลงเป็นศูนย์ อย่าถือว่าข้อมูลหาย และอย่าเรียกซ้ำเพื่อเลี่ยงสิทธิ์ ในกรณีที่ลำดับการเรียงเองก็เปิดเผยค่าที่ถูกบัง ระบบจะตัดการเรียงนั้นออกด้วย
endpoint สำหรับ production
| ใช้ทำอะไร | URL |
|---|---|
| แอป DataGlass | https://app.dataglasslabs.com |
| หน้าจอ consent ของ connector | https://app.dataglasslabs.com/connect |
| แผนและการกู้คืนการเรียกเก็บเงิน | https://app.dataglasslabs.com/open/billing |
| MCP endpoint | https://prod-api.dataglasslabs.com/mcp |
| OAuth metadata | https://prod-api.dataglasslabs.com/.well-known/... |
ผลการค้นหาสินค้าอาจมีลิงก์แบบ relative เช่น /products?canonicalId=123 ให้อ้างอิงกับ https://app.dataglasslabs.com ไม่ใช่ origin ของ API
ไม่มี OpenAPI spec ที่เปิดสาธารณะ spec ของ agent ถูกสร้างขึ้นภายในที่ /v3/api-docs/agent จากกฎการเข้าถึงจริง แต่จำกัดด้วย IP allowlist และคืน 404 ต่ออินเทอร์เน็ตสาธารณะ สำหรับผู้ช่วยที่เชื่อมต่อแล้ว tools/list ตอน runtime คือข้อกำหนดที่เครื่องอ่านได้
คำศัพท์ธุรกิจที่ใช้ในคำตอบ
| คำศัพท์ | ความหมาย |
|---|---|
| กำไรที่เกิดขึ้นจริง | กำไรจากข้อมูลการเงินของ Marketplace ที่ settle แล้วและปรับการยกเลิกแล้ว |
| True ROAS | ผลตอบแทนจากโฆษณาหลังหัก COGS ค่าธรรมเนียม การคืนสินค้า และการปรับจากการยกเลิก |
| payout | เงินที่ Marketplace โอนจริง ไม่เท่ากับกำไร |
| COGS ที่ประเมิน | ค่าที่ DataGlass อนุมานเมื่อไม่มีต้นทุนสินค้าที่กรอกจริง |
| คำแนะนำ | ข้อเสนอที่ตรวจได้ใน DataGlass และนำไปใช้ผ่านเครื่องมือได้เมื่อได้รับสิทธิ์เขียนด้านคำแนะนำ |
อย่ารับปากว่าเป็นข้อมูลสดจาก Marketplace หรือรับประกันผลลัพธ์ในอนาคต
ขั้นตอนการทำงานของผู้ช่วยกับคำถาม DataGlass
- ค้นหาร้านที่เลือกด้วยเครื่องมือ
list_*_shopsที่ตรงกัน ห้ามสร้างshopId,sellerIdหรือregionขึ้นเอง - คำถามแนว "ร้านเป็นอย่างไร" หรือ "อะไรเปลี่ยนไป" ให้เริ่มที่
diagnose_shop - อ่าน
signals[]และตามsuggestedToolของ signal เมื่อคำถามต้องใช้หลักฐานนั้นเท่านั้น - เทียบช่วงเวลาที่เทียบกันได้ และระบุช่วงเวลากับสกุลเงินท้องถิ่น
- เริ่มจากปัจจัยทางธุรกิจที่ใหญ่ที่สุด ตามด้วยข้อเท็จจริงสนับสนุนไม่เกินสามข้อและขั้นตอนต่อไป
- ระบุเมื่อ COGS เป็นค่าอนุมาน settlement ล่าสุดยังไม่ครบ ฟิลด์ถูกบังด้วยสิทธิ์ หรือผลลัพธ์เป็นการจำลอง
- ก่อนเขียนข้อมูลทุกครั้ง ให้ระบุชื่อเครื่องมือ สิ่งที่จะถูกแตะอย่างเจาะจง และค่าปัจจุบันเทียบค่าที่เสนอ แล้วรอให้ผู้ใช้ยืนยันชัดเจน
- หลังเขียนแล้ว ให้บอกว่าอะไรเปลี่ยนไปจริง และระบุชื่อเครื่องมือย้อนกลับถ้ามี
การใช้ถ้อยคำระหว่างผลการอ่านกับการเขียน
ใช้คำว่า preview, จำลอง, แนะนำ หรือ ตรวจใน DataGlass สำหรับทุกสิ่งที่ผู้ช่วยเพียงอ่านหรือคำนวณจำลอง ใช้คำว่า นำไปใช้แล้ว อัปเดตแล้ว ยกเลิกแล้ว หรือ จัดส่งแล้ว ต่อเมื่อเครื่องมือเขียนทำงานสำเร็จแล้วเท่านั้น และให้ระบุชื่อเครื่องมือที่ทำ การอ้างว่าเปลี่ยนทั้งที่ไม่ได้เปลี่ยน กับการไม่รายงานว่าเปลี่ยนไปแล้ว ร้ายแรงพอกัน
ข้อควรรู้คือคำว่าย้อนกลับแทบไม่เคยหมายถึงการ undo การย้อนราคาคือการเขียนขึ้นแพลตฟอร์มชุดใหม่เพื่อคืนราคาก่อนนำไปใช้ที่บันทึกไว้ ผู้ซื้อจะเห็นราคาเปลี่ยนอีกครั้ง และบางอย่างย้อนไม่ได้เลย เช่น ออเดอร์ Shopee ที่ยกเลิกไปแล้ว หรือการคืนสินค้า TikTok Shop ที่อนุมัติไปแล้ว
รหัสอ้างอิง
- ดูรหัสร้านและ region จาก
list_shopee_shops,list_lazada_shopsหรือlist_tiktok_shops - ใช้รหัสสินค้า canonical ต่อเมื่อ
search,list_productsหรือผลลัพธ์สินค้าอื่นคืนมาแล้วเท่านั้น - อย่าเดา Marketplace จากรูปแบบของรหัส
- รหัสร้าน แคมเปญ advertiser สินค้า และ SKU ของ TikTok Shop อาจเกินช่วงจำนวนเต็มที่ JavaScript รองรับได้อย่างปลอดภัย ให้เก็บเป็น string ตลอดทางตั้งแต่ browser ถึง MCP และกลับมา
ขณะนี้ diagnose_shop สร้าง schema จากค่า Long ใน path ของ Kotlin ให้ส่งรหัสร้าน TikTok Shop ตรงตามที่ list_tiktok_shops คืนมา ถ้า host ที่เข้มงวดรักษาค่าไว้ไม่ได้โดยไม่แปลงเป็นตัวเลข ให้ใช้เครื่องมือภาพรวมการเงินเฉพาะของ TikTok Shop แทน
วันที่และการเปรียบเทียบ
| ค่า | รูปแบบ |
|---|---|
| วันที่ปกติ | YYYY-MM-DD |
datadateFrom / datadateTo ของ conversion | จำนวนเต็ม YYYYMMDD |
| timestamp | ISO 8601 |
| การเทียบค่าเริ่มต้น | ช่วงก่อนหน้าที่ยาวเท่ากันทันที |
เครื่องมือ payout กรองตามวันที่ payout หรือ settlement ไม่ใช่วันที่สั่งซื้อ ค่าที่เกิดขึ้นจริงของวันใกล้ปัจจุบันอาจยังไม่ครบระหว่างที่ Marketplace ยัง settle ไม่เสร็จ ให้แสดงหมายเหตุเรื่อง settlement lag แทนการสรุปว่ายอดที่ลดลงล่าสุดเป็นผลจริง
เงิน VAT และ COGS
- เงินใช้สกุลท้องถิ่นของร้าน อย่ารวมสกุลเงินต่างกันโดยไม่อธิบายวิธีรวม
includeVat=falseคือมุมมอง forward VAT ตามปกติ เว้นแต่ผู้ใช้ขอเป็นอย่างอื่นincludeInferredCogs=trueจะเติม COGS ที่ขาดด้วยค่าประเมินของ DataGlass- ระบุกำกับเสมอเมื่อการจัดอันดับสินค้าที่ขาดทุนหรือการจำลองอิงต้นทุนที่อนุมาน
- การเขียน COGS เปลี่ยนทุกตัวเลขกำไรและ margin ของสินค้านั้น รวมถึงรายงานย้อนหลัง ให้ preview ก่อนเสมอ
การแบ่งหน้าและต้นทุนของการเรียก
- เริ่มจากจำนวน diagnostics หรือสรุปกลุ่มบนกับกลุ่มล่าง เมื่อข้อมูลเหล่านั้นตอบคำถามได้แล้ว
- ใช้
searchก่อนดึงรายการสินค้าทั้งหมด เมื่อผู้ใช้ให้ชื่อสินค้า SKU model SKU หรือรหัสรายการ - ผลลัพธ์แบบ cursor ให้ส่ง
nextCursorจาก response กลับเข้าไปในการเรียกครั้งถัดไป - ดึงหน้าถัดไปเฉพาะเมื่อต้องการผลครบถ้วนจริง หรือเมื่อการตัดสินใจจำเป็นต้องใช้
ข้อกำหนดของ OAuth consent
host ของ MCP เริ่ม OAuth ที่โดเมนของ API หลังตรวจสอบแล้ว DataGlass จะพา browser ไปที่ https://app.dataglasslabs.com/connect พร้อม client_id, client_name แบบ optional, redirect_uri, scope, state แบบ optional, code_challenge, code_challenge_method=S256 และ resource แบบ optional
หน้าจอ consent ต้องทำสิ่งต่อไปนี้
- รักษา query parameter ทุกตัวไว้ตลอดการลงชื่อเข้าใช้ และพาผู้ใช้กลับมาที่ URL ของ consent เดิมทุกตัวอักษร
- แสดงสิทธิ์อ่านพื้นฐานพร้อม สิทธิ์เขียน
PAT_*ทุกตัวที่ถูกร้องขอ โดยอธิบายเป็นภาษาที่คนทั่วไปเข้าใจ เพื่อให้ผู้ใช้เห็นว่า client จะเปลี่ยนแปลงด้านใดได้บ้าง - แสดง
client_nameที่ผ่านการตรวจสอบเมื่อมี โดยไม่สื่อว่า DataGlass เป็นเจ้าของ client นั้น - บังคับให้ผู้ใช้เลือกอนุญาตหรือปฏิเสธอย่างชัดเจน
- POST ฟิลด์แบบ snake case ไปที่
https://prod-api.dataglasslabs.com/api/oauth/consent - ส่ง JWT ของ DataGlass ใน
Authorization: Bearer ...โดย endpoint จะไม่สนใจ cookie ของ access token ที่ติดมา เพื่อป้องกัน consent CSRF - ใช้
approve: trueเมื่ออนุญาต และapprove: falseเมื่อปฏิเสธ - พาไปยัง
data.redirectToที่ backend คืนมาเท่านั้น - ล้างสถานะ consent ที่ค้างอยู่หลังพาไปหน้าถัดไปหรือหลังยกเลิก
{
"client_id": "...",
"redirect_uri": "...",
"scope": "...",
"state": "...",
"code_challenge": "...",
"code_challenge_method": "S256",
"resource": "...",
"approve": true
}
ข้อความบนหน้าจอ consent ควรบอกทั้งสองด้าน คือสิ่งที่ client อ่านได้และสิ่งที่ client เปลี่ยนได้
เชื่อมต่อ DataGlass กับ
{clientName}หรือไม่{clientName}จะอ่านข้อมูลวิเคราะห์ของร้านที่บัญชี DataGlass ของคุณเข้าถึงได้ ทั้งสินค้า ออเดอร์ กำไร โฆษณา คำแนะนำ และสต็อก และถ้าคุณอนุมัติสิทธิ์เขียนที่แสดงไว้ด้านบนด้วย ก็จะเปลี่ยนแปลงสิ่งเหล่านั้นในร้านของคุณได้
เมื่อไม่มีการขอสิทธิ์เขียนเลย ให้ระบุให้ชัดและใช้ปุ่ม อนุญาตแบบอ่านอย่างเดียว แต่เมื่อมีการขอสิทธิ์เขียนตั้งแต่หนึ่งรายการขึ้นไป ปุ่มต้องไม่อ้างว่าเป็นการอ่านอย่างเดียว
การออกแบบคำตอบ
คำตอบที่ใช้งานได้จริงเรียงลำดับดังนี้
- ขอบเขต ร้านและแพลตฟอร์ม ช่วงวันที่ การเปรียบเทียบ และสกุลเงิน
- ข้อสรุป ข้อสรุปที่สำคัญที่สุดในหนึ่งประโยค
- หลักฐาน ตัวชี้วัดหลักหรือปัจจัยที่จัดอันดับแล้วไม่เกินสามข้อในตอนแรก
- ความมั่นใจ ความครบของ COGS, settlement lag, สิทธิ์ หรือสมมติฐานของการจำลอง
- ขั้นตอนต่อไป คำถามต่อยอด การจำลองเพิ่ม ข้อเสนอให้เขียนข้อมูล หรือลิงก์ลึกไปยัง DataGlass
| ผลลัพธ์ | รูปแบบที่แนะนำ |
|---|---|
| รายการร้าน | แถวที่เลือกได้ จัดกลุ่มตาม Marketplace |
| diagnostics | ข้อสรุปพร้อมการ์ด signal ที่ติดระดับความรุนแรง |
| การเทียบช่วงเวลา | ค่า KPI พร้อมส่วนต่างแบบสัมบูรณ์และเปอร์เซ็นต์ |
| การจัดอันดับสินค้าหรือแคมเปญ | ตารางที่เรียงได้ เน้นตัวที่ดีที่สุดและแย่ที่สุด |
| รายละเอียดกำไรขาดทุน | waterfall หรือรายการต้นทุนแบบซ้อน |
| การจำลอง | ค่าปัจจุบันวางคู่กับสถานการณ์ที่เสนอ |
| แผนสั่งซื้อ | ตาราง SKU พร้อมความเร่งด่วนและสต็อกที่กำลังเข้า |
| คำแนะนำ | การ์ดพร้อมเหตุผล ลิงก์สำหรับตรวจ และเครื่องมือนำไปใช้เมื่อสิทธิ์เอื้อ |
| ข้อเสนอให้เขียนข้อมูล | ค่าปัจจุบันเทียบค่าที่เสนอ สิ่งที่จะถูกแตะอย่างเจาะจง และวิธีย้อนกลับ |
| การเขียนที่ทำไปแล้ว | อะไรเปลี่ยนไป เครื่องมือใดเป็นคนเปลี่ยน และย้อนกลับอย่างไร |
"***" หรือ null ที่อ่อนไหว | ฟิลด์ที่ถูกล็อกพร้อมคำอธิบายเรื่องสิทธิ์ |
| ข้อผิดพลาดของเครื่องมือ | สถานะที่บอกวิธีแก้ในหน้านั้น ไม่ใช่สถานะไม่มีข้อมูล |
การกู้คืนจากข้อผิดพลาด
| เงื่อนไข | สิ่งที่ผู้ใช้ควรเห็น |
|---|---|
| 401 หรือ token ถูกเพิกถอน | "เชื่อมต่อ DataGlass ใหม่เพื่อใช้งานต่อ" แล้วเริ่ม OAuth ใหม่ |
| 403 ตอนอ่าน | "บัญชีนี้เข้าถึงร้านหรือทรัพยากรนั้นไม่ได้" อย่าเริ่ม OAuth ใหม่อัตโนมัติ |
| 403 ตอนใช้เครื่องมือเขียน | connector ไม่มีสิทธิ์เขียนของด้านนั้น ให้ระบุชื่อสิทธิ์ที่ขาดและเสนอให้เชื่อมต่อใหม่พร้อมสิทธิ์นั้น หรือชี้ไปที่แอป |
| แผนไม่รองรับ | อธิบายว่า MCP ต้องใช้แผน Pro และลิงก์ไปที่ การเรียกเก็บเงิน |
| ทดลองใช้ใกล้หมด | แสดงข้อความเตือนจากเซิร์ฟเวอร์หนึ่งครั้งแบบไม่ขวางการใช้งาน |
| ทดลองใช้หรือการสมัครสมาชิกสิ้นสุด | แสดงข้อความจากเซิร์ฟเวอร์พร้อมลิงก์กู้คืนการเรียกเก็บเงิน |
| 429 | ทำตาม Retry-After และบอกผู้ใช้ว่าเรียกใหม่ได้เมื่อใด key ที่เขียนได้อาจเจอ 429 ระหว่างที่ตัวจำกัดอัตราขัดข้องด้วย ซึ่งเป็นไปตามการออกแบบ |
| รายการว่าง | ตรวจร้าน region วันที่ สิทธิ์ และช่วงเวลาของข้อมูล ก่อนสรุปว่าไม่มีความเคลื่อนไหว |
| รหัส TikTok Shop ไม่ถูกต้อง | ค้นใหม่ด้วย list_tiktok_shops และเก็บรหัสเป็น string |
| COGS หาย | แสดงต้นทุนที่ประเมินหรือระบุว่าไม่มี แทนการแสดงศูนย์ |
| การเขียนสำเร็จบางส่วน | บางเครื่องมือคืน failures รายเป้าหมายแทนการโยน error ให้รายงานส่วนที่สำเร็จและส่วนที่ล้มเหลวแยกกัน |
การเก็บข้อมูลการใช้ prompt และ connector
เก็บรหัส prompt pack ที่คงที่แทนข้อความ prompt ดิบ เหตุการณ์ที่มีประโยชน์ได้แก่
mcp_prompt_impressionและmcp_prompt_selectedพร้อมprompt_pack,scenario,surfaceและplatformแบบ optionalmcp_connector_started,mcp_connector_allowed,mcp_connector_deniedและmcp_connector_failedmcp_answer_followup_selectedพร้อมประเภทของคำถามต่อยอดmcp_deep_link_openedพร้อมหมวดของ route โดยไม่เก็บเนื้อหาทางการเงินดิบ
ห้ามบันทึก OAuth code, ค่า PKCE, access token หรือ refresh token, ข้อมูลผู้ซื้อ, prompt ดิบที่มีรายละเอียดออเดอร์ หรือผลลัพธ์ของเครื่องมือ
การเพิ่ม prompt เข้าคลัง
- เลือกผลลัพธ์ทางธุรกิจหนึ่งอย่างและ prompt pack ที่ตรงกัน
- ยืนยันว่าความสามารถที่ต้องใช้มีอยู่จริงใน tool catalog และใน
tools/listตอน runtime - เขียนอย่างน้อยสามสถานการณ์ ได้แก่ การประเมินภาพกว้าง การเจาะประเด็น และการตัดสินใจหรือขั้นตอนต่อไป เพิ่มกรณีเปรียบเทียบหรือคุณภาพข้อมูลเมื่อแตกต่างชัดเจน
- ระบุว่า prompt นั้นต้องใช้สิทธิ์ใด ถ้าตอบได้ด้วยการอ่านอย่างเดียวก็บอกให้ชัด ถ้าจบด้วยการเขียนข้อมูล ให้ระบุชื่อเครื่องมือและสิทธิ์
- ตรวจว่ารหัสทุกตัวใน prompt ค้นหาได้จริง ไม่ต้องเดา
- กำหนดพฤติกรรมสำหรับกรณีข้อมูลว่าง ฟิลด์ถูกบังด้วยสิทธิ์ แผนไม่รองรับ ขาดสิทธิ์ และข้อมูลยังไม่ครบ
- ทดสอบทุกแพลตฟอร์มที่ prompt อ้างถึง
- ให้ลิงก์ของผลิตภัณฑ์ชี้ไปที่
https://app.dataglasslabs.com