Starcat Agent

Design Assets

บันทึก ปรับแต่ง และแชร์ mockup ดีไซน์แบบ HTML ที่ใช้ซ้ำได้ทั่วทั้งองค์กร

Design asset คืองานดีไซน์แบบ HTML ที่เก็บถาวรและใช้ซ้ำได้ เป็นขององค์กรคุณ อยู่ใน dashboard ที่ Design Assets (ขณะนี้เป็น Beta) และจะปรากฏเป็นการ์ดที่คลิกได้ในแชตเมื่อ agent อ้างถึง

แต่ละ asset มี title, slug ใน URL, HTML content, PNG thumbnail ที่เรนเดอร์แล้ว และสถานะ draft หรือ published asset หนึ่งๆ จะผูกกับโปรเจกต์ใดโปรเจกต์หนึ่ง หรือจะไม่ผูกกับโปรเจกต์ใดเลยก็ได้ เพื่อให้ใช้ซ้ำได้ในหลายโปรเจกต์

การสร้าง design asset

สร้าง design asset ได้สี่วิธี:

1

จาก HTML preview ในแชต

ขอให้ Starcat Developer ทำ mockup ให้ เมื่อ agent เรนเดอร์ HTML preview ในแชต ให้คลิกไอคอน palette บนแถบเครื่องมือของ preview ใส่ title แล้วบันทึก

2

จาก preview ที่บันทึกไว้ของโปรเจกต์

เปิดแท็บ Previews ในการตั้งค่าของโปรเจกต์ แล้วคลิกไอคอน palette บนการ์ด preview ใดก็ได้ asset จะถูกสร้างด้วย title และ HTML content ของ preview นั้น

3

จาก dashboard

ไปที่ Design Assets แล้วคลิก New asset ใส่ title และ HTML เริ่มต้น จากนั้นเปิด asset เพื่อแก้ไขต่อ

4

ผ่าน agent หรือ MCP

agent ที่มีสิทธิ์เขียนเรียก save_design_asset ได้โดยตรงในแชต หรือผ่าน MCP client ภายนอกที่เชื่อมต่อกับองค์กรของคุณ

การดูและแก้ไข

เปิด asset จากตารางเพื่อแก้ HTML และ title ดู preview ที่ขนาด Desktop (1280px), Tablet (768px) หรือ Mobile (390px) และสร้างหรือดาวน์โหลด PNG thumbnail ใหม่ Regenerate ใช้เนื้อหาที่บันทึกล่าสุด จึงควรบันทึกก่อน

agent อัปเดต asset ด้วย save_design_asset (ใช้ slug เดิม) เมื่อต้องเขียนใหม่ทั้งหมด หรือใช้ edit_design_asset สำหรับการแก้เล็กน้อยแบบค้นหาแล้วแทนที่ หลังจากดึง asset ด้วย get_design_asset

การเผยแพร่และการแชร์

asset เริ่มต้นเป็น draft เฉพาะ asset ที่ published เท่านั้นที่เข้าถึงได้ที่หน้าแชร์สาธารณะ https://www.stardeck.ai/assets/<slug>

ในหน้ารายละเอียดของ asset คลิก Publish เพื่อเปิดลิงก์แชร์ คลิก Unpublish เพื่อกลับเป็น draft หน้าสาธารณะจะโหลด asset นั้นไม่ได้อีก

เมื่อเผยแพร่แล้ว ให้ตั้งค่า Share view:

การตั้งค่าควบคุมอะไร
Sizesความกว้างของ viewport ที่ผู้เข้าชมสลับดูได้บนหน้าสาธารณะ (Desktop 1280px, Tablet 768px, Mobile 390px) ต้องเลือกไว้อย่างน้อยหนึ่งขนาด
Displayวิธีที่ผู้เข้าชมเห็น asset: Live preview (HTML ที่โต้ตอบได้), Live + image toggle (สลับระหว่าง HTML สดกับ PNG) หรือ Image only (thumbnail นิ่ง)

คัดลอกลิงก์แชร์จากหน้ารายละเอียด หรือดาวน์โหลด PNG thumbnail ไปใช้ในสไลด์ เอกสาร และที่อื่นนอก Stardeck

การเข้าถึงของ agent และ MCP

tool ของ design asset เป็นระดับองค์กร และถูกควบคุมด้วย permission key สองตัวใน Settings → Roles & Permissions:

สิทธิ์Tools
agent:design-assets:readlist_design_assets, get_design_asset
agent:design-assets:writesave_design_asset, edit_design_asset (ต้องมีสิทธิ์ read ด้วย)

Read tools

  • list_design_assets: แสดงรายการ asset ที่บันทึกไว้ (slug, title, สถานะ, thumbnail, URL สำหรับแชร์ และโปรเจกต์ที่ผูกอยู่ถ้ามี ไม่รวม HTML content ทั้งหมด) ส่ง projectId เพิ่มได้ถ้าต้องการ เพื่อแสดง asset ของโปรเจกต์นั้นรวมกับ asset ที่ไม่ผูกกับโปรเจกต์ใด
  • get_design_asset: ดึง asset หนึ่งรายการด้วย slug รวม HTML content ทั้งหมด

Write tools

  • save_design_asset: สร้าง asset ใหม่ หรืออัปเดต asset ที่มีอยู่ด้วย slug
  • edit_design_asset: แก้เนื้อหาที่เก็บไว้แบบค้นหาแล้วแทนที่เฉพาะจุด

ตั้งใจไม่มี tool สำหรับลบ การลบ asset ทำได้จาก dashboard เท่านั้น (Delete ในหน้ารายละเอียดของ asset)

การ์ดในแชต

เมื่อ agent บันทึกหรืออ้างถึง asset ในแชตของ Stardeck มันสามารถแสดงการ์ดที่คลิกได้ โดยใช้ code block ที่มีภาษาเป็น design-asset และมี slug ของ asset เป็นเนื้อหา:

```design-asset
my-dashboard-mock-a1b2c3
```

การ์ดแสดง thumbnail, title และสถานะ คลิกเพื่อเปิดหน้าต่าง live preview ไปยัง asset ใน dashboard หรือคัดลอกลิงก์แชร์สาธารณะ (เมื่อเผยแพร่แล้ว)

การใช้ asset ในแชต

คุณส่ง asset ให้ agent ได้โดยตรงจากช่องพิมพ์ข้อความ คลิกปุ่ม + แล้วเลือก Design Assets เพื่อเรียกดูคลังของคุณ ค้นหาด้วย title หรือ slug และเลือกหนึ่งรายการ รายการที่เลือกจะแสดงเป็นชิปที่ลบออกได้เหนือช่องพิมพ์ และเมื่อคุณส่งข้อความ agent จะได้รับการอ้างอิงถึง asset นั้น (ข้อความที่ส่งของคุณจะแสดงเป็นการ์ด)

ในแชตนักพัฒนาของโปรเจกต์ นี่คือวิธีเปลี่ยนดีไซน์ให้เป็นงานที่สร้างจริง: แนบ asset (หรือเอ่ยชื่อก็ได้) แล้วขอให้ agent ทำตาม agent จะดึง HTML ของ asset มาและถือเป็นสเปกของดีไซน์ หากคุณขอให้แก้ตัวดีไซน์เอง agent ก็อัปเดต asset ที่บันทึกไว้ได้เลย

หมายเหตุ:

Design asset ใช้ร่วมกันทั้งองค์กร เมื่อ agent แก้ asset ที่บันทึกไว้จากภายในโปรเจกต์หนึ่ง การเปลี่ยนแปลงจะปรากฏในทุกที่ที่ใช้ asset นั้น