Trợ lý AI

Cài đặt > Trợ lý AI cấu hình AI cho mọi tài khoản trên máy chủ: widget Trợ lý và agent Vibe Code của panel người dùng, tính năng tóm tắt, gợi ý trả lời và dịch của webmail, và Trợ lý quản trị của chính bạn. Một nhà cung cấp, một khoá, một chính sách chống lạm dụng.

Nhà cung cấp

Thiết lập	Ghi chú
Enable AI for all users	Công tắc tổng. Tắt nghĩa là không tính năng AI nào xuất hiện ở bất cứ đâu.
Nhà cung cấp	OpenAI, Anthropic (Claude), hoặc Tuỳ chỉnh - bất kỳ endpoint chat-completions tương thích OpenAI nào: OpenRouter, LiteLLM, một Ollama cục bộ (`http://127.0.0.1:11434/v1`), một gateway bên thứ ba.
Model	ví dụ `gpt-4o-mini`, `claude-opus-5`, `llama3`.
API key	Chỉ được lưu trong `/etc/hitechcloud/ai/gateway.conf` (`root:hitechwebmail`, `0640`). Trang hiển thị bốn ký tự cuối và không bao giờ hiển thị lại khoá. Để nguyên trường để giữ khoá, dán để thay, xoá trống để gỡ.
Base URL	Tuỳ chọn với OpenAI/Anthropic, bắt buộc với Tuỳ chỉnh. Tới và không bao gồm `/chat/completions`.
Max tokens per reply	Giới hạn đầu ra cho mỗi yêu cầu.

Kiểm tra kết nối gửi một yêu cầu rất nhỏ với những gì có trong biểu mẫu - đã lưu hay chưa - và báo lại câu trả lời hoặc lỗi của nhà cung cấp (với khoá đã được che).

Chống lạm dụng

Mọi giới hạn đều tính theo từng tài khoản hosting và được panel và webmail dùng chung qua một bộ đếm (/var/lib/hitechcloud/ai/usage/<account>.json).

Thiết lập	Mặc định
Requests per minute	20
Daily token budget (input + output)	200 000, đặt lại lúc nửa đêm UTC
Max input characters per request	20 000
Allowed features	tóm tắt, gợi ý trả lời, dịch, định dạng văn bản, ý chính, trợ lý chat
Blocked keywords / patterns	Biểu thức chính quy không phân biệt hoa thường, mỗi dòng một biểu thức; yêu cầu khớp sẽ bị từ chối trước khi rời khỏi máy chủ
Log all requests (metadata only)	Bật. Mỗi yêu cầu một dòng trong `/var/log/hitechcloud/ai.log`: tài khoản, tính năng, model, kích thước, token, thời lượng. Không bao giờ ghi nội dung. Yêu cầu bị từ chối và mọi lời gọi công cụ của agent luôn được ghi dù thế nào.

Ai được dùng AI

Accounts you own directly - mặc định bật/tắt cho khách hàng của chính bạn.
Resellers and their customers - bật/tắt. Khi bật, mỗi đại lý có Tài khoản > Trợ lý AI trong panel riêng để cấp hoặc không cấp AI cho khách hàng của họ (một công tắc mặc định cùng Cho phép/Từ chối cho từng tài khoản).
Chỉ các tài khoản thuộc những gói này - giới hạn trong các gói đã chọn.
Always allow / Never allow - giá trị ghi đè cho từng tài khoản. Từ chối thắng mọi thứ, kể cả quyền đại lý đã cấp.

Các quy tắc nằm trong /etc/hitechcloud/ai/access.conf và /etc/hitechcloud/ai/resellers/<reseller>.conf; quyết định cho từng tài khoản được ghi cụ thể vào /etc/hitechcloud/ai/accounts.conf cho webmail, được dựng lại khi lưu và được panel làm mới mỗi khi nó quyết định cho một tài khoản.

Trợ lý quản trị

Cài đặt > Trợ lý quản trị là một khung chat dành cho bạn, trên cùng gateway, được tính vào admin:<your username>. Nó có thể liệt kê tài khoản và gói, hiển thị chi tiết và tên miền của một tài khoản, kiểm tra dịch vụ và tình trạng máy chủ, đọc một vùng DNS, và - chỉ sau khi bạn xác nhận trong chat - tạm ngưng hoặc bỏ tạm ngưng một tài khoản hay khởi động lại một dịch vụ. Đại lý không có tính năng này.

Các quy tắc cố định của nó, được áp dụng bằng mã ở nơi có thể và nêu trong prompt ở nơi không thể:

Không bao giờ leo thang đặc quyền; nó chạy với quyền của phiên của bạn và chỉ các công cụ được liệt kê.
Không bao giờ để lộ mật khẩu, mã băm, khoá hay token; kết quả công cụ che chúng đi.
Không bao giờ tiết lộ dữ liệu của khách hàng này để giúp khách hàng khác.
Từ chối các thao tác không an toàn; giải thích rủi ro của một thao tác phá huỷ và yêu cầu bạn xác nhận.
Báo lại chính xác những gì công cụ trả về.
Trả lời bằng ngôn ngữ bạn chọn (tiếng Anh hoặc tiếng Việt).

Tệp

/etc/hitechcloud/ai/gateway.conf       provider, key, policy   root:hitechwebmail 0640
/etc/hitechcloud/ai/access.conf        delegation rules        0644
/etc/hitechcloud/ai/resellers/*.conf   one reseller's rules    0644
/etc/hitechcloud/ai/accounts.conf      decision per account    0644
/var/lib/hitechcloud/ai/usage/*.json   per-account budget      root:hitechwebmail 2770
/var/log/hitechcloud/ai.log            audit log               root:hitechwebmail 0660

Webmail đọc tệp cấu hình qua HITECHCLOUD_AI_CONF trong tệp môi trường của nó (do hitechcloudcli webmail install ghi), tệp này cũng đặt HITECHCLOUD_AI_USAGE_DIR và HITECHCLOUD_AI_LOG.