Khi agent treo / đi sai hướng
Đối tượng: member (dừng agent) và admin (xử lý sâu) khi agent lặp vô nghĩa, đi sai hướng, hoặc kẹt.
Dừng và chẩn đoán
- Dừng agent: nút Stop Agent trên UI, hoặc:
curl -X POST http://<host>/api/tasks/<taskId>/stop
Process CLI bị kill, worktree giữ nguyên.
- Xem agent đã làm gì: tab Event Stream (toàn bộ log), tab Changes (diff hiện tại),
GET /api/tasks/:id/events.
Chọn hướng đi
| Tình huống | Cách xử lý |
|---|---|
| Agent đi đúng hướng nhưng thiếu | Tab Follow-up → gửi tin nhắn bổ sung, không cần restart |
| Agent đi sai hoàn toàn | Stop → sửa description cho rõ hơn → Run lại |
| Muốn giữ code nhưng đổi cách tiếp cận | Stop → nhờ admin Request Changes với ghi chú → rework trên cùng worktree |
| Worktree đã bẩn không cứu được | POST /api/tasks/:id/cleanup-worktree → Run lại từ đầu |
Task kẹt ở executing dù đã stop | Lease 30s tự hết hạn; hoặc restart server để kích hoạt orphan recovery (sysadmin) |
Giới hạn cần biết
- Timeout mặc định 60 phút (
AGENT_TIMEOUT_MS), override 1–240 phút ở cấp task. Hết giờ, agent bị kill và task ghi Activity timeout. - Quá 3 vòng rework task tự vào
needs-human. Lúc này làm tay trong worktree:
docker exec -it agentjira_server sh -c 'cd <worktreePath> && git log --oneline -5 && git status'