Trợ lý AI

Trợ lý AI cho phép bạn mô tả công việc bằng ngôn ngữ thường và để TikMatrix xếp hàng giúp bạn. Nó đọc thiết bị, tài khoản và lịch sử tác vụ của bạn, cho bạn xem chính xác những gì nó sẽ tạo, rồi chờ bạn phê duyệt trước khi ghi bất cứ thứ gì.

Cần gói Pro

Trợ lý khả dụng từ gói Pro trở lên, cùng yêu cầu với API tự động hóa cục bộ.

Nó là gì (và không phải là gì)

Trợ lý không chạm trực tiếp vào điện thoại của bạn. Nó làm việc giống như bạn: xem bạn đang có gì, rồi xếp tác vụ vào hàng đợi, và bộ chạy tác vụ thông thường sẽ nhận về thực thi. Mọi thứ nó tạo ra đều xuất hiện trong danh sách tác vụ như bao tác vụ khác, gắn nhãn nguồn assistant.

Nó cũng không thể tự ghi bất cứ thứ gì. Mọi hành động làm thay đổi trạng thái đều dừng cuộc trò chuyện lại và hỏi bạn trước — xem Không gì chạy mà không có phê duyệt của bạn.

Thiết lập

Mô hình do bạn tự cung cấp. TikMatrix không kèm theo mô hình nào và không chuyển tiếp yêu cầu của bạn — ứng dụng nói chuyện trực tiếp từ máy của bạn tới endpoint bạn cấu hình.

1. Bấm Trợ lý ở thanh điều hướng bên trái.
2. Bấm Cài đặt mô hình.
3. Điền:

Trường	Điền gì
Endpoint	URL chat-completions đầy đủ, ví dụ https://api.openai.com/v1/chat/completions
Mô hình	Id mô hình, ví dụ gpt-4o hoặc claude-sonnet-4-5
Khóa API	Khóa của bạn cho nhà cung cấp đó
Định dạng API	Cứ để ở Tự nhận từ endpoint trừ khi nó đoán sai
Giới hạn tác vụ mỗi lần xác nhận	Số tác vụ tối đa mà một lần phê duyệt được tạo (mặc định 200)

4. Bấm Lưu.

Khi cài đặt được chấp nhận, dòng trạng thái ở đầu bảng sẽ hiển thị mô hình đang dùng, nên bạn biết ngay cuộc trò chuyện sẽ đi tới endpoint nào.

Những endpoint nào dùng được

Hỗ trợ hai định dạng giao tiếp:

• Tương thích OpenAI — mọi endpoint nói POST /v1/chat/completions. Bao gồm chính OpenAI và hầu hết máy chủ tự vận hành: vLLM, LocalAI, lớp tương thích OpenAI của Ollama, DeepSeek, OpenRouter và tương tự.
• Anthropic — các endpoint nói POST /v1/messages.

Định dạng API thường để ở Tự nhận từ endpoint: URL chứa api.anthropic.com hoặc /v1/messages được xem là Anthropic, còn lại là tương thích OpenAI. Chỉ đặt thủ công khi bạn dùng một proxy mà URL không tiết lộ định dạng.

Chọn mô hình biết gọi công cụ

Trợ lý hoạt động hoàn toàn thông qua việc gọi công cụ. Một mô hình không hỗ trợ công cụ đáng tin cậy sẽ trò chuyện với bạn nhưng chẳng bao giờ lập nổi kế hoạch.

Cách chọn mô hình

Nếu bạn muốn	Hãy dùng
Lập kế hoạch đáng tin nhất, ít phải trông chừng nhất	Mô hình đầu bảng hiện tại của OpenAI hoặc Anthropic
Chi phí thấp hơn cho việc thường ngày kiểu "xếp cái này cho cả giàn máy"	Mô hình tầm trung của chính các nhà cung cấp đó
Không có gì rời khỏi máy của bạn	Máy chủ cục bộ (Ollama, vLLM, LocalAI) với mô hình gọi công cụ vững

Mô hình cục bộ nhỏ là nguyên nhân phổ biến của cảnh "nó trò chuyện nhưng không bao giờ lập kế hoạch". Trước khi kết luận trợ lý bị hỏng, hãy thử đúng yêu cầu đó một lần với mô hình lưu trữ trên đám mây — nếu ở đó chạy được thì vấn đề nằm ở mô hình, không phải cấu hình.

Cài đặt được lưu ở đâu

Endpoint và khóa của bạn được ghi vào assistant_settings.json trong thư mục dữ liệu của ứng dụng, và backend đọc chúng khi gửi yêu cầu. Chúng không được gửi đi đâu ngoài endpoint bạn đã cấu hình.

Có một cài đặt chỉ tồn tại trong tệp đó: max_tokens, tức ngân sách độ dài câu trả lời gửi cho mô hình. Mặc định là 8192 và bị giới hạn trong khoảng 1024–64000. Hãy tăng thủ công nếu câu trả lời dài bị cắt.

Yêu cầu công việc

Viết điều bạn muốn bằng ngôn ngữ thường. Vài ví dụ:

• Nuôi tất cả tài khoản trong 20 phút
• Vì sao các tác vụ gần đây của tôi thất bại?
• Đăng bài trên mọi thiết bị vào 09:00 ngày mai
• Theo dõi năm tài khoản này từ điện thoại trong nhóm Marketing

Một yêu cầu thường đi qua ba bước:

1. Nó tra cứu. Thiết bị nào trực tuyến, tài khoản nào đang đăng nhập, script nhận những tham số gì.
2. Nó lập kế hoạch. Nó tính chính xác yêu cầu sẽ sinh ra bao nhiêu tác vụ, rồi cho bạn xem tổng — bao nhiêu tác vụ, trên bao nhiêu thiết bị và tài khoản.
3. Bạn xác nhận. Chỉ khi đó tác vụ mới được ghi.

Nếu một yêu cầu mơ hồ theo cách làm thay đổi số tác vụ được tạo, trợ lý sẽ hỏi thay vì đoán.

Một yêu cầu từ đầu đến cuối trông ra sao

Bạn: nuôi tất cả tài khoản đang đăng nhập trong 20 phút, bắt đầu 9 giờ sáng mai

Trợ lý: (gọi get_script_schema, list_devices, list_accounts, rồi plan_tasks) 34 tác vụ nuôi tài khoản trên 12 thiết bị và 34 tài khoản, mỗi tác vụ 20 phút, bắt đầu 2026-08-27 09:00. Hai tài khoản chưa đăng nhập nên đã bị loại ra.

Một thẻ xác nhận hiện ra, liệt kê từng dòng nó sắp tạo — thiết bị, tài khoản, và mục tiêu nếu script có nhận — cùng với script_config chính xác sẽ được ghi. Bạn bấm Xác nhận, và 34 tác vụ xuất hiện trong danh sách.

Nói rõ thời điểm

Tác vụ có thể được xếp hàng để chạy sau: chỉ cần nhắc tới một mốc giờ và trợ lý sẽ đưa nó vào kế hoạch làm thời điểm bắt đầu tác vụ, và thẻ xác nhận sẽ hiển thị trước khi bạn phê duyệt. Đây cũng là câu trả lời đúng khi yêu cầu quá lớn — trải lượt theo dõi của cả giàn máy ra suốt một ngày trông ít máy móc hơn nhiều so với bắn hết một lượt, và trợ lý sẽ tự đề xuất điều đó với những yêu cầu trông có vẻ rủi ro.

Trên các bản dựng chạy cả hai ứng dụng

Bản dựng TikMatrix được cấu hình cho cả TikTok lẫn Instagram sẽ không đoán bạn muốn cái nào, và cũng không thử đoán — yêu cầu không nêu nền tảng sẽ được hỏi lại. Hãy nói "đăng bài trên TikTok cho nhóm Marketing" thay vì "đăng bài cho nhóm Marketing", nó sẽ vào thẳng bước lập kế hoạch. Bản dựng một nền tảng không bao giờ hỏi.

Không gì chạy mà không có phê duyệt của bạn

Điều này được cưỡng chế trong mã nguồn, không phải bằng cách nhờ vả mô hình cho lịch sự.

Khi trợ lý với tay tới bất cứ thứ gì làm thay đổi trạng thái, cuộc trò chuyện dừng lại và một thẻ xác nhận hiện ra cho thấy điều sắp xảy ra. Lời gọi chỉ chạy sau khi bạn bấm nút xác nhận.

Bốn hành động được chặn theo cách này:

Hành động	Làm gì
create_tasks	Xếp các tác vụ đã lập kế hoạch vào hàng đợi
stop_task	Dừng một tác vụ đang chạy
retry_task	Xếp lại một tác vụ đã thất bại
create_custom_script	Ghi và đăng ký một tệp script mới

Việc tạo tác vụ còn có thêm một lớp khóa nữa: nút xác nhận chỉ có thể thực thi đúng kế hoạch đã được cho bạn xem. Trợ lý không thể sửa tham số giữa lúc xem trước và lúc bạn phê duyệt — một kế hoạch chỉ dùng một lần và hết hạn sau 15 phút, nên bản xem trước bạn bỏ dở không thể được xác nhận về sau với danh sách thiết bị đã thay đổi.

Thẻ đó cũng không phải bản tóm tắt do mô hình viết. Nó hiển thị đúng các dòng thật của kế hoạch và script_config thật, nên thứ bạn phê duyệt chính là thứ được ghi.

Từ chối là một câu trả lời bình thường, không phải lỗi: mô hình được cho biết là bạn đã từ chối, và có thể đề xuất phương án khác thay vì thử lại đúng lời gọi cũ.

Trần số lượng tác vụ

Một lần xác nhận được tạo tối đa 200 tác vụ theo mặc định. Đây là cái phanh phòng khi yêu cầu bị hiểu sai — để "nuôi các tài khoản của tôi" không biến thành cả ngàn tác vụ mà sáng ra bạn mới phát hiện. Các đợt lớn hơn vẫn khả thi: trợ lý chia chúng thành từng lô để bạn xác nhận lần lượt.

Bạn đổi giới hạn ở Cài đặt mô hình → Giới hạn tác vụ mỗi lần xác nhận. Giá trị trên 2000 sẽ bị cắt về 2000.

Trợ lý nhìn thấy được những gì

Những công cụ này nó dùng thoải mái, không cần hỏi:

Công cụ	Đọc gì
list_devices	Thiết bị đang kết nối, trực tuyến hay đang bận, thuộc nhóm nào
list_accounts	Tài khoản, thiết bị của từng tài khoản, và trạng thái đăng nhập
list_groups	Nhóm thiết bị và quy mô từng nhóm
get_script_schema	Mọi script bản dựng này chạy được cùng tham số chính xác
list_tasks	Danh sách tác vụ, lọc theo trạng thái, thiết bị hoặc script
get_task_log	Nhật ký của một tác vụ — nơi lỗi thường tự giải thích
get_activity_log	Hoạt động tài khoản gần đây
device_screenshot	Màn hình một thiết bị đang hiển thị gì lúc này
list_custom_scripts	Các script tùy chỉnh bạn đã đăng ký
get_custom_script_guide	Cách viết một script tùy chỉnh
plan_tasks	Tính xem một yêu cầu sẽ tạo ra gì, mà không tạo thật

Ảnh chụp màn hình được gửi tới nhà cung cấp mô hình của bạn

device_screenshot gửi ảnh màn hình điện thoại tới endpoint bạn đã cấu hình. Nếu một màn hình có thể hiển thị thứ bạn không muốn gửi cho bên thứ ba, hãy tránh yêu cầu ảnh chụp, hoặc trỏ trợ lý tới mô hình bạn tự vận hành.

Những gì rời khỏi máy của bạn

Mọi thứ trợ lý đọc đều được gửi tới endpoint mô hình của bạn như một phần của cuộc trò chuyện — đó là cách mô hình nhìn thấy chúng. Trên thực tế điều đó nghĩa là số sê-ri thiết bị và tên nhóm, tên người dùng của tài khoản và trạng thái đăng nhập, các dòng tác vụ và nhật ký tác vụ, cùng bất kỳ ảnh chụp màn hình nào bạn yêu cầu. Khóa API, thông tin đăng nhập proxy và mật khẩu tài khoản không nằm trong những thứ nó đọc được, nên chúng không bao giờ có trong dữ liệu gửi đi.

Nếu danh sách đó nhiều hơn mức bạn muốn giao cho bên thứ ba, hãy trỏ endpoint tới một mô hình do chính bạn chạy; mọi phần khác của tính năng không thay đổi.

Viết script tùy chỉnh

Nếu không script tích hợp nào đáp ứng được nhu cầu của bạn, trợ lý có thể viết một cái. Hãy mô tả công việc bằng ngôn ngữ thường; nó sẽ đọc hướng dẫn viết script, soạn chương trình, rồi đưa bạn xem.

Thẻ xác nhận của bước này nói rõ điều đó: script sẽ được ghi lên đĩa và đăng ký để có thể chạy như bất kỳ script tích hợp nào. Hãy đọc nó trước khi phê duyệt. Các script nằm trong thư mục assistant_scripts thuộc thư mục dữ liệu của ứng dụng, nên bạn có thể kiểm tra, sửa hoặc xóa mọi thứ nó đã viết ở cùng một chỗ.

Vài giới hạn mà ứng dụng áp lên bất cứ đề xuất nào của mô hình:

• Chỉ python, python3, node, bun và deno được đăng ký làm trình thông dịch — không có thứ gì mở shell rồi gắn payload phía sau.
• Tên tệp phải là tên thuần: không dấu phân cách đường dẫn, không .., không bắt đầu bằng dấu chấm, tối đa 64 ký tự.
• Mã nguồn giới hạn 200 KB, và nền tảng phải là generic, tiktok hoặc instagram.

Từ đó trở đi, script đã đăng ký là một script tùy chỉnh bình thường: bạn mở nó ở Thiết bị → Script tùy chỉnh, sửa lệnh, đổi thời gian chờ, hoặc tắt nó. Xem Script tùy chỉnh để biết một script làm được gì sau khi đăng ký.

Những giới hạn đáng biết

• Một yêu cầu, mười hai bước. Nếu sau mười hai lần gọi công cụ mà chưa xong, trợ lý dừng lại và báo cáo phần còn dang dở, thay vì đốt token của bạn trong một vòng lặp.
• Cuộc trò chuyện không phải kho lưu trữ. Nó nằm trong bộ nhớ — tám cuộc trò chuyện gần nhất, và 120 lượt cuối của mỗi cuộc — và mất đi khi khởi động lại ứng dụng. Thứ đáng giữ rốt cuộc sẽ thành tác vụ, và tác vụ nằm trong cơ sở dữ liệu.
• Chuyển sang màn hình khác là an toàn. Luồng trò chuyện và mọi xác nhận còn treo sẽ được khôi phục khi bạn quay lại.
• Dừng kết thúc vòng lặp ở điểm kiểm tra kế tiếp. Nó không thể ngắt một lời gọi mô hình đã bay đi, nên bước hiện tại phải xong trước.
• Token do bạn trả. Mỗi yêu cầu đều mang theo danh mục script và toàn bộ cuộc trò chuyện tới thời điểm đó, nên một luồng dài tốn hơn tính trên mỗi tin nhắn so với luồng mới. Với công việc không liên quan, bắt đầu cuộc trò chuyện mới rẻ hơn là tiếp tục cuộc cũ.

Khắc phục sự cố

API access requires Pro or higher plan Giấy phép của bạn là Starter hoặc không hoạt động. Kiểm tra Cài đặt → Giấy phép.

The app is still starting up. Try again in a moment. Bảng được mở trước khi các dịch vụ nền khởi động xong. Chờ vài giây rồi gửi lại.

No model endpoint configured / No API key configured / No model configured Mở Cài đặt mô hình và điền đủ cả ba: endpoint, mô hình và khóa API.

Could not reach the model endpoint Ứng dụng không mở được kết nối. Kiểm tra URL, và kiểm tra xem endpoint cục bộ có thực sự đang lắng nghe trên cổng đó không.

Mô hình trả lời nhưng không bao giờ lập kế hoạch Nhiều khả năng nó không gọi công cụ. Thử một mô hình hỗ trợ gọi công cụ tốt, và kiểm tra xem Định dạng API có khớp với định dạng của endpoint không.

Câu trả lời nào cũng bị cắt ngang Một số máy chủ tương thích OpenAI đặt giới hạn đầu ra rất thấp theo mặc định. Hãy nâng giới hạn ở máy chủ, hoặc tăng max_tokens trong assistant_settings.json.

Nó cứ hỏi mãi về nền tảng Bản dựng này chạy cả TikTok lẫn Instagram. Hãy nêu rõ nền tảng bạn muốn ngay trong yêu cầu.

Thẻ xác nhận không xác nhận được Kế hoạch hết hạn sau 15 phút. Hãy yêu cầu lại đúng điều đó để nhận kế hoạch mới.

Tác vụ được tạo nhưng không có gì chạy Nhiều khả năng Auto WakeUp Agent đang tắt — trợ lý cảnh báo điều này trước khi bạn xác nhận. Hãy bật lại ở Cài đặt.

Bước tiếp theo

• Script tùy chỉnh — viết và đăng ký tự động hóa mà script tích hợp không có
• Tổng quan API cục bộ — điều khiển chính hàng đợi tác vụ đó từ chương trình của bạn
• Cài đặt tác vụ — tác vụ đã xếp hàng được nhận và chạy như thế nào