Tool: bash_bg — เริ่มและติดตาม shell job ที่ใช้เวลานาน

ภาพรวมระบบสำหรับ: Tool: bash_bg — เริ่มและติดตาม shell job ที่ใช้เวลานานbash_bg ของ Agent TH เริ่ม shell job แบบ background แล้วให้ติดตามสถานะ ผลลัพธ์ หรือหยุดงานด้วย job_id ภายใต้ sandbox ของ Bashเริ่ม jobขั้นที่ 1รับ job idขั้นที่ 2ตรวจสถานะ/logขั้นที่ 3หยุดเมื่อเสร็จขั้นที่ 4ติดตาม shell job เบื้องหลัง
ภาพประกอบระบบภาพนี้สรุปขั้นตอนของ ติดตาม shell job เบื้องหลัง ตามกลไกที่อธิบายในบทความ

bash_bg ใช้กับคำสั่งที่ควรรันต่อหลัง tool call คืนค่า เช่น dev server หรือ process ที่ต้อง poll ภายหลัง งานสั้นให้ใช้ bash ซึ่งรอผลใน call เดียว

เริ่มและติดตามงาน

เริ่มด้วย action="start" และเก็บ job_id ที่ได้กลับมา:

bash_bg(action="start", command="npm run dev")
bash_bg(action="status", job_id="<job_id>")
bash_bg(action="list")
bash_bg(action="kill", job_id="<job_id>")

status แสดงสถานะกับส่วนท้ายของ log; list แสดง job ที่ process นี้จัดการอยู่ และ kill ขอหยุด job ที่ระบุ คำสั่งที่จบเร็วอาจรายงานสถานะเสร็จสิ้นตั้งแต่การเริ่ม

ขอบเขตและ log

มีงาน background ที่กำลังรันได้สูงสุด 5 job ต่อ process; ถ้าเต็มให้ตรวจรายการและหยุด job ที่ไม่ใช้แล้วก่อนเริ่มเพิ่ม แต่ละ job บันทึก stdout/stderr ลงไฟล์ _bash_bg_<job_id>.log ใน workspace เพื่อให้ตรวจผลย้อนหลังได้

คำสั่งใช้ macOS sandbox profile ของ Bash และไม่ได้รับ write scope เพิ่มจากการทำงาน background: การเขียนปกติอยู่ใน internal workspace และ /tmp; mutation guard ยังคงตรวจ protected paths และ symlink ตาม policy เดิม

ใช้ job id ที่ได้จาก tool เท่านั้น และตรวจ status/log หลังจบก่อนรายงานว่างานสำเร็จ

อ่านเพิ่มเติม

ความคิดเห็น

กำลังโหลดความคิดเห็น...