Nhật ký thay đổi

2026-10-14 — v1.0.0Sao chép liên kết

• Bản chính thức — Harnix chuyển từ beta sang hạ tầng production mới: cơ sở dữ liệu được sao lưu hằng ngày, có bản sao ở một tài khoản tách biệt, và khôi phục được về một thời điểm bất kỳ trong 14 ngày gần nhất. Địa chỉ app.harnix.vn, api.harnix.vn và mã nhúng widget giữ nguyên.
• Tìm kiếm tri thức — model embedding mới, đa ngôn ngữ, cho kết quả knowledge_search tốt hơn với tài liệu tiếng Việt, tiếng Anh và câu hỏi chéo hai ngôn ngữ. Xem Cơ sở tri thức.
• Dữ liệu beta — tổ chức, agent, cơ sở tri thức và hội thoại từ bản beta không được chuyển sang; hãy tạo lại tổ chức và tải lại tài liệu.
• Bảo mật — cập nhật các thành phần của console và trang đăng nhập để vá các lỗ hổng mức nghiêm trọng đã công bố.

2026-10-12Sao chép liên kết

• Tài liệu — trang mới Xây dựng MCP server cho đội tự viết MCP server: transport, bốn cách xác thực (header, OAuth authorization code + PKCE, client credentials, không xác thực) với đúng các chuẩn, tham số và response Harnix dùng, cách thiết kế tool và annotation, giới hạn kết quả, và bảng mã lỗi kèm cách sửa phía server.

2026-10-11Sao chép liên kết

• Widget — thẻ câu hỏi (ask_user) hiển thị trực tiếp trong cuộc hội thoại: 1–4 câu hỏi, lựa chọn radio hoặc checkbox, ô nhập "Khác" cho câu trả lời tự do, và đếm ngược 10 phút. Bấm chọn gửi ngay với câu hỏi chọn một (tap-to-send); nút Gửi bật khi mọi câu hỏi được trả lời. Ô nhập tin nhắn không bị khoá — gõ trực tiếp vào ô chat cũng là gửi câu trả lời và tiếp tục cùng lượt chạy. Thẻ câu hỏi tự khôi phục khi tải lại trang; quá hạn thu gọn thành dòng thông báo hết hạn. Bảy chuỗi tuỳ biến mới trong strings. Xem Widget.
• Console — tab Công cụ của agent thêm mục Công cụ tích hợp (Built-in tools) hiển thị các tool nền tảng (ask_user) với công tắc bật/tắt riêng. Bộ lọc trạng thái lượt chạy có thêm Chờ người dùng trả lời (waiting_input). Trace hiển thị hai bước QUESTION (hỏi: câu hỏi, chế độ, các lựa chọn; và trả lời: lựa chọn, câu trả lời tự do, hoặc hết hạn, kèm ai trả lời). Xem Tool và Lượt chạy & Trace.

2026-10-10Sao chép liên kết

• Tool tích hợp (ask_user) — agent có thể hỏi lại người dùng bằng 1–4 câu hỏi trắc nghiệm khi cần quyết định để tiếp tục; người dùng có thể chọn câu trả lời hoặc tự gõ câu trả lời của mình. Run dừng ở trạng thái waiting_input mà không giữ worker, chờ tối đa 10 phút. Stream có thêm khung question, cuộc hội thoại có pending_question, route mới POST /v2/runs/{run_id}/answer nhận câu trả lời theo cấu trúc. Gửi tin nhắn mới khi đang có câu hỏi chờ sẽ trả lời câu hỏi đó bằng văn bản tự do và tiếp tục chính lượt chạy đang chờ. Catalog tool tích hợp được bật sẵn cho agent mới và quản lý qua console. Xem Tool, Streaming, Cuộc hội thoại và Idempotency & huỷ.

2026-10-09Sao chép liên kết

• Connector — hành động ghi qua connector (tool server không đánh dấu readOnlyHint: true) giờ chờ người dùng cuối xác nhận trong hội thoại trước khi chạy, với tên tool và tham số thật; từ chối hay quá 5 phút không trả lời thì trợ lý báo lại và cuộc hội thoại tiếp tục bình thường. Stream có thêm khung approval, cuộc hội thoại có pending_approval, route mới POST /v2/runs/{run_id}/approval để đồng ý hoặc từ chối (kể cả cho cả cuộc hội thoại), và hai mã lỗi mới 409 approval_pending, 409 run_not_waiting — tổng cộng 21 mã. Xem Connector, Streaming và Idempotency & huỷ.
• Widget — thẻ xác nhận công cụ hiện trong hội thoại: tên connector, tên công cụ, tham số thật, ba nút (Đồng ý, Đồng ý cho cuộc trò chuyện này, Từ chối), và đếm ngược 5 phút. Ô nhập bị khoá khi chờ xác nhận; tải lại trang khôi phục thẻ. Mười chuỗi tuỳ biến khác cho thẻ, nút, và dòng quyết định. Xem Widget.
• Console — tab Công cụ của agent: mỗi tool có công tắc Cần xác nhận riêng, chip annotation (Chỉ đọc/Ghi/Không khai), và nút Về mặc định khi có ghi đè. Chip phân loại trạng thái thêm Chờ xác nhận (warn); bộ lọc trạng thái có giá trị này. Trace hiện hai bước APPROVAL (xin xác nhận với chi tiết tool, và quyết định với ai/khi nào/kết quả). Hội thoại hiện dòng quyết định dưới lời trợ lý. Xem Connector, Lượt chạy & Trace, và Hội thoại.

2026-10-04Sao chép liên kết

• Console — console quản trị giờ có tiếng Việt cho mọi màn hình của tổ chức (Tổng quan, Trợ lý AI, Cơ sở tri thức, Lượt chạy, Hội thoại, Người dùng cuối, Mức sử dụng, Kết nối, Khoá API, Tích hợp, Thành viên, Hạn mức & giới hạn, Tổ chức). Chuyển giữa VI | EN ở chân thanh bên trái, hoặc góc trên bên phải trang đăng nhập; lựa chọn lưu vào tài khoản và các trang đăng nhập đổi theo. Tài khoản mới mặc định tiếng Việt. Xem Tổng quan. Các trang hướng dẫn cũng gọi tên nút, trường và mục theo đúng nhãn tiếng Việt của console.

2026-10-02Sao chép liên kết

• Giới hạn — tổ chức bạn giờ có trần số run chat chạy cùng lúc (mặc định 10) và số chat chờ slot trống (mặc định 50), do đội Harnix đặt. Một message chỉ có thể vào hàng đợi đã đầy nhận lỗi mới 429 queue_full (kèm retry_after và Retry-After) thay vì chờ vô hạn; tổng cộng giờ có 19 mã lỗi. Xem Giới hạn và Mã lỗi.
• Usage & Quotas — Concurrent runs và Queue depth hiện trần của tổ chức thay cho "no limit set", và chỉ đếm run chat.
• Widget — khi gặp queue_full, widget hiện "Assistant is busy, try again in N s" và mở lại ô nhập khi đếm ngược xong (thay bằng chuỗi mới queueFull). Khi hết ngân sách token trong ngày, widget hiện "Daily limit reached, please try again later" (chuỗi mới budgetExceeded) và khoá ô nhập thay vì hiện nút Retry vốn sẽ lỗi tiếp. Xem Widget.
• Knowledge base — mỗi tổ chức xử lý tối đa 2 tài liệu cùng lúc (dùng chung với các việc chạy nền khác); chat được ưu tiên trước việc xử lý tài liệu.

2026-10-01Sao chép liên kết

• Run & Trace — trace của một run đã kết thúc bị xoá nội dung từng bước (prompt gửi cho model, các lượt gọi tool và kết quả của chúng) sau khi cũ hơn số ngày lưu trữ của tổ chức bạn (mặc định 30 ngày, nhà vận hành đặt được). Trạng thái, thời lượng, số vòng lặp, tổng số token, nội dung đầu vào và câu trả lời cuối cùng vẫn còn; một trace đã xoá hiển thị Content not retained. Hội thoại và số liệu sử dụng không bị ảnh hưởng. Trang Sử dụng & Hạn mức giờ hiện Retention (số ngày, hoặc Kept forever). Xem Run & Trace.
• Knowledge base — menu của tài liệu giờ có Retry (cho tài liệu failed) và Re-ingest (cho tài liệu completed): cả hai xử lý lại từ file gốc, không cần tải lại, danh sách tự cập nhật. Xem Knowledge base.
• Connector — tắt và bật lại connector bằng Deactivate / Activate trong menu của nó. Connector chưa được lấy danh sách tool hiện — thay vì 0 tool. Dialog cao hơn màn hình giờ cuộn được, nên danh sách tool dài trong Add connector dùng được trọn vẹn trên laptop.

2026-09-30Sao chép liên kết

• Connector — tự thêm MCP server từ xa trên console ở mục Connectors: đăng nhập OAuth trong cửa sổ popup, hoặc dùng client credentials, header, hay không xác thực; xem tool của từng server; chọn cho từng agent, ở tab Tools, những tool nào được dùng (mặc định bật hết). Quyền đăng nhập bị thu hồi hiện Needs reconnect và Reconnect chỉ một cú bấm. Xem Connector.
• Tài liệu — trang tài liệu này, bằng tiếng Việt và tiếng Anh, tại harnix.vn/docs.
• Widget — nút launcher giờ là nút bật/tắt: vẫn hiện khi khung chat mở, đổi sang biểu tượng đóng, bấm lần nữa để đóng chat. Nút đóng trên header hoạt động lại, và biểu tượng launcher không còn bị méo.
• Console quản trị — nút Revoke ở trang API keys nằm gọn trong bảng; hộp thông tin căn chữ giữa theo chiều dọc; trang knowledge base không còn hiện thông báo cũ nói rằng tài liệu tải lên chưa được xử lý. Trang của mỗi agent giờ có tab Usage thật (ngân sách hôm nay, rồi báo cáo sử dụng chỉ tính riêng agent đó) thay cho placeholder trước đây.
• Đăng nhập — tab trình duyệt hiện "Harnix", và trang "Complete your profile" (hỏi một lần khi tài khoản chưa có tên) có giao diện giống các trang đăng nhập khác.

v0.1.0-beta — 2026-09-29Sao chép liên kết

Phiên bản beta đầu tiên, đang chạy thật.

• Agent — cấu hình provider/model (Ollama, OpenAI và endpoint tương thích OpenAI), system prompt, cửa sổ lịch sử, bật/tắt, ngân sách token hằng ngày theo agent.
• Knowledge base — tải tài liệu PDF/DOCX/TXT/Markdown (tối đa 20 MB), tra cứu ngữ nghĩa tự động (knowledge_search) khi agent có knowledge base, câu trả lời kèm trích dẫn nguồn.
• MCP server — đăng ký server ngoài để agent gọi tool, mã hoá header tại chỗ, kiểm tra kết nối, gán theo agent.
• Widget <harnix-chat> — nhúng bằng một dòng script, chế độ bubble hoặc inline, theme sáng/tối, tuỳ biến màu và nhãn hiển thị (kể cả dịch sang tiếng Việt).
• Tích hợp — đổi token ẩn danh hoặc đã ký, gọi trực tiếp /v2/chat từ backend, streaming câu trả lời qua SSE, huỷ run đang chạy, lịch sử hội thoại.
• Console quản trị — Tổng quan, Run & Trace theo từng bước, Hội thoại & End-user (chặn/bỏ chặn/xoá), Sử dụng & Hạn mức, API key, Thành viên & vai trò, trang Tích hợp.
• Giới hạn & cô lập — rate limit theo end-user và theo API key, ngân sách token hằng ngày cho tổ chức và cho từng agent, cô lập dữ liệu đầy đủ giữa các tổ chức và giữa các end-user.