> For the complete documentation index, see [llms.txt](https://getsquish.gitbook.io/squish/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://getsquish.gitbook.io/squish/th/getting-started/for-ai-agents.md). # สำหรับเอเจนต์ AI คุณเป็นเอเจนต์ (หรือกำลังสร้างเอเจนต์อยู่) และมีวิดีโอที่ต้องตอบคำถาม หน้านี้สรุปการตัดสินใจทั้งหมดไว้ที่เดียว: จะเรียกผ่านช่องทางไหน, จะทำตัวอย่างไรเมื่อได้แผ่นชีตกลับมา, และต้องทำอย่างไรเมื่อคำขอถูกปฏิเสธ ทุกอย่างที่นี่เป็นเพียงสรุป — แต่ละแถวมีลิงก์ไปยังสัญญาที่ควบคุมรายละเอียดนั้น **Squish คืออะไร ในมุมของเอเจนต์:** เป็นเลนส์ ไม่ใช่ตัวตอบคำถาม `squish` แปลงวิดีโอให้เป็นชีตภาพย่อที่มีเวลาประทับกำกับ — เป็นแผนที่ของไทม์ไลน์ที่อ้างอิงได้ — และ *คุณ* เป็นคนอ่านเอง มันไม่ตีความเนื้อหาเลย: โมเดล = ความหมาย, Squish = กลไกการทำงาน ## เลือกช่องทางของคุณ มีเอ็นจินเดียว แต่เข้าถึงได้ 4 วิธี เลือกตามว่าวิดีโออยู่ที่ไหน และคุณรันอะไรได้บ้าง: | สถานการณ์ของคุณ | ใช้ | การจัดการสื่อ | | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------ | ---------------------------------------------------------------------------------------- | | เข้าถึงเชลล์ได้ วิดีโอเป็น **ไฟล์ในเครื่อง** | **CLI** — `npx -y @getsquish/squish clip.mov --json` | เครื่องในเครื่อง, **ไม่ต้องอัปโหลด** ฟรี ไม่มีการกั้น | | ไคลเอนต์คุยได้ **MCP** วิดีโออยู่ในเครื่อง | **เซิร์ฟเวอร์ MCP** — `npx -y @getsquish/squish mcp` เครื่องมือ `squish_video` | เครื่องในเครื่อง, **ไม่ต้องอัปโหลด** ฟรี ไม่มีการกั้น | | **แอป AI อย่างเป็นทางการ** (Claude Desktop / claude.ai / ChatGPT), ไม่มีเครื่องมือในเครื่อง, วิดีโออยู่ที่ **URL สาธารณะ** (หรือแนบมาได้ ในกรณีที่การส่งต่อพารามิเตอร์ไฟล์ของไคลเอนต์ทำงานได้) | **ตัวเชื่อม MCP ระยะไกล** — `https://api.getsquish.app/mcp` | เซิร์ฟเวอร์เป็นคนดึงข้อมูล; แหล่งข้อมูลถูกลบเมื่อจบงาน, ชีตอยู่ที่ URL อายุประมาณ 24 ชม. | | ความต้องการของสินค้า/CI **แบบคำขอ–ตอบกลับ** และอัปโหลดได้ | **Hosted API** — `POST https://api.getsquish.app/v1/squish` | อัปโหลดโดยตั้งใจ; ลบเมื่อจบงาน, ชีตอยู่ที่ URL อายุประมาณ 24 ชม. | คนที่ต้องการใช้งานเองแบบไม่ต้องติดตั้งอะไรเลย ให้ไปที่ [getsquish.app](https://getsquish.app) แทน — ประมวลผลในเบราว์เซอร์ ไม่มีอะไรถูกอัปโหลด มีความไม่สมมาตร 2 อย่างที่ควรรู้ก่อนเลือก: * **หน้าต่างซูม (`start`/`end`) มีใน CLI, เซิร์ฟเวอร์ MCP และปลายทาง MCP ระยะไกล — แต่ตอนนี้ยังไม่มีใน Hosted API** (มันประมวลผลทั้งคลิปต่อหนึ่งคำขอ) ถ้างานต้องใช้ [ลูปการนำทาง](/squish/th/the-primitive/the-navigation-loop.md) ให้เลือกใช้ช่องทาง MCP หรือ CLI * **ปลายทางระยะไกลดึงสื่อฝั่งเซิร์ฟเวอร์** มันรับ URL ไฟล์ตรงแบบสาธารณะ — หรือวิดีโอที่แนบมา ในกรณีที่การส่งต่อไฟล์ผ่าน Apps-SDK ของไคลเอนต์ทำงานได้: เครื่องมือจะประกาศ `openai/fileParams: ["video"]` และแพลตฟอร์มควรจะอัปโหลดไฟล์แนบแล้วเขียนอาร์กิวเมนต์ใหม่ก่อนคำขอจะไปถึง Squish การส่งต่อนั้นคือฝั่งไคลเอนต์ของสัญญา และตอนนี้ยังไม่สม่ำเสมอ — ChatGPT **มือถือ** ตอนนี้ล้มเหลวฝั่งไคลเอนต์ก่อนส่งคำขอเสียอีก (เป็นบั๊กจากต้นทางที่รู้กันอยู่) ดังนั้นบนมือถือให้ใช้ทาง URL ซึ่งยืนยันใช้งานได้จริงแล้วที่นั่น ลิงก์ส่วนตัวเข้าถึงไม่ได้อยู่แล้ว และบนไคลเอนต์ตัวเชื่อมที่ไม่มีการรองรับ file-param ไฟล์แนบในแชตก็ใช้ไม่ได้เช่นกัน ถ้าวิดีโออยู่ในเครื่องและคุณมีเชลล์หรือ MCP ในเครื่อง ให้เลือกเครื่องมือในเครื่อง; ถ้าไม่แน่ใจ ทาง URL สาธารณะคือเส้นทางที่ยืนยันได้ทุกที่ ## กฎการทำงานเมื่อคุณได้ชีตมาแล้ว 1. **อย่าพูดว่า Squish "ดู" วิดีโอ** มันแปลงวิดีโอให้เป็นสิ่งบันทึกภาพที่มีเวลาประทับกำกับ; การอ่านความหมายเป็นหน้าที่ของคุณ 2. **เซลล์เรียงตามลำดับเวลา ซ้าย→ขวา บน→ล่าง** ถ้ามีช่องว่างทางภาพชัดเจนระหว่างสองเซลล์ที่ติดกัน แปลว่ามีเหตุการณ์เกิดขึ้น somewhere ในช่องว่างนั้น — ช่องว่างนั้นคือจุดถัดไปที่ต้อง `start`/`end`. 3. **ซูม แทนที่จะอ่านซ้ำ** timecode เป็นค่าแบบสัมบูรณ์ในทุกระดับ; ส่งค่าที่คุณเห็นตรงๆ กลับไปเป็น `start`/`end` แล้วอ่านชีตที่หนาแน่นกว่าสำหรับช่วงนั้นเพียงอย่างเดียว 4. **อย่าอ้างให้ละเอียดกว่าระยะห่างระหว่างเซลล์** ถ้าเซลล์ที่ติดกันห่างกัน 4 วินาที เหตุการณ์ที่อยู่ระหว่างนั้นคือ "ระหว่าง 0:12 ถึง 0:16" ไม่ใช่ "ที่ 0:14" — ซูมจนเห็นช่วงเวลานั้นได้โดยตรง แล้วค่อยอ้าง 5. **ยืนยันก่อนอ้าง** timestamp ในคำตอบของคุณต้องเป็นค่าที่คุณอ่านจากเซลล์จริงๆ (หรือช่วงระหว่างสองเซลล์) ไม่ใช่การเดา 6. **เสียงขึ้นอยู่กับปาก** CLI/local MCP 0.3+ มีซองกิจกรรมที่ปรับมาตรฐานทั่วโลกบนไทม์ไลน์สัมบูรณ์เดียวกัน มันแสดง *เมื่อ* พลังงานเปลี่ยนไป ไม่ใช่สิ่งที่พูดหรือสิ่งที่ทำให้เกิดเสียง เส้นทาง Hosted ยังเป็นแบบมองเห็นเท่านั้นจนกว่าจะประกาศแยกต่างหาก; ห้ามเดาความหมายของเสียงจากสิ่งประดิษฐ์ทั้งสองแบบ 7. **ผลลัพธ์หลายชีตคือคลิปเดียวในหน้าต่างต่อเนื่องกัน** ให้อ่านทั้งหมดตามลำดับ 8. **ความหนาแน่น = ความละเอียดตามเวลา** `3x3` กู้คืน *ว่าเกิดอะไรขึ้น*; `4x4`–`6x6` กู้คืน *อย่างไร*. ควรเลือกบีบช่วงเวลาให้แคบลง แทนที่จะเพิ่มความหนาแน่น — กริดที่หนาแน่นของทั้งคลิปมีต้นทุนสูงกว่า และให้รายละเอียดน้อยกว่า 3×3 ของช่วงสิบวินาทีที่ถูกต้อง ถ้าจะติดตั้งวิธีนี้ทั้งชุด — เงื่อนไขการเริ่ม, ลูป, วินัยในการอ้างอิง — ให้ใช้ [`video-navigation` สกิล](/squish/th/recipes/agent-skill.md): `npx skills add getsquish/squish`. ## โควตาและการปฏิเสธ * **เครื่องมือในเครื่องไม่เคยถูกกั้น** ไม่มีคีย์ ก็ไม่มีโควตา ไม่มีวัน * **Remote MCP:** ช่องทางใช้ฟรีแบบไม่ระบุตัวตน (ไม่กี่งานต่อวัน UTC — ต่อผู้ใช้เมื่อไคลเอนต์ส่ง Apps-SDK subject id มา, ไม่เช่นนั้นนับตาม IP) หรือ `Authorization: Bearer ` สำหรับงานที่คิดราคาตามเครดิต โควตาหมดแล้วจะส่งกลับมาเป็น **ข้อผิดพลาด JSON แบบมีโครงสร้าง** — ส่งต่อคำใบ้ของมัน (ลิงก์เติมเครดิตหรือการรีเซ็ตประจำวัน) ให้ผู้ใช้แทนที่จะลองซ้ำแบบเดาสุ่ม รายละเอียด: [ปลายทาง Remote MCP](/squish/th/reference/remote-mcp.md). * **Hosted API:** เครดิตแบบจ่ายล่วงหน้าต่อหนึ่งชีตตามความหนาแน่น (1/2/3/5); บัญชีที่ยังไม่เคยจ่ายจะได้โควตาฟรีรายวันเล็กๆ โดยอัตโนมัติ ความหมายของข้อผิดพลาด — อะไรถูกคิดเงิน, อะไรถูกคืน, อะไรปลอดภัยที่จะลองใหม่ — อยู่ใน [เอกสารอ้างอิงของ Hosted API](/squish/th/reference/http-api.md); กฎเดียวที่ต้องเขียนตายตัวคือ: เมื่อ `500` check `refunded` ในเนื้อหา — `true` แปลว่าลองใหม่ได้ 1 ครั้ง, `false` แปลว่าคิดเงินไปแล้ว ให้รายงานแทนที่จะลองซ้ำ ## การอ่านเอกสารชุดนี้แบบให้เครื่องอ่านได้ * **ดัชนีสำหรับเอเจนต์:** [`/llms.txt`](https://getsquish.gitbook.io/squish/llms.txt) · เอกสารทั้งหมดรวมอยู่ในไฟล์เดียว: [`/llms-full.txt`](https://getsquish.gitbook.io/squish/llms-full.txt) * **มาร์กดาวน์ดิบ:** เติม `.md` ต่อท้าย URL ของหน้าเอกสารใดก็ได้ * **เซิร์ฟเวอร์ Docs MCP:** `https://getsquish.gitbook.io/squish/~gitbook/mcp` — ใช้เอกสารเหล่านี้เป็นเครื่องมือในการสอบถาม * **ข้อควรทราบฝั่งสินค้า:** [getsquish.app/llms.txt](https://getsquish.app/llms.txt) ครอบคลุมเว็บแอปและหน้าบัญชี/เครดิต * **สัญญาที่อ่านได้ด้วยเครื่อง:** ทุกคำตอบถูกประทับด้วยสตริงสัญญาที่ล็อกไว้ (`squish-cli-v0` · `squish-mcp-v0` · `squish-mcp-http-v0` · `squish-http-v0`) — ดูที่ [เสถียรภาพและการกำหนดเวอร์ชัน](/squish/th/reference/stability.md). --- # Agent Instructions This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com. ## Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter: ``` GET https://getsquish.gitbook.io/squish/th/getting-started/for-ai-agents.md?ask=&goal= ``` `ask` is the immediate question: it should be specific, self-contained, and written in natural language. `goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.