Nguồn kiến thức
Thêm hướng dẫn, bài viết và tệp cho AI, cập nhật chúng và kiểm tra tác nhân tìm được gì khi khách hỏi.
Trên trang này
Để tác nhân AI trả lời theo quy tắc của bạn, hãy thêm điều kiện giao hàng, khóa học, hướng dẫn hoặc bảng giá. Mỗi nhóm tài liệu là một nguồn kiến thức trong Cơ sở kiến thức → Nguồn.
Sau khi thêm, nền tảng lấy văn bản và chuẩn bị cho tìm kiếm, gọi là lập chỉ mục. Trong Kiểm tra tìm kiếm, nhập câu hỏi của khách và xem tác nhân nhận được đoạn nào. Ví dụ, «Có thể hoàn tiền không?» phải tìm ra điều kiện hoàn tiền của bạn.
Bạn còn phải chọn nguồn cho từng tác nhân trong Trả lời bằng AI. Chỉ có tệp hoặc bài trong tài khoản chưa cấp cho tác nhân quyền dùng. Website có thể tự cập nhật theo lịch; loại khác cập nhật khi thay đổi hoặc theo yêu cầu.
Loại nguồn
- Bài cơ sở kiến thức của bot: bài đã xuất bản là nguồn công khai, bài nội bộ chỉ cho tác nhân, bản nháp không cung cấp văn bản tìm kiếm.
- Website: các trang thuộc địa chỉ được phép, GetMyBot tự đọc.
- Tệp: PDF, Word, Excel, PowerPoint, văn bản, Markdown hoặc HTML đã tải lên.
- Hướng dẫn: quy tắc ngắn bạn viết, chẳng hạn điều kiện hoàn trả.
- Thông tin: một dữ kiện riêng được lưu theo ID.
Tên nguồn tối đa 120 ký tự; toàn bộ cấu hình, kể cả văn bản hướng dẫn, tối đa 64 KB.
Khả năng truy cập và ưu tiên
Mỗi nguồn có một mức hiển thị:
- Cho tác nhân AI: chỉ tác nhân tìm được.
- Cho nhân viên: dành cho tìm kiếm của nhân viên.
- Công khai: có thể hiện trong trung tâm trợ giúp.
Tệp, hướng dẫn và thông tin riêng không thể công khai; chỉ bài kiến thức đã xuất bản mới công khai. Quyền được kiểm tra trước khi tìm, nên tác nhân chỉ có quyền với tài liệu công khai không nhận đoạn nội bộ.
Độ ưu tiên từ −100 đến 100 giúp xếp giữa các đoạn gần tương đương. Khi điểm bằng nhau, nguồn ưu tiên cao lên trước; đoạn khớp câu hỏi tốt hơn vẫn quan trọng hơn ưu tiên.
Nguồn website
Nhập tối đa 20 địa chỉ website mà GetMyBot được đọc, ví dụ https://example.com không có đường dẫn. Địa chỉ có giao thức và tên miền gọi là origin. Sau đó nhập 1–100 trang bắt đầu. Chỉ HTTPS được phép.
Trình quét bị giới hạn như sau:
- Nó nhận diện là
MyBotKnowledge/1.0, đọcrobots.txttrước trên từng origin, bỏ đường dẫnDisallowvà tuân thủCrawl-delaytối đa 10 giây. - Chỉ theo liên kết
<a href>quay về origin được phép. Bỏ phần #, xóa tham sốutm_*,gclid,fbclidtrước khi đưa vào hàng đợi để tránh lập chỉ mục trùng. - Trước mỗi yêu cầu, tên miền được giải lại thành IP. Loopback, private, link-local, multicast và địa chỉ metadata đám mây bị chặn. Chuyển hướng qua cùng kiểm tra, tối đa ba lần.
- Hết giờ sau 15 giây, body tối đa 8 MB, chỉ nhận HTML, XHTML, văn bản thuần và Markdown.
- Mỗi nguồn lập chỉ mục tối đa 100 trang.
Trình quét không đăng nhập, gửi biểu mẫu, chạy script hoặc tải media/tài nguyên phụ. Trang có mật khẩu không thể thêm theo cách này; hãy xuất bản tài liệu hoặc tải lên tệp.
Cập nhật mỗi (giây) chỉ dùng cho website, từ 60 giây đến 366 ngày. Bài, tệp, hướng dẫn và thông tin không tự đọc lại theo lịch; chúng được lập chỉ mục lại sau khi sửa hoặc khi bấm Cập nhật.
Tải tệp lên
Tệp phải có sẵn trong thư viện media của cùng bot, tối đa 8 MB. Hỗ trợ PDF, DOCX, XLSX, PPTX, text/plain, text/markdown, text/html và XHTML.
Việc lấy văn bản có giới hạn:
- HTML giữ tiêu đề, danh sách và văn bản liên kết; loại script, style, menu, đầu/cuối trang, thanh bên và mẫu trang.
- PDF chỉ đọc văn bản, tối đa 100 trang. Tệp mã hóa hoặc hỏng bị từ chối toàn bộ, không lấy một phần.
- Office chỉ đọc phần văn bản. Macro, đối tượng nhúng và liên kết ngoài bị bỏ qua, không được tải. Tệp nén giới hạn 500 mục, tỷ lệ nén 100:1, 32 MB sau giải nén, 200.000 nút XML và 500.000 ký tự.
Tệp nhị phân cũ .doc, .xls, .ppt bị từ chối với unsupported_type. Hãy lưu lại thành DOCX, XLSX hoặc PPTX rồi tải lên.
Lập chỉ mục và trạng thái
Thẻ nguồn hiển thị:
- Đang chờ lập chỉ mục: vừa tạo/sửa, chưa xử lý.
- Đang lập chỉ mục: tác vụ đã được nhận.
- Sẵn sàng: nội dung hiện tại tìm được.
- Cần cập nhật: đến lịch hoặc nội dung đổi.
- Lỗi: lần thử cuối có mã lỗi.
- Đã tắt: còn cấu hình nhưng bị loại khỏi mọi tìm kiếm.
GetMyBot chia văn bản thành đoạn khoảng 1.500 ký tự, chồng nhau 200 ký tự, rồi tạo biểu diễn số của ý nghĩa (embedding) theo lô 32 đoạn. Chỉ sau khi toàn bộ thành công, phiên bản mới mới thay phiên bản cũ. Tìm kiếm luôn thấy bản cũ đầy đủ hoặc bản mới đầy đủ, không thấy nội dung xử lý dở. Nội dung không đổi sẽ không xử lý lại.
Embedding dùng tích hợp AI của bot, base URL và khóa của nó. Mặc định là text-embedding-3-small, trả 1.536 số mỗi đoạn. Không có tích hợp AI hoạt động, nguồn không thể sẵn sàng cho tìm kiếm.
Một nguồn có tối đa 100 tài liệu; mỗi tài liệu tối đa 500 đoạn. Nếu xử lý bị gián đoạn, sau hai phút tác vụ có thể được giao cho bộ xử lý khác, không giữ nguồn bị khóa mãi. Thẻ hiển thị số lần thử, tài liệu/đoạn đã xử lý và lỗi; Hủy lập chỉ mục dừng tác vụ đang chạy.
Tìm kiếm trả gì
Tìm kiếm dựa trên cả từ ngữ và ý nghĩa. Vì vậy câu «Trả lại hàng thế nào?» có thể tìm bài điều kiện hoàn trả:
- Tìm từ vựng khớp trong chỉ mục văn bản PostgreSQL.
- Tìm ngữ nghĩa gần nhau trong chỉ mục vector bằng khoảng cách cosin.
Cả hai trước tiên loại tài liệu bot khác, nguồn bị ẩn/tắt và tài liệu đã xóa. Các danh sách được hợp nhất theo thứ hạng bằng reciprocal rank fusion. Khi ngang điểm, xét ưu tiên nguồn và độ mới trong 30 ngày. Đoạn liền kề của cùng tài liệu được gộp.
Tối đa 12 đoạn, mỗi đoạn 800 ký tự. Câu hỏi tối đa 16.000 ký tự; tác nhân có thể giới hạn tối đa 100 nguồn cụ thể. Tác nhân lưu nguồn, tài liệu và đoạn của từng trích dẫn theo thứ hạng. Câu trả lời viện dẫn nguồn khác bị chặn trước khi gửi, nên không thể trỏ đến bản nháp hoặc nguồn đã ẩn, tắt, xóa.
Kiểm tra tìm kiếm
Cơ sở kiến thức → Kiểm tra tìm kiếm cho biết câu hỏi của bạn sẽ tìm được gì, không tạo câu trả lời. Mỗi kết quả có nguồn, tiêu đề, đoạn, điểm khớp và lý do («Khớp kết hợp»). Không hiện dữ liệu kỹ thuật ẩn; số lần thử trong thời gian ngắn bị giới hạn theo tài khoản.
Hãy kiểm tra trước khi bật tác nhân: nếu các đoạn ở đây sai, câu trả lời cũng sẽ sai.
Nếu lập chỉ mục lỗi
Mã lỗi được giữ ổn định:
blocked_address: URL, chuyển hướng hoặc IP ngoài phạm vi cho phép hoặc đi vào mạng nội bộ.robots_denied:robots.txtchặn đường dẫn.unsupported_type: loại nội dung hoặc định dạng tệp không hỗ trợ.file_too_large: tải xuống hoặc tệp vượt giới hạn.expanded_too_large: văn bản, số trang hoặc nội dung giải nén vượt giới hạn.malformed_file: không phân tích được tệp hoặc câu trả lời.fetch_timeout: site không trả kịp.rate_limited: nhà cung cấp embedding giới hạn yêu cầu, tác vụ sẽ thử lại.
Sửa nguyên nhân rồi bấm Cập nhật. Thông báo lỗi không chứa văn bản đã tải, có thể gửi cho hỗ trợ.
Xóa, tắt và lưu giữ
Tắt giữ cấu hình nhưng loại khỏi mọi tìm kiếm; Bật đưa lại vào hàng đợi. Xóa loại nguồn cùng tài liệu và đoạn.
Không thể xóa nguồn đang được tác nhân hoạt động chọn; máy chủ trả xung đột. Hãy bỏ chọn ở tác nhân hoặc tạm dừng tác nhân trước.
Cách ly dữ liệu
Nguồn, tài liệu, đoạn và tác vụ đều gắn với bot. Tìm kiếm được giới hạn theo bot trước khi chạy, nên văn bản của tài khoản khác không lọt vào kết quả dù nội dung giống nhau.
API và MCP
REST dùng knowledge:read và knowledge:write:
GET/POST /api/bots/{botID}/knowledge/sourcesGET/PATCH/DELETE /api/bots/{botID}/knowledge/sources/{sourceID}POST /api/bots/{botID}/knowledge/sources/{sourceID}/uploadPOST /api/bots/{botID}/knowledge/sources/{sourceID}/refreshPOST /api/bots/{botID}/knowledge/sources/{sourceID}/cancelPOST /api/bots/{botID}/knowledge/sources/{sourceID}/disablePOST /api/bots/{botID}/knowledge/sources/{sourceID}/enableGET /api/bots/{botID}/knowledge/sources/{sourceID}/index-statusGET /api/bots/{botID}/knowledge/sources/{sourceID}/documentsPOST /api/bots/{botID}/knowledge/retrieval-test
MCP chỉ có công cụ đọc list_knowledge_sources, get_knowledge_source_status và test_knowledge_retrieval. Không có công cụ MCP để đổi nguồn hoặc tải tài liệu ẩn.
Tài liệu liên quan
- Trả lời bằng AI và tác nhân: chọn nguồn cho tác nhân.
- Trung tâm trợ giúp: cùng bài viết cho khách.
- Tích hợp: tích hợp AI dùng cho embedding.