Dạy trợ lý AI

Tổng quan hướng dẫn

Đối tượng: Quản trị viên hệ thống quyết định trợ lý biết gì và hoạt động ra sao.

Thời gian đọc: khoảng 15 phút.

Kết quả: Một tài liệu được lập chỉ mục và Sẵn sàng cho trợ lý, bạn biết ai tìm được nó và một đoạn trích phải gần câu hỏi đến mức nào, một website được đặt để thu thập, bạn biết các kỹ năng nằm ở đâu, và bạn chỉnh được sứ mệnh và hành vi của trợ lý.

Trợ lý trả lời từ dữ liệu mà một người được phép đọc. Bạn mở rộng những gì trợ lý có thể dựa vào bằng nguồn tri thức (tài liệu, trang web, bản ghi âm và văn bản nhập tay), giữ website luôn mới bằng lượt thu thập website, và định hình cách trợ lý làm việc qua kỹ năng và các thiết lập của chính trợ lý.

Trước khi bắt đầu

Bạn cần	Lý do
Quyền truy cập Thiết lập (quản trị viên hệ thống)	Nguồn tri thức là menu của quản trị viên hệ thống, và chỉ quản trị viên hệ thống mới sửa được một trợ lý, một kỹ năng hay một gói kỹ năng. Quản trị viên AI thấy danh sách kỹ năng và gói kỹ năng nhưng không đổi được.
Một kết nối embedding	Việc lập chỉ mục biến văn bản thành các đoạn tìm kiếm được qua Kết nối AI cho embedding của AI ‣ Cấu hình ‣ Thiết lập. Kết nối Viindoo dựng sẵn đáp ứng việc này (xem Kết nối nhà cung cấp AI và chọn nơi đặt dữ liệu).

Thêm một nguồn tri thức

Nguồn tri thức là một tài liệu, trang web hoặc bản ghi âm mà trợ lý có thể dùng để trả lời.

1. Vào AI ‣ Cấu hình ‣ Nguồn tri thức. Mỗi dòng cho biết Tên nguồn, Loại nguồn, Trạng thái và Công ty.

2. Bấm Mới và gõ Tên nguồn.

3. Chọn Loại nguồn: Tệp PDF, Trang web, Văn bản nhập tay, Hình ảnh (OCR), PDF (OCR) hoặc Âm thanh (bản ghi lời). Sau đó cung cấp nội dung: tệp, địa chỉ trang web hoặc Nội dung văn bản.

4. Chọn Làm sạch văn bản: Không làm sạch (giữ nguyên bản gốc) hoặc Cơ bản (làm sạch). Đặt Giới hạn theo nhóm người dùng khi chỉ một số người được thấy các câu trả lời lấy từ nguồn này.

5. Bấm Lưu. Thanh trạng thái bắt đầu ở Dự thảo (chưa lập chỉ mục). Một tác vụ định kỳ tên AI: Process Pending Sources nhận nguồn đó ở nền (chạy năm phút một lần), chuyển nó sang Đang xử lý (đang chia đoạn + sinh embedding) rồi sang Sẵn sàng (đã có thể tìm kiếm). Số đoạn cho biết số đoạn đã được lập chỉ mục.

6. Khi một nguồn dừng ở Lỗi, hãy đọc lý do trong mục Lỗi và khắc phục nguyên nhân, ví dụ sửa địa chỉ hoặc dùng tệp đọc được. Sau đó mở trợ lý trong AI ‣ Trợ lý AI, vào tab Nguồn tri thức và bấm Thử lại các nguồn bị lỗi.

Chọn ai tìm được một nguồn tri thức

Trợ lý tìm trong tri thức của bạn theo ý nghĩa bằng công cụ Tìm tri thức. Nó tìm trong mọi nguồn tri thức mà người đặt câu hỏi được phép đọc, thuộc mọi loại, và trả về đoạn gần nhất của từng bản ghi. Nó cũng có thể thu hẹp việc tìm vào một loại bản ghi, chẳng hạn các trang của một không gian.

Một nguồn mà một người được phép đọc thì mọi trợ lý trả lời người đó đều tìm được, kể cả nguồn bạn đã đính kèm vào một trợ lý trong tab Nguồn tri thức của nó. Đính kèm một nguồn không làm nó riêng tư cho trợ lý đó. Để giữ một nguồn riêng tư, hãy đặt Giới hạn theo nhóm người dùng trên nguồn: chỉ thành viên của các nhóm đó tìm được nó, dù họ hỏi trợ lý nào.

Công cụ này thuộc chủ đề Data Questions của Viindoo AI Assistant.

1. Vào AI ‣ Trợ lý AI, mở trợ lý và vào tab Chủ đề.

2. Bấm chủ đề Data Questions. Trong hộp thoại, cuộn tới Hành động mà chủ đề này nói tới: Tìm tri thức nằm cạnh các công cụ khác của chủ đề.

Mọi người dùng nội bộ đọc được một chủ đề; quản trị viên hệ thống thay đổi nó. Xoá Tìm tri thức khỏi danh sách sẽ khiến các trợ lý mang chủ đề này không còn tìm tri thức theo ý nghĩa, và Thêm một dòng đặt nó lại.

Đặt độ gần của một đoạn trích

Hai thiết lập quyết định đoạn trích nào của tri thức được dùng để trả lời một câu hỏi. Ngưỡng sàn độ liên quan, đặt trên model embedding, là điểm mà dưới mức đó một đoạn trích không có ý nghĩa gì; mọi lượt tìm tri thức đều bỏ qua các đoạn như vậy, dù trợ lý nào hỏi (xem Ngưỡng sàn độ liên quan của model embedding). Độ liên quan tối thiểu, đặt trên từng trợ lý, cho biết một đoạn trích phải liên quan hơn ngưỡng sàn đó bao nhiêu.

Độ liên quan tối thiểu được tính phía trên ngưỡng sàn: 0 giữ mọi đoạn nằm trên ngưỡng sàn, và 1 chỉ giữ văn bản giống hệt. Giá trị nhỏ hơn 0 hoặc lớn hơn 1 bị từ chối khi bạn lưu. Muốn nhận nhiều đoạn hơn mức 0, hãy hạ ngưỡng sàn trên model embedding. Việc tìm theo từ ngữ không bao giờ bị nó giới hạn.

1. Vào AI ‣ Trợ lý AI và mở trợ lý.

2. Trong phần Hành vi, đặt Độ liên quan tối thiểu và bấm Lưu. Trỏ vào dấu hỏi cạnh trường để đọc phần trợ giúp.

Vì mỗi người được đọc những tài liệu khác nhau, hai người có thể nhận câu trả lời khác nhau, hoặc một người nhận câu trả lời có căn cứ còn người kia nhận lời từ chối. Điều đó là bình thường.

Sau khi cập nhật Viindoo AI

Khi Viindoo AI được cập nhật trên cơ sở dữ liệu đã dùng nó, bản cập nhật chỉnh các thiết lập sau để câu trả lời giữ nguyên như cũ:

• Ngưỡng sàn độ liên quan của model embedding Viindoo đi kèm được đặt là 0,35.

• Độ liên quan tối thiểu của mọi trợ lý được quy đổi sang thang tính phía trên ngưỡng sàn, để các đoạn trích đang bị ẩn vẫn bị ẩn. Giá trị bằng hoặc thấp hơn ngưỡng sàn trở thành 0; ví dụ 0,6 trở thành 0,38. Không có gì bị quy đổi lần thứ hai.

• Tìm tri thức được thêm vào chủ đề Data Questions khi chủ đề vẫn có đúng các công cụ lúc phát hành. Chủ đề mà bạn đã đổi công cụ được giữ nguyên như bạn đặt: hãy thêm công cụ bằng Thêm một dòng như mô tả ở trên.

• Bản dịch của module được nạp lại từ danh mục đi kèm. Bản dịch của một thuật ngữ Viindoo AI mà quản trị viên đã sửa tay sẽ bị thay bằng bản dịch đi kèm: hãy sửa lại sau khi cập nhật nếu bạn muốn dùng cách diễn đạt của mình.

Giữ website luôn mới

1. Vào AI ‣ Hoạt động ‣ Các lượt thu thập website và bấm Mới.

2. Gõ Tên lượt thu thập và Mẫu URL, mỗi mẫu một dòng. Dấu * khớp với mọi văn bản, nên một mẫu bao trùm cả một website; một địa chỉ thường chỉ được lấy riêng nó.

3. Đặt Thu thập lại mỗi (ngày) (mặc định 7), và Giới hạn theo nhóm người dùng nếu cần. Để Hiệu lực bật.

4. Bấm Lưu. Lần thu thập gần nhất và Trạng thái lượt thu thập gần nhất được điền khi một lượt thu thập đã chạy, và các trang tìm được được liệt kê dưới Các trang đã thu thập.

Bản thân bộ thu thập web được thiết lập trong AI ‣ Cấu hình ‣ Thiết lập, mục Tri thức: URL Firecrawl (để trống để dùng mặc định) và Khoá API Firecrawl.

Ghi chú

Mọi người dùng nội bộ đều mở được Các lượt thu thập website và đọc các quy tắc. Quản trị viên hệ thống hoặc người dùng có quyền Quản lý nội dung AI mới sửa được.

Xem và quản lý kỹ năng

Kỹ năng là một bộ chỉ dẫn mà trợ lý nạp khi một công việc cần đến, ví dụ một bản tóm lược tiếp thị hoặc danh mục kiểm tra chốt tháng. Các kỹ năng được chia theo gói.

1. Vào AI ‣ Cấu hình ‣ Gói kỹ năng AI. Mỗi gói cho biết Mã kỹ thuật, Tên gói, Phiên bản và Nhà cung cấp.

2. Mở một gói để xem các kỹ năng nó mang theo trong Kỹ năng.

3. Vào AI ‣ Cấu hình ‣ Kỹ năng AI để tìm trong mọi kỹ năng, với Mã kỹ thuật, Tên kỹ năng, Phiên bản, Gói kỹ năng và Công ty. Dùng các bộ lọc Toàn cục và Đã lưu trữ và cách gom theo gói để thu hẹp danh sách.

4. Mở một kỹ năng để đọc chỉ dẫn của nó. Bỏ đánh dấu Hiệu lực để ngừng một kỹ năng mà không xoá nó.

Thiết lập một trợ lý

1. Vào AI ‣ Trợ lý AI và mở trợ lý.

2. Viết trợ lý dùng để làm gì trong Vai trò và Sứ mệnh, trong một hai câu. Các trợ lý khác đọc nó để quyết định có giao việc cho trợ lý này hay không. System prompt ở phía dưới biểu mẫu cho biết trợ lý hành xử thế nào.

3. Chọn Dòng model ưu tiên hoặc Model AI ưu tiên, Mức suy luận, và bỏ đánh dấu Thu thập phản hồi của người dùng nếu mọi người không nên thấy các nút hài lòng, không hài lòng và gắn cờ dưới câu trả lời.

4. Trong Hành vi, đánh dấu Chỉ trả lời từ nguồn đính kèm cho trợ lý không được dùng kiến thức chung, rồi đính kèm nguồn trong tab Nguồn tri thức. Số đoạn trích cho mỗi câu trả lời và Độ liên quan tối thiểu chỉnh số đoạn trích được lấy vào và độ gần của chúng với câu hỏi (xem Đặt độ gần của một đoạn trích). Giới hạn chi phí mỗi lượt chạy (USD) dừng một lượt chạy khi đạt giới hạn.

5. Dùng các tab Chủ đề, Nguồn tri thức, Công cụ Ngoài và Kỹ năng cho phần còn lại, rồi bấm Lưu. Nút Trace liệt kê các lượt chạy của trợ lý này.

Ghi chú

Ai cũng đọc được danh sách trợ lý, nhưng chỉ quản trị viên hệ thống đổi được một trợ lý. Hãy để nguyên Nhiệt độ và Số token tối đa ở mặc định, trừ khi tài liệu của nhà cung cấp AI bảo bạn làm khác.

Điểm kiểm tra thành công

• Một nguồn văn bản nhập tay hiện Sẵn sàng (đã có thể tìm kiếm) và Số đoạn lớn hơn không.

• Chủ đề Data Questions liệt kê Tìm tri thức, và Độ liên quan tối thiểu có giá trị từ 0 đến 1.

• Quy tắc thu thập website đã được lưu, đang hiệu lực và hiện lịch của nó.

• Bạn tìm thấy gói và kỹ năng mong đợi, và trợ lý giữ sứ mệnh mới sau khi bạn lưu.

Các vấn đề thường gặp

Vấn đề	Cách xử lý
Một nguồn ở lại Dự thảo (chưa lập chỉ mục) vài phút.	Tác vụ định kỳ chạy năm phút một lần. Hãy chờ lần chạy kế tiếp.
Một nguồn dừng ở Lỗi.	Đọc mục Lỗi, khắc phục nguyên nhân, rồi bấm Thử lại các nguồn bị lỗi trên trợ lý.
Một câu hỏi mà tài liệu của bạn có đề cập lại được trả lời bằng thẻ Không có gì khớp.	Hạ Độ liên quan tối thiểu xuống 0, rồi hạ Ngưỡng sàn độ liên quan của model embedding (xem Cấu hình nâng cao). Kiểm tra người hỏi có được đọc nguồn đó không: một nguồn giới hạn theo nhóm người dùng bị ẩn với mọi người khác.
Tìm tri thức không có trong chủ đề Data Questions.	Chủ đề mà công cụ đã bị đổi được giữ nguyên như đã đặt. Hãy thêm công cụ bằng Thêm một dòng trong hộp thoại chủ đề.
Bạn không thấy Nguồn tri thức trong menu.	Menu này chỉ dành cho quản trị viên hệ thống.
Bạn không sửa được một kỹ năng hay một trợ lý.	Chỉ quản trị viên hệ thống làm được. Quản trị viên AI đọc được các danh sách này.

Các bước tiếp theo

• Công cụ ngoài và phản hồi - kết nối máy chủ công cụ ngoài và xem mọi người đánh giá câu trả lời ra sao.

• Cấu hình nâng cao - các danh mục kỹ thuật, và khi nào nên để yên.