สิทธิ์และความปลอดภัย

โมเดลสิทธิ์ของ MCP connector ของ DataGlass — อ่านอย่างเดียวเป็นค่าเริ่มต้น สิทธิ์เขียนแยกตามด้าน การยืนยันก่อนใช้เครื่องมือ destructive การเขียนที่ผ่านขั้นตอนของ DataGlass และสิ่งที่ยังทำไม่ได้

MCP connector ของ DataGlass เริ่มต้นด้วยการอ่านอย่างเดียว และจะอ่านได้อย่างเดียวต่อไปจนกว่าคุณจะอนุมัติสิทธิ์เขียน โดยแต่ละสิทธิ์ปลดล็อกเพียงหนึ่งด้าน ตั้งแต่วันที่ 3 สิงหาคม 2026 connector เขียนข้อมูลได้ ผู้ช่วยที่มีสิทธิ์ตรงกันจะนำ price tier draft ไปใช้ เปลี่ยนงบของ ads group เขียน COGS ยกเลิกออเดอร์ หรือจัดส่งพัสดุได้ ไม่มีสิทธิ์ใดถูกให้โดยอัตโนมัติ ทุกสิทธิ์ผ่านการอนุมัติของคุณบนหน้าจอ consent และเครื่องมือทุกตัวที่ไปถึง Marketplace จะประกาศตัวเองว่าเป็น destructive เพื่อให้ผู้ช่วยถามก่อนลงมือ

เอกสาร DataGlass รุ่นก่อนหน้าระบุว่า connector อ่านได้อย่างเดียว ข้อความนั้นถูกต้องจนถึงวันที่ 3 สิงหาคม 2026 และไม่เป็นจริงอีกต่อไป หน้านี้คือข้อกำหนดปัจจุบัน

โมเดลสิทธิ์ของ MCP DataGlass สี่ชั้น

  1. ปฏิเสธเป็นค่าเริ่มต้น connector ที่เพิ่งออกให้จะมีเพียงสิทธิ์อ่านพื้นฐาน ใช้รายงาน เปรียบเทียบ วิเคราะห์ แนะนำ และจำลองได้ แต่เปลี่ยนอะไรไม่ได้เลย
  2. สิทธิ์เขียนแยกตามด้าน ความสามารถในการเขียนมาจาก OAuth scope ที่คุณอนุมัติเท่านั้น และแต่ละสิทธิ์ครอบคลุมเพียงหนึ่งด้าน ผู้ขายจึงให้ agent ดูแลค่าโฆษณาได้โดยไม่ต้องให้แตะราคา
  3. การยืนยันก่อนใช้เครื่องมือ destructive เครื่องมือที่เขียนข้อมูลทุกตัวประกาศ readOnlyHint=false และ destructiveHint=true ซึ่งเป็นเหตุให้ Claude และ ChatGPT ถามก่อนทำงาน คำอธิบายของเครื่องมือจะบอกชัดว่าอะไรจะเปลี่ยน และถ้ามีเครื่องมือ preview หรือเครื่องมืออ่านย้อนกลับ ก็จะระบุชื่อไว้ให้เรียกก่อน
  4. เขียนผ่านขั้นตอนของ DataGlass เท่านั้น เครื่องมือเขียนทำงานผ่านขั้นตอนด้านราคา โฆษณา สินค้า และการจัดส่งของ DataGlass เอง ซึ่งเป็นขั้นตอนที่คำนวณ margin ที่จะได้และบันทึกสถานะสำหรับย้อนกลับ ส่วนการส่งค่าตรงเข้า Marketplace ไม่ได้เปิดเป็นเครื่องมือเลย

สิทธิ์เขียนเก้าด้าน

สิทธิ์ปลดล็อกอะไรตัวอย่างเครื่องมือ
PAT_PRICING_WRITEprice tier draft, การนำ target margin ไปใช้, margin defense และ price bufferapply_price_tier_draft, apply_shopee_target_margin, apply_margin_defense_action, rollback_price_tier_draft
PAT_ADS_WRITEads optimization group, งบ, target ROAS และ boostcreate_ads_group, disable_ads_group_optimization, apply_shopee_target_roas, apply_tiktok_ad_budget
PAT_CATALOG_WRITECOGS, สต็อก, ชื่อรายการสินค้า, การผูก 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พัสดุ การจัดส่ง และ AWBship_tiktok_package, batch_ship_tiktok_packages, print_shopee_airway_bills
PAT_RECOMMENDATION_WRITEการจัดการ Actions ของ DataGlassreject_recommendation, stop_recommendation, rollback_recommendation
PAT_INVENTORY_WRITEการแจ้งเตือน ใบสั่งซื้อ และการตั้งค่า stock syncacknowledge_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
แอป DataGlasshttps://app.dataglasslabs.com
หน้าจอ consent ของ connectorhttps://app.dataglasslabs.com/connect
แผนและการกู้คืนการเรียกเก็บเงินhttps://app.dataglasslabs.com/open/billing
MCP endpointhttps://prod-api.dataglasslabs.com/mcp
OAuth metadatahttps://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

  1. ค้นหาร้านที่เลือกด้วยเครื่องมือ list_*_shops ที่ตรงกัน ห้ามสร้าง shopId, sellerId หรือ region ขึ้นเอง
  2. คำถามแนว "ร้านเป็นอย่างไร" หรือ "อะไรเปลี่ยนไป" ให้เริ่มที่ diagnose_shop
  3. อ่าน signals[] และตาม suggestedTool ของ signal เมื่อคำถามต้องใช้หลักฐานนั้นเท่านั้น
  4. เทียบช่วงเวลาที่เทียบกันได้ และระบุช่วงเวลากับสกุลเงินท้องถิ่น
  5. เริ่มจากปัจจัยทางธุรกิจที่ใหญ่ที่สุด ตามด้วยข้อเท็จจริงสนับสนุนไม่เกินสามข้อและขั้นตอนต่อไป
  6. ระบุเมื่อ COGS เป็นค่าอนุมาน settlement ล่าสุดยังไม่ครบ ฟิลด์ถูกบังด้วยสิทธิ์ หรือผลลัพธ์เป็นการจำลอง
  7. ก่อนเขียนข้อมูลทุกครั้ง ให้ระบุชื่อเครื่องมือ สิ่งที่จะถูกแตะอย่างเจาะจง และค่าปัจจุบันเทียบค่าที่เสนอ แล้วรอให้ผู้ใช้ยืนยันชัดเจน
  8. หลังเขียนแล้ว ให้บอกว่าอะไรเปลี่ยนไปจริง และระบุชื่อเครื่องมือย้อนกลับถ้ามี

การใช้ถ้อยคำระหว่างผลการอ่านกับการเขียน

ใช้คำว่า 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
timestampISO 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 กลับเข้าไปในการเรียกครั้งถัดไป
  • ดึงหน้าถัดไปเฉพาะเมื่อต้องการผลครบถ้วนจริง หรือเมื่อการตัดสินใจจำเป็นต้องใช้

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 ต้องทำสิ่งต่อไปนี้

  1. รักษา query parameter ทุกตัวไว้ตลอดการลงชื่อเข้าใช้ และพาผู้ใช้กลับมาที่ URL ของ consent เดิมทุกตัวอักษร
  2. แสดงสิทธิ์อ่านพื้นฐานพร้อม สิทธิ์เขียน PAT_* ทุกตัวที่ถูกร้องขอ โดยอธิบายเป็นภาษาที่คนทั่วไปเข้าใจ เพื่อให้ผู้ใช้เห็นว่า client จะเปลี่ยนแปลงด้านใดได้บ้าง
  3. แสดง client_name ที่ผ่านการตรวจสอบเมื่อมี โดยไม่สื่อว่า DataGlass เป็นเจ้าของ client นั้น
  4. บังคับให้ผู้ใช้เลือกอนุญาตหรือปฏิเสธอย่างชัดเจน
  5. POST ฟิลด์แบบ snake case ไปที่ https://prod-api.dataglasslabs.com/api/oauth/consent
  6. ส่ง JWT ของ DataGlass ใน Authorization: Bearer ... โดย endpoint จะไม่สนใจ cookie ของ access token ที่ติดมา เพื่อป้องกัน consent CSRF
  7. ใช้ approve: true เมื่ออนุญาต และ approve: false เมื่อปฏิเสธ
  8. พาไปยัง data.redirectTo ที่ backend คืนมาเท่านั้น
  9. ล้างสถานะ consent ที่ค้างอยู่หลังพาไปหน้าถัดไปหรือหลังยกเลิก
{
  "client_id": "...",
  "redirect_uri": "...",
  "scope": "...",
  "state": "...",
  "code_challenge": "...",
  "code_challenge_method": "S256",
  "resource": "...",
  "approve": true
}

ข้อความบนหน้าจอ consent ควรบอกทั้งสองด้าน คือสิ่งที่ client อ่านได้และสิ่งที่ client เปลี่ยนได้

เชื่อมต่อ DataGlass กับ {clientName} หรือไม่ {clientName} จะอ่านข้อมูลวิเคราะห์ของร้านที่บัญชี DataGlass ของคุณเข้าถึงได้ ทั้งสินค้า ออเดอร์ กำไร โฆษณา คำแนะนำ และสต็อก และถ้าคุณอนุมัติสิทธิ์เขียนที่แสดงไว้ด้านบนด้วย ก็จะเปลี่ยนแปลงสิ่งเหล่านั้นในร้านของคุณได้

เมื่อไม่มีการขอสิทธิ์เขียนเลย ให้ระบุให้ชัดและใช้ปุ่ม อนุญาตแบบอ่านอย่างเดียว แต่เมื่อมีการขอสิทธิ์เขียนตั้งแต่หนึ่งรายการขึ้นไป ปุ่มต้องไม่อ้างว่าเป็นการอ่านอย่างเดียว

การออกแบบคำตอบ

คำตอบที่ใช้งานได้จริงเรียงลำดับดังนี้

  1. ขอบเขต ร้านและแพลตฟอร์ม ช่วงวันที่ การเปรียบเทียบ และสกุลเงิน
  2. ข้อสรุป ข้อสรุปที่สำคัญที่สุดในหนึ่งประโยค
  3. หลักฐาน ตัวชี้วัดหลักหรือปัจจัยที่จัดอันดับแล้วไม่เกินสามข้อในตอนแรก
  4. ความมั่นใจ ความครบของ COGS, settlement lag, สิทธิ์ หรือสมมติฐานของการจำลอง
  5. ขั้นตอนต่อไป คำถามต่อยอด การจำลองเพิ่ม ข้อเสนอให้เขียนข้อมูล หรือลิงก์ลึกไปยัง 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 แบบ optional
  • mcp_connector_started, mcp_connector_allowed, mcp_connector_denied และ mcp_connector_failed
  • mcp_answer_followup_selected พร้อมประเภทของคำถามต่อยอด
  • mcp_deep_link_opened พร้อมหมวดของ route โดยไม่เก็บเนื้อหาทางการเงินดิบ

ห้ามบันทึก OAuth code, ค่า PKCE, access token หรือ refresh token, ข้อมูลผู้ซื้อ, prompt ดิบที่มีรายละเอียดออเดอร์ หรือผลลัพธ์ของเครื่องมือ

การเพิ่ม prompt เข้าคลัง

  1. เลือกผลลัพธ์ทางธุรกิจหนึ่งอย่างและ prompt pack ที่ตรงกัน
  2. ยืนยันว่าความสามารถที่ต้องใช้มีอยู่จริงใน tool catalog และใน tools/list ตอน runtime
  3. เขียนอย่างน้อยสามสถานการณ์ ได้แก่ การประเมินภาพกว้าง การเจาะประเด็น และการตัดสินใจหรือขั้นตอนต่อไป เพิ่มกรณีเปรียบเทียบหรือคุณภาพข้อมูลเมื่อแตกต่างชัดเจน
  4. ระบุว่า prompt นั้นต้องใช้สิทธิ์ใด ถ้าตอบได้ด้วยการอ่านอย่างเดียวก็บอกให้ชัด ถ้าจบด้วยการเขียนข้อมูล ให้ระบุชื่อเครื่องมือและสิทธิ์
  5. ตรวจว่ารหัสทุกตัวใน prompt ค้นหาได้จริง ไม่ต้องเดา
  6. กำหนดพฤติกรรมสำหรับกรณีข้อมูลว่าง ฟิลด์ถูกบังด้วยสิทธิ์ แผนไม่รองรับ ขาดสิทธิ์ และข้อมูลยังไม่ครบ
  7. ทดสอบทุกแพลตฟอร์มที่ prompt อ้างถึง
  8. ให้ลิงก์ของผลิตภัณฑ์ชี้ไปที่ https://app.dataglasslabs.com