Cuộc trò chuyện với AI

Khi bạn gửi prompt, KOPA mở session chat ở route /cowork/[sessionId]. Phần này giải thích từng yếu tố trong giao diện và cách bạn tương tác.

Anatomy session#

Session chia 3 vùng từ trên xuống:

• Header — title (sửa được), persona, model badge, biểu tượng trace.
• Message stream — tin nhắn của bạn, của AI, tool calls, hộp thoại HITL.
• Composer — như welcome screen, dùng để tiếp tục session.

Streaming response#

AI Agent stream từng từ ra màn hình. Khi đang nghĩ, có loader xoáy bên cạnh tin nhắn.

Bạn không cần đợi nó hoàn tất mới đọc — vừa stream vừa đọc giúp bạn phát hiện hiểu sai sớm và bấm Dừng nếu cần.

Tool calls#

AI Agent không nói khơi khơi. Khi cần dữ liệu thật, nó gọi tool. Trong stream, tool call hiện dưới dạng card nhỏ:

🔧 getBankTransactions
   account=VCB-1234, from=2024-03-01, to=2024-03-31
   → 142 giao dịch (chi tiết)

Bấm vào card để xem input + output đầy đủ dạng JSON.

Các tool phổ biến#

Tool	Tác dụng
getBankTransactions	Lấy giao dịch ngân hàng theo tài khoản + khoảng thời gian
getInvoices	Lấy hóa đơn theo loại + khoảng thời gian
lookupAccountBalance	Tra số dư tài khoản kế toán
proposeJournalEntry	Đề xuất bút toán (đẩy vào hàng đợi duyệt)
proposeTaxFiling	Đề xuất tờ khai thuế
runReportTemplate	Sinh báo cáo theo template
sendNotification	Gửi thông báo qua Telegram/Zalo/email
searchKnowledge	Tìm trong kho tri thức kế toán Việt Nam (chế độ kế toán doanh nghiệp, luật thuế)
lookupExchangeRate	Tỷ giá ngoại tệ theo VCB

Vì sao mỗi tool call quan trọng#

• Tool call ghi vào audit trail — sau này bạn có thể tra ngược "AI lấy số liệu này từ đâu".
• Tool call có rate limit — tránh gọi quá nhiều mất tiền API.
• Tool call có permission check — nếu user không có quyền đọc tài khoản đó, tool báo lỗi.

Trace panel#

Bấm icon 🔍 Trace ở header session để mở panel bên phải. Trace hiện toàn bộ chain:

[1] User input: "Đối chiếu sao kê VCB tháng 3..."
    └─ Token: 28
[2] Tool call: getBankAccount(name="Vietcombank")
    ├─ Latency: 142ms
    └─ Result: {id: "vcb-1234", balance: 1234567000}
[3] Tool call: getBankTransactions(account="vcb-1234", ...)
    ├─ Latency: 1.2s
    └─ Result: 142 transactions
[4] Tool call: getJournalEntries(account="112", ...)
    ├─ Latency: 0.3s
    └─ Result: 138 entries
[5] AI reasoning: 4 transactions chưa khớp...
[6] Tool call: proposeJournalEntry(...) x 4
    ├─ Latency: 1.8s tổng
    └─ 4 đề xuất đẩy vào hàng đợi duyệt
[7] AI response (streamed): "Tôi đã đối chiếu..."

Tổng: 3.4s, 4280 token

Trace là tool debug số một. Khi AI ra kết quả lạ, mở trace là sẽ biết.

Hộp thoại HITL (Human-in-the-loop)#

Khi AI muốn xác nhận điều có rủi ro, nó dừng stream và hiện hộp thoại:

⚠️ Cần xác nhận
Tôi định đề xuất bút toán Nợ TK 511 / Có TK 131 cho 4 giao dịch chưa khớp với tổng số tiền 23.5 triệu. Tài khoản 511 (Doanh thu bán hàng) đang được dùng đúng?

[✓ Tiếp tục] [✏ Sửa] [✕ Dừng]

• Tiếp tục — OK, AI đẩy đề xuất vào hàng đợi.
• Sửa — bạn nhập ghi chú điều chỉnh, AI suy nghĩ lại.
• Dừng — hủy session, không có đề xuất nào được tạo.

Mẹo: HITL bật sẵn cho các action có rủi ro: bút toán > 10tr, gửi email ra ngoài, tạo tờ khai. Bạn có thể tinh chỉnh trong Cài đặt → Workflow.

Tiếp tục session#

Sau khi AI trả lời xong, bạn có thể tiếp tục bằng cách gõ vào composer ở dưới. Session giữ ngữ cảnh, AI nhớ những gì đã trao đổi.

Ví dụ:

You: "Đối chiếu sao kê VCB tháng 3..."
AI: "Đã đối chiếu, có 4 giao dịch chưa khớp..."
You: "Mở giao dịch số 2."
AI: (tự hiểu bạn nói về giao dịch trong response trước)

Dừng session đang stream#

Bấm ■ Dừng trong header (chỉ hiện khi đang stream). AI dừng ngay, dữ liệu đã sinh ra được giữ.

Quản lý session#

Đặt tên session#

Mặc định KOPA đặt tên dựa trên prompt đầu. Bạn có thể bấm vào title để đổi tên thủ công. Tên này hiển thị trong sidebar và notification.

Xuất session#

Chuột phải trên session trong sidebar → Xuất → chọn:

• Markdown — tải file .md chứa toàn bộ trao đổi.
• PDF — phù hợp lưu trữ chính thức.
• Sao chép link — chia sẻ với đồng nghiệp trong cùng workspace.

Xóa session#

Chuột phải → Xóa. Đề xuất đã sinh ra không bị xóa — chỉ session UI bị xóa. Audit trail vẫn còn.

Sao chép session#

Chuột phải → Sao chép → tạo session mới với cùng prompt. Hữu ích khi bạn muốn chạy lại với một input hơi khác.

Tìm trong session cũ#

Trong sidebar, bấm icon 🔍 để tìm theo từ khóa trong title hoặc nội dung. KOPA index full-text các session 90 ngày gần nhất.

Tiếp theo#

Thông báo →