> ## 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.

# Giao diện web

> Mở giao diện web, đăng nhập bằng token và quản lý các cuộc trò chuyện với Nagare.

Giao diện web là cách chính để trò chuyện và cấu hình Nagare. Ứng dụng desktop `nagare-desktop` dùng cùng giao diện này.

## Mở giao diện web

Đảm bảo gateway đang chạy (`nagare gateway start`), rồi chạy:

```bash theme={null}
nagare web
```

Mặc định, lệnh này:

* Phục vụ giao diện tại `http://127.0.0.1:3005`.
* Tạo một token đăng nhập mới.
* Mở trình duyệt tại URL có sẵn `gateway` và `token`, nên bạn được đăng nhập ngay. Giao diện tự xóa các tham số này khỏi thanh địa chỉ sau khi lưu.

Các tùy chọn thường dùng:

```bash theme={null}
# Đổi cổng giao diện web
nagare web --addr 127.0.0.1:8080

# Chỉ in URL đăng nhập, không mở trình duyệt
nagare web --no-open

# Kết nối tới gateway ở địa chỉ khác
nagare web --gateway http://192.168.1.10:9832
```

Xem đầy đủ tại [Tham chiếu CLI](https://docs.nagare.smtdfc.net/reference/cli.md#nagare-web).

## Đăng nhập thủ công

Nếu bạn mở giao diện mà chưa đăng nhập:

1. Tạo token:
   ```bash theme={null}
   nagare auth token
   ```
2. Truy cập `http://127.0.0.1:3005` và dán token vào ô đăng nhập.
3. Nếu gateway không chạy ở địa chỉ mặc định, bấm **Advanced** để nhập URL gateway.

> [!NOTE]
>
> Token là JWT có hiệu lực **60 giờ**. Khi hết hạn, tạo token mới bằng `nagare auth token`.

## Trò chuyện

Mỗi cuộc trò chuyện là một **phiên (session)** có tiêu đề, mô hình đang dùng và lịch sử riêng. Trong giao diện, bạn có thể:

| Thao tác | Mô tả |
| - | - |
| Tạo phiên mới | Bắt đầu cuộc trò chuyện mới với mô hình mặc định. |
| Đổi mô hình | Chọn nhà cung cấp và mô hình khác cho riêng phiên hiện tại. |
| Hủy | Dừng câu trả lời đang được tạo. |
| Thu gọn (compact) | Tóm tắt hội thoại dài để giảm ngữ cảnh gửi lên mô hình. Dùng **Summary model** nếu đã cấu hình, nếu không thì dùng mô hình của cuộc trò chuyện. |
| Nhân bản | Tạo bản sao của phiên. |
| Lưu trữ | Ẩn phiên khỏi danh sách chính mà không xóa. |
| Xóa | Xóa phiên và lịch sử. |

Câu trả lời được truyền về theo thời gian thực qua WebSocket.

## Phê duyệt công cụ

Khi Nagare muốn chạy một công cụ có rủi ro (ví dụ xóa tệp, tắt máy, kết thúc tiến trình), giao diện hiển thị yêu cầu phê duyệt. Bấm chấp nhận để cho phép hoặc từ chối để hủy. Xem [Công cụ](https://docs.nagare.smtdfc.net/guides/tools.md#phe-duyet-cong-cu).

## Trang cài đặt

| Trang | Nội dung |
| - | - |
| **General** | Mô hình mặc định và mô hình tóm tắt. |
| **Model providers** | Thêm, xem, xóa nhà cung cấp mô hình. |
| **Credentials** | Lưu API key để dùng lại cho nhiều nhà cung cấp. |
| **Plugins** | Cài, cập nhật, bật/tắt, gỡ plugin và xem trạng thái. |

Xem [Nhà cung cấp mô hình](https://docs.nagare.smtdfc.net/guides/model-providers.md) và [Tổng quan plugin](https://docs.nagare.smtdfc.net/plugins/overview.md).


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