> ## Documentation Index
> Fetch the complete documentation index at: https://docs.nagare.smtdfc.net/llms.txt
> Use this file to discover all available pages before exploring further.

# Cron job

> Yêu cầu Nagare tự động thực hiện một việc theo lịch định kỳ.

Cron job cho phép Nagare tự chạy một yêu cầu theo lịch, ví dụ "mỗi sáng 9 giờ, cho tôi biết thời tiết".

## Tạo cron job

Bạn chỉ cần nói với Nagare trong cuộc trò chuyện:

```text theme={null}
Mỗi ngày lúc 9 giờ sáng, hãy cho tôi biết thời tiết ở Hà Nội.
```

```text theme={null}
Cứ 30 phút một lần, kiểm tra xem tiến trình nào dùng quá 2 GB RAM.
```

Nagare dùng công cụ `create_cronjob_tool` với ba tham số:

| Tham số | Mô tả |
| - | - |
| `name` | Tên của cron job. |
| `action_description` | Nội dung việc cần làm khi đến lịch. Đây là một yêu cầu độc lập, Nagare sẽ thực hiện nó mỗi lần cron job chạy. |
| `cron_expr` | Biểu thức cron. |

## Biểu thức cron

Dùng định dạng cron chuẩn 5 trường: `phút giờ ngày-trong-tháng tháng ngày-trong-tuần`.

| Biểu thức | Ý nghĩa |
| - | - |
| `0 9 * * *` | Mỗi ngày lúc 9:00. |
| `*/30 * * * *` | Mỗi 30 phút. |
| `0 8 * * 1` | 8:00 mỗi thứ Hai. |
| `@daily` | Mỗi ngày một lần (lúc nửa đêm). |
| `@hourly` | Mỗi giờ một lần. |

## Cách cron job chạy

* Cron job gắn với **phiên trò chuyện** nơi nó được tạo.
* Khi đến lịch, gateway gửi `action_description` vào phiên đó như một tin nhắn hệ thống, với ngữ cảnh tách biệt. Kết quả xuất hiện trong chính cuộc trò chuyện đó (bao gồm cả cuộc trò chuyện Telegram).
* Sau mỗi lần chạy, thời điểm chạy tiếp theo được tính lại tự động.

> [!WARNING]
>
> Cron job chỉ chạy khi gateway đang chạy. Nếu gateway tắt, hãy khởi động lại bằng `nagare gateway start`.

Nếu việc cần làm dùng tới công cụ yêu cầu phê duyệt, bạn vẫn phải phê duyệt mỗi lần chạy. Xem [Phê duyệt công cụ](https://docs.nagare.smtdfc.net/guides/tools.md#phe-duyet-cong-cu).


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.