Quản lý tài liệu trong kho kiến ​​thức ElevenAgents

Tìm hiểu cách quản lý cơ sở kiến ​​thức của bạn từ dashboard Knowledge Base, CLI hoặc API. Để hiểu rõ cơ sở kiến ​​thức là gì và cách các agent sử dụng nó, hãy xem phần Thiết lập cơ sở kiến ​​thức cho ElevenAgents.

1. 
   Đi tới phần cấu hình của agent.

2. Tìm mục Knowledge Base và nhấp vào Add document.

3. Chọn một tài liệu có sẵn từ cơ sở kiến thức hoặc upload lên tài liệu mới.

Chỉnh sửa tài liệu

Bạn có thể chỉnh sửa trực tiếp nội dung tài liệu thay vì xóa và upload lại. Việc chỉnh sửa tài liệu sẽ tự động tạo lại các đoạn nội dung để tìm kiếm và những vector nhúng RAG, đảm bảo tính đồng bộ giữa chức năng tìm kiếm và khả năng truy xuất của agent.

• Tài liệu dạng văn bản và file: Chỉnh sửa nội dung trực tiếp (inline) và lưu lại.

• Tài liệu dạng file: Ngoài ra, bạn có thể thay thế file hiện tại bằng một phiên bản mới.

• Tài liệu dạng URL: Chỉnh sửa nội dung khi tính năng tự động đồng bộ (auto-sync) đang tắt. Khi tính năng này đang bật, chu kỳ đồng bộ sẽ quản lý tài liệu và các thao tác chỉnh sửa thủ công sẽ bị chặn.

Python

# Update a document's name or content
elevenlabs.conversational_ai.knowledge_base.documents.update(
    documentation_id="i2YYI6huwBmcgYydAXARmQJc3pmX",
    name="Unladen Swallow Facts",
    content="The airspeed velocity of an unladen swallow (European) is 24 miles per hour.",
)

# Replace the underlying file of a file document

elevenlabs.conversational_ai.knowledge_base.document.update_file(
documentation_id="i2YYI6huwBmcgYydAXARmQJc3pmX",
file=open("/path/to/unladen-swallow-facts-v2.txt", "rb"),
)

TypeScript

// Update a document's name or content
await elevenlabs.conversationalAi.knowledgeBase.documents.update("i2YYI6huwBmcgYydAXARmQJc3pmX", {
  name: "Unladen Swallow Facts",
  content: "The airspeed velocity of an unladen swallow (European) is 24 miles per hour.",
});

// Replace the underlying file of a file document
const fileBuffer = fs.readFileSync("/path/to/unladen-swallow-facts-v2.txt");
const updatedFile = new File([fileBuffer], "unladen-swallow-facts-v2.txt", { type: "text/plain" });
await elevenlabs.conversationalAi.knowledgeBase.document.updateFile("i2YYI6huwBmcgYydAXARmQJc3pmX", {
  file: updatedFile,
});

Luôn cập nhật nội dung từ URL

Các tài liệu được tạo từ URL có thể được làm mới để lấy lại nội dung mới nhất từ ​​nguồn gốc. Việc làm mới sẽ lập lại chỉ mục cho tài liệu, nhờ đó các agent hỗ trợ RAG sẽ sử dụng nội dung đã được cập nhật.

Python

elevenlabs.conversational_ai.knowledge_base.document.refresh(
    documentation_id="i2YYI6huwBmcgYydAXARmQJc3pmX",
)

TypeScript

await elevenlabs.conversationalAi.knowledgeBase.document.refresh("i2YYI6huwBmcgYydAXARmQJc3pmX");

Trong dashboard, bạn cũng có thể bật tính năng tự động đồng bộ để tự động làm mới các tài liệu URL theo lịch trình, đảm bảo nội dung luôn được cập nhật mà không cần cập nhật thủ công.

Sắp xếp bằng thư mục

Thư mục nhóm các tài liệu liên quan lại với nhau để dễ quản lý và đính kèm hàng loạt. Tạo một thư mục, sau đó di chuyển tài liệu vào đó từ dashboard hoặc API.

Một thư mục được đính kèm với một agent sẽ giúp tất cả tài liệu của agent đó có sẵn thông qua RAG, vì vậy agent đó phải bật RAG để sử dụng thư mục.

Python

# Create a folder
folder = elevenlabs.conversational_ai.knowledge_base.documents.create_folder(
    name="Product documentation",
)

# Move a document into the folder

elevenlabs.conversational_ai.knowledge_base.documents.move(
document_id="i2YYI6huwBmcgYydAXARmQJc3pmX",
move_to=folder.id,
)

TypeScript

// Create a folder
const folder = await elevenlabs.conversationalAi.knowledgeBase.documents.createFolder({
  name: "Product documentation",
});

// Move a document into the folder
await elevenlabs.conversationalAi.knowledgeBase.documents.move("i2YYI6huwBmcgYydAXARmQJc3pmX", {
  moveTo: folder.id,
});

Các dependency và việc xóa

Mỗi tài liệu đều có tab Dependent agents, liệt kê những agent hiện đang phụ thuộc vào tài liệu đó.

Không thể xóa tài liệu khi vẫn có agent phụ thuộc vào nó. Hãy loại bỏ tài liệu khỏi các agent đó trước, hoặc sử dụng tính năng Force deletion (buộc xóa) để ngắt kết nối tài liệu khỏi tất cả các dependency cùng lúc.