Agent
Provider & model, system prompt, cửa sổ lịch sử, bật/tắt, ngân sách token mỗi ngày.
Một agent là một cấu hình chat có thể tái sử dụng: provider và model nào trả lời, dùng system prompt gì, được tra cứu knowledge base nào, được gọi tool của connector nào, và giới hạn ra sao. Một tổ chức có thể có nhiều agent — ví dụ một agent hỗ trợ khách hàng và một agent nội bộ, mỗi cái một knowledge base và system prompt riêng.
Tạo agent
Trong console tại app.harnix.vn, mở Trợ lý AI và bấm Trợ lý AI mới.
Điền Tên, chọn Nhà cung cấp, rồi nhập Mô hình, Khoá API và Base URL nếu cần.
Viết System prompt, gắn một hoặc nhiều Cơ sở tri thức, và đặt các trường tuỳ chọn trong Hành vi (Temperature, Top-p, Số vòng tối đa, Ngân sách token mỗi ngày).
Bấm Tạo trợ lý AI. Agent hoạt động ngay và xuất hiện trong danh sách agent công khai mà widget đọc.
Provider & model
Có hai provider: Tương thích OpenAI (lưu là openai) và Ollama
(ollama). OpenAI-compatible dùng được với mọi endpoint nói chuẩn OpenAI
API — đặt Base URL trỏ tới endpoint của bạn. Mô hình là tên model của
provider đó (ví dụ gpt-4o-mini, llama3.1:8b).
Khoá API là thông tin xác thực để gọi provider. Key được mã hoá khi lưu và không bao giờ hiện lại: console chỉ cho biết Đã có khoá · mã hoá khi lưu hoặc Chưa có khoá.
Temperature và Top-p là tham số sampling tuỳ chọn, chuyển thẳng cho provider khi được đặt. Số vòng tối đa giới hạn số lần gọi model trong một câu trả lời khi agent dùng tool.
System prompt
System prompt được chèn nguyên văn trước mọi cuộc hội thoại. Trường này tuỳ chọn — để trống thì agent dùng hành vi mặc định của model.
Cửa sổ lịch sử
Mỗi lượt chat đọc lại một phần hội thoại trước đó để model có ngữ cảnh. Cửa sổ dừng ở giới hạn nào chạm trước:
| Giới hạn | Mặc định |
|---|---|
Số message (history_max_turns) | 20 |
Số ký tự (history_max_chars) | 24.000 |
Console chưa cho chỉnh hai giới hạn này; nếu một agent cần cửa sổ khác, liên hệ support. Hội thoại dài hơn cửa sổ vẫn được lưu đầy đủ — chỉ phần đọc vào mỗi lượt chat bị cắt.
Knowledge base và tool
Gắn ít nhất một knowledge base là agent tự có tool knowledge_search —
không có công tắc nào phải bật (xem Tool). Tool tích hợp (như
ask_user, bật sẵn cho agent mới) và connector (MCP server từ xa) được quản
lý ở tab Công cụ của agent, mỗi tool có công tắc bật/tắt riêng — xem
Tool và Connector.
Ngân sách token mỗi ngày
Ngân sách token mỗi ngày là trần số token (input + output) agent này được
dùng trong một ngày UTC. Để trống là không giới hạn riêng cho agent (tổ
chức vẫn có thể có trần chung, xem
Mức sử dụng & Hạn mức); khi đặt, tối thiểu là 1.000.
Khi chạm ngân sách, run mới của agent đó bị từ chối với budget_exceeded
(xem Lỗi), còn run đang chạy dừng lại trước lần gọi
model kế tiếp.
Tab Mức sử dụng
Trang của mỗi agent có tab Mức sử dụng riêng: ngân sách token hôm nay của agent đó (kèm link sửa ở trang Mức sử dụng & Hạn mức), rồi đến báo cáo sử dụng giống hệt trang Mức sử dụng chung — số run và token theo 7/30/90 ngày, biểu đồ theo ngày, và bảng chi tiết theo mô hình hoặc trạng thái — nhưng chỉ tính riêng agent này (không có chiều Trợ lý AI vì mọi dòng đều đã là agent đó). Những con số này không đổi theo thời gian; chỉ nội dung chi tiết từng bước của một run cũ (trace) bị xoá theo cấu hình lưu trữ của tổ chức — xem Lượt chạy & Trace.
Bật / tắt
Trên trang của agent, Ngừng hoạt động là xoá mềm: agent biến khỏi danh sách
agent công khai (GET /v2/agents — widget không chọn được nữa), nhưng lịch
sử run và hội thoại vẫn xem được trong console. Kích hoạt bật lại. Agent
không có xoá cứng.
Sửa agent
Mở agent, bấm Sửa cấu hình, sửa những gì cần rồi Lưu thay đổi. Thay đổi áp dụng từ run kế tiếp; run đang chạy vẫn dùng cấu hình lúc nó bắt đầu. Khoá API đã lưu giữ nguyên trừ khi bạn bấm Đổi khoá (và nhập key mới) hoặc Gỡ khoá (agent khi đó dùng mặc định của provider).