การแก้ไขปัญหา

สิ่งแรกที่ควรทำคือบอก coding agent ของคุณว่าคุณคาดหวังอะไรและเกิดอะไรขึ้น เมื่อเชื่อมต่อ Stardeck MCP server แล้ว agent จะอ่านข้อผิดพลาดและ log ของการ deploy ได้เอง ในเบราว์เซอร์ ให้คลิก Fix with Agent ที่ deployment ที่ล้มเหลว เพื่อส่งข้อผิดพลาดให้ Starcat Developer

การรันแอปบนเครื่องคัดลอกลิงก์หัวข้อ

CLI แสดง Not logged inคัดลอกลิงก์หัวข้อ

รัน npx @stardeckai/cli login หรือตั้ง STARDECK_API_KEY ใน CI

CLI เลือกโปรเจกต์ไม่ได้คัดลอกลิงก์หัวข้อ

• Cannot select a project interactively: รัน npx @stardeckai/cli link --project <app> หนึ่งครั้ง หรือ ส่ง --project ดู Link an app to its project
• stardeck.project.json is not usable: แก้ไฟล์ รัน npx @stardeckai/cli@latest รัน link ใหม่ หรือส่ง --project

env pull ได้ 403 หรือ 404คัดลอกลิงก์หัวข้อ

• 403: คุณต้องมีบทบาท Admin ในองค์กรของแอป หรือใช้ API key ระดับ Admin
• 404: ไม่มีโปรเจกต์หรือ branch นั้น หรือคุณไม่มีสิทธิ์เข้าถึง

แอปบนเครื่องเชื่อมต่อบริการไม่ได้คัดลอกลิงก์หัวข้อ

รัน env pull ใหม่ แล้วรีสตาร์ต npm run dev

ไม่มี STARDECK_AI_API_KEYคัดลอกลิงก์หัวข้อ

เปิด AI Proxy ดึง environment ใหม่ แล้วรีสตาร์ต อย่าเพิ่ม provider key ของคุณเอง

รายละเอียด: รันแอปของคุณบนเครื่อง

การเชื่อมต่อ agentคัดลอกลิงก์หัวข้อ

agent มองไม่เห็นเครื่องมือของ Stardeckคัดลอกลิงก์หัวข้อ

• รัน /mcp (หรือ claude mcp list) เลือกเซิร์ฟเวอร์ที่ตั้งชื่อตามองค์กรของคุณ (stardeck-<organization> หรือ stardeck หากคุณเพิ่มเอง) แล้วเข้าสู่ระบบในเบราว์เซอร์ให้เสร็จ จากนั้นรีสตาร์ต agent
• ข้อความ "This connector has no tools available" หมายความว่าบทบาทของการเชื่อมต่อนี้ไม่มีสิทธิ์ด้าน agent ที่หน้า Agents ให้เปลี่ยนไปใช้บทบาทที่มีสิทธิ์ agent:*

เครื่องมือที่คาดว่าจะมีหายไปคัดลอกลิงก์หัวข้อ

เครื่องมือส่วนใหญ่อยู่ใน catalog ไม่ได้อยู่ในรายการเครื่องมือ ให้บอก agent ให้ค้นหา (search_stardeck_tools) หากไม่พบ แสดงว่าบทบาทหรือระดับการเข้าถึงไม่อนุญาต ดู เครื่องมือถูกเปิดเผยอย่างไร

เข้าสู่ระบบแล้วเกิดข้อผิดพลาด หรือการเรียกแจ้งว่า Unauthorizedคัดลอกลิงก์หัวข้อ

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

agent แจ้งว่าไม่พบแอปคัดลอกลิงก์หัวข้อ

แอปอยู่ในองค์กรอื่น หรือ slug ไม่ถูกต้อง ให้บอก agent ให้แสดงรายการแอปขององค์กรคุณ

เครื่องมือแจ้ง "Access denied" หรือเขียนลง data store ไม่ได้คัดลอกลิงก์หัวข้อ

การตรวจสิทธิ์ราย object ไม่ผ่าน เช่น data store ที่บทบาทไม่ได้รับสิทธิ์ หรือโฟลเดอร์ knowledge ที่อ่านไม่ได้ ตรวจการตั้งค่า Access ของ store หรือสิทธิ์ของโฟลเดอร์ การเขียน data store ยังต้องใช้การเชื่อมต่อแบบ Write หรือ Admin และบทบาทที่มี agent:data-store:write

การเชื่อมต่อหายไปหลังรีสตาร์ตคัดลอกลิงก์หัวข้อ

ตรวจ URL ของเซิร์ฟเวอร์ และตรวจว่า token ไม่ถูกเพิกถอนที่หน้า Agents แล้วรันคำสั่งตั้งค่าของ client ใหม่

รายละเอียด: เชื่อมต่อ agent ของคุณ

ระหว่างที่คุณสร้างแอปคัดลอกลิงก์หัวข้อ

preview ไม่แสดงการเปลี่ยนแปลงล่าสุดคัดลอกลิงก์หัวข้อ

รอให้ sandbox preview build ใหม่ แล้วรีเฟรช หากยังไม่เปลี่ยน ให้บอก agent ให้รีสตาร์ต preview หรือใช้ Restart Dev Server ในแผง log

cloud sandbox ไม่มี commit ที่คุณ pushคัดลอกลิงก์หัวข้อ

การ push ไม่อัปเดต cloud sandbox เปิด Git History ที่หน้า branch ของแอป แล้วคลิก Load into Sandbox ที่ commit นั้น ดู การทำงานร่วมกับ Stardeck agent

แอปแจ้งว่าไม่มี key, token หรือการตั้งค่าคัดลอกลิงก์หัวข้อ

ตั้ง environment variable สำหรับ environment ที่คุณกำลังทดสอบ secret ของ production จะไม่ถูกคัดลอกไปที่ sandbox และกลับกันก็เช่นกัน ดู Environments

ข้อมูลทดสอบไปปรากฏในแอปที่ใช้งานจริงคัดลอกลิงก์หัวข้อ

sandbox และ production ของแอปใหม่ใช้ฐานข้อมูลเดียวกัน ดังนั้นสิ่งที่คุณสร้างระหว่างทดสอบจะอยู่ในแอปจริงด้วย ให้ sandbox มี branch ของตัวเอง ดู ให้ sandbox มีข้อมูลของตัวเอง

ข้อมูลดูผิด ว่าง หรือไม่เป็นปัจจุบันคัดลอกลิงก์หัวข้อ

ตรวจว่า environment ที่คุณดูอยู่ใช้ branch ใดของ data store ถาม agent (getProjectDataStoreEnvironments) หรือเปิดแผง Branch routing ที่ Settings → Data Stores ตารางหรือคอลัมน์ที่เพิ่มบน branch หนึ่งจะไม่ไปอยู่บน branch อื่นจนกว่าคุณจะ deploy ไปที่นั่น

agent ไปผิดทางคัดลอกลิงก์หัวข้อ

บอกให้มันย้อนกลับ หรือใช้ conversation forking เพื่อเริ่มใหม่จากจุดก่อนหน้า

การ merge feature branch แจ้งว่า main agent ไม่ว่างคัดลอกลิงก์หัวข้อ

รอให้งานนั้นจบแล้วลองใหม่ การ merge ไม่ได้เข้าคิว Feature branches แยกโค้ด แชต และ runtime ของ sandbox ออกจากกัน แต่ไม่ได้แยกข้อมูลของ sandbox ที่ใช้ร่วมกัน feature branch สร้าง preview deployment ที่แชร์ได้ แต่การเผยแพร่ขึ้น production ทำได้จาก default branch เท่านั้น จึงต้อง merge และตรวจสอบที่นั่นก่อน

deploy ล้มเหลวคัดลอกลิงก์หัวข้อ

deploy ที่ล้มเหลวไม่ทำให้แอปล่ม deploy ก่อนหน้าจะยังให้บริการต่อไปจนกว่า deploy ใหม่จะสำเร็จ

การ์ด deployment แสดงสรุปด้วยภาษาที่อ่านง่าย คลิกเพื่อดูข้อผิดพลาดสำคัญและ Suggested fix ด้านล่างมีปุ่มหนึ่งปุ่ม:

• Review & Redeploy เมื่อความล้มเหลวดูเป็นแบบชั่วคราว เช่น เครือข่ายสะดุดหรือดาวน์โหลดหมดเวลา
• Fix with Agent ในกรณีอื่น ปุ่มนี้ส่งข้อผิดพลาดและบริบทของ deployment ให้ Starcat Developer

สาเหตุที่พบบ่อย:

• ข้อผิดพลาดตอน build หรือ type พบบ่อยที่สุด Fix with Agent จะได้บรรทัดข้อผิดพลาดที่ตรงจุด
• ไม่มี schema ใน production ตารางหรือคอลัมน์ที่เพิ่มบน branch ของ sandbox ไม่เคยไปถึง production (หรือ branch ของ preview) ตรวจว่าแต่ละ environment ใช้ branch ใด ดู Environments
• การเปลี่ยน schema ที่ทำลายข้อมูล การเผยแพร่จะหยุดรอให้คุณยืนยันการลบตารางหรือคอลัมน์ใน production ส่วน preview deployment จะไม่ถาม

log ดิบอยู่ในรายละเอียดของ deployment ที่ล้มเหลว

อ่าน deploy ที่ล้มเหลวจาก agent ของคุณเองคัดลอกลิงก์หัวข้อ

• get_project_deployment_status แสดง deploy ล่าสุดและ deploy ที่กำลังให้บริการอยู่จริง สองอย่างนี้ต่างกัน เมื่อ deploy ใหม่สุดล้มเหลวหรือยังรันอยู่ deploy ที่ล้มเหลวจะมีข้อผิดพลาดที่บันทึกไว้และ สรุปความล้มเหลวที่ AI เขียน ซึ่งอาจผิดได้
• get_project_deployment_logs อ่าน build log และ deploy log ของ deploy
• list_project_deployment_revisions แสดงรายการ deploy ที่ผ่านมาพร้อม commit เพื่อดูว่า commit ใดที่ deploy ผ่านล่าสุด

แก้สาเหตุบน branch แล้ว deploy ใหม่ ดู ดูแลแอปของคุณ สำหรับ สิทธิ์ที่เครื่องมือเหล่านี้ต้องใช้

Surface หรือ Module หายไปคัดลอกลิงก์หัวข้อ

Surface หายไปหรือยังไม่ขึ้นใช้งานคัดลอกลิงก์หัวข้อ

ใน Settings → Deployments → Production ข้อความ Ships on next deploy หมายความว่าต้อง deploy production ส่วน Removed at tip หมายความว่าไม่มีใน branch ปัจจุบันแล้ว คลิก Sync surfaces หลัง commit แล้ว deploy URL เฉพาะของ Surface ที่ไม่ใช่ root ใช้ได้เฉพาะ production ดู Surface

Module หายไปหรือตั้งค่าไม่สำเร็จคัดลอกลิงก์หัวข้อ

ใน Settings → Modules เปิดเมนูแล้วเลือก Sync from this branch หรือบอก agent ดู Module

เครื่องมืออัปเดตปฏิเสธการทำงานหรือไม่แสดงคัดลอกลิงก์หัวข้อ

ดูตารางข้อผิดพลาดใน Take an update locally

ยังแก้ไม่ได้?คัดลอกลิงก์หัวข้อ

ติดต่อทีมซัพพอร์ต พร้อมบอกว่าคุณกำลังทำอะไรและอะไรล้มเหลว