Chuyển đến nội dung chính
Knowledge base là tập hợp tài liệu của bạn (file hoặc trang web đã crawl) mà CloudThinker tìm kiếm khi trả lời. Chỉ cần thêm tài liệu tham khảo một lần, các câu trả lời trong chat và các cuộc điều tra sự cố sẽ dựa trên quy trình của chính bạn thay vì lời khuyên chung chung.

Cách hoạt động

  1. Bạn tạo knowledge base và thêm file hoặc URL của một website.
  2. CloudThinker lập chỉ mục từng tài liệu ở chế độ chạy nền. Mỗi tài liệu hiển thị một trạng thái: Pending, Processing, Completed hoặc Failed.
  3. CloudThinker dựa vào tiêu đề và mô tả của từng knowledge base để quyết định khi nào cần tìm, rồi tìm trong các tài liệu đã hoàn tất theo ý nghĩa, không theo từ khóa chính xác, và trả lời dựa trên các đoạn tìm được. Resolve cũng có thể dùng các đoạn này làm bằng chứng khi phân loại sự cố.
Mọi agent, dù có sẵn hay tùy chỉnh, đều tìm được trong mọi knowledge base của workspace, và mặc định tìm trong tất cả. Nêu tên một knowledge base trong yêu cầu để giới hạn tìm kiếm trong knowledge base đó. Nêu tên một knowledge base trong chỉ dẫn của custom agent sẽ định hướng agent tìm ở đó, nhưng không chặn các knowledge base khác. Knowledge base thuộc về một workspace. Mọi người trong workspace đều đọc và dùng được; agent ở workspace khác thì không. Hãy dùng knowledge base cho tài liệu tham khảo cần tra cứu, và dùng skill cho quy trình agent phải làm theo mọi lần. Xem khi nào nên dùng skill, hoặc Dạy CloudThinker để biết mọi nơi lưu ngữ cảnh của nhóm bạn.

Điều kiện tiên quyết

  • Vai trò Admin của workspace để tạo knowledge base, thêm hoặc xóa tài liệu. Developer xem được và đặt câu hỏi được. Viewer xem được nhưng không chat được. Xem vai trò.
Nếu Knowledge không có trong More → Workspace settings, module Knowledge Base đang bị tắt. Hãy nhờ bộ phận hỗ trợ CloudThinker bật lên, hoặc, nếu công ty bạn tự vận hành CloudThinker (tự host), hãy hỏi nhóm platform. Tắt module sẽ ẩn trang, ngừng nạp và tìm kiếm tài liệu mới, nhưng vẫn giữ các tài liệu đã lưu.

Tạo knowledge base

1

Mở Knowledge

Vào More → Workspace settings → Knowledge.
2

Nhấn Create KB

Create KB nằm bên phải thanh tìm kiếm và bộ lọc, phía trên danh sách. Hộp thoại Create Knowledge Base mở ra.
3

Điền thông tin và nhấn Create

Trạng thái thành công: knowledge base mới xuất hiện trong danh sách với 0 tài liệu.
Để đổi tiêu đề hoặc mô tả sau này, mở menu của hàng trong danh sách và nhấn Settings. Hãy giữ mô tả luôn cập nhật: CloudThinker dựa vào mô tả để quyết định khi nào cần tìm.

Thêm tài liệu

Mở knowledge base, nhấn Add Documents và chọn một tab.
  1. Kéo file vào vùng thả, hoặc nhấn vào vùng đó để chọn file.
  2. Nhấn Upload N files.
File CSV và bảng tính được chuyển thành bảng văn bản, rồi được tìm theo ý nghĩa như mọi tài liệu khác. File tải lên cũng được tính vào hạn mức lưu trữ của workspace.
Trạng thái thành công: mọi tài liệu trong danh sách đều hiển thị Completed. Chỉ tài liệu đã hoàn tất mới tìm kiếm được. File lớn và deep crawl mất nhiều thời gian hơn.

Hỏi đáp từ tài liệu của bạn

Hãy hỏi bằng ngôn ngữ tự nhiên. Hỏi về nội dung bạn cần, không hỏi theo tiêu đề tài liệu, vì CloudThinker tìm theo ý nghĩa. Nêu tên knowledge base khi bạn chỉ muốn tìm trong knowledge base đó:
Trạng thái thành công: phần hoạt động của agent hiển thị một bước Knowledge Base (tìm kiếm tài liệu), và câu trả lời bám theo các bước và cách diễn đạt trong tài liệu của bạn. Câu trả lời không kèm trích dẫn nội tuyến. Để kiểm tra câu trả lời dựa trên đâu, hãy mở rộng bước Knowledge Base trong phần hoạt động, hoặc hỏi “Which document did you use?”.

Giữ nội dung chính xác

  • Thay thế, đừng chồng thêm. Khi một runbook thay đổi, hãy xóa tài liệu cũ và tải tài liệu mới lên. CloudThinker không phân biệt được bản nào trong hai bản là bản hiện hành.
  • Dùng tiêu đề rõ ràng và các phần ngắn. Tìm kiếm trả về từng đoạn, nên một phần tập trung cho câu trả lời tốt hơn một khối chữ dài.
  • Bắt đầu nhỏ. Nạp mười tài liệu nhóm bạn mở nhiều nhất khi xử lý sự cố, rồi bổ sung dần khi có câu hỏi mới.
Để xóa một tài liệu, dùng Delete trên hàng của tài liệu. Các mục chỉ mục tìm kiếm của tài liệu bị xóa, nên tài liệu không còn tìm được ngay lập tức, và dung lượng của tài liệu được trừ khỏi hạn mức lưu trữ. Để xóa cả một knowledge base, dùng Delete trên hàng của knowledge base trong danh sách.
Xóa knowledge base sẽ xóa vĩnh viễn mọi tài liệu bên trong. Thao tác này không hoàn tác được.

Dữ liệu và quyền truy cập

  • Mọi người trong workspace đều đọc được mọi knowledge base. Đừng tải lên tài liệu chỉ một số thành viên được xem; hãy đặt các tài liệu đó trong một workspace riêng.
  • Không bao giờ tải secret lên. Giữ API token và password trong Credentials, nơi agent chỉ nhận được khi chạy lệnh.
  • Các đoạn tài liệu sẽ tới model. Các đoạn mà tìm kiếm trả về trở thành một phần của cuộc hội thoại, nên được gửi tới nhà cung cấp LLM của CloudThinker, hoặc tới nhà cung cấp của riêng bạn khi dùng BYOK. Với BYOK, lệnh gọi nào key của bạn không phục vụ được sẽ chuyển sang model của CloudThinker, nên các đoạn tài liệu vẫn có thể tới nhà cung cấp của CloudThinker. Xem Khi key ngừng hoạt động.
  • Khi cần đánh giá bảo mật, xem Bảo mật và tin cậy để biết CloudThinker lưu gì và bảo vệ dữ liệu ra sao.

Khắc phục sự cố

  • Kiểm tra trạng thái tài liệu. Chỉ tài liệu Completed mới tìm kiếm được.
  • Đặt câu hỏi cụ thể về nội dung, và nêu tên knowledge base để thu hẹp tìm kiếm.
  • Đảm bảo bạn đang chat trong workspace sở hữu knowledge base đó.
  • Viết mô tả cho knowledge base nói rõ bên trong có gì.
Xóa tài liệu và tải lên lại. Nếu vẫn thất bại, hãy xuất sang định dạng đơn giản hơn (ví dụ PDF hoặc TXT) rồi thử lại.
  • Mỗi file phải có dung lượng tối đa 10 MB, và tối đa 10 file mỗi lần tải.
  • Định dạng phải là một trong PDF, DOC, DOCX, TXT, MD, CSV, XLSX, XLS, ODS.
  • Thông báo “Storage quota exceeded. Cannot ingest more documents.” nghĩa là workspace đã hết dung lượng lưu trữ cho knowledge base. Hãy xóa các tài liệu không còn cần. Hạn mức do gói của bạn quyết định và không hiển thị trên trang Usage, nên muốn nâng hạn mức, hãy liên hệ bộ phận hỗ trợ CloudThinker.
  • Mở URL trong một cửa sổ trình duyệt ẩn danh. Nếu trang cần đăng nhập hoặc VPN, CloudThinker không truy cập được.
  • Một số site chặn crawler. Hãy thử một trang bắt đầu khác.
  • Tắt Deep Crawl và nhập thử một trang trước để xác nhận site đọc được.
Bạn cần vai trò Admin của workspace. Hãy nhờ admin của workspace thêm tài liệu hoặc đổi vai trò cho bạn.

Bước tiếp theo

Custom skill

Biến các quy tắc của nhóm thành chỉ dẫn mà agent làm theo.

Runbook

Để Resolve làm theo các quy trình sửa lỗi lưu trong Confluence, GitHub hoặc GitLab.