配置知识库

管理文档

创建、编辑、整理知识库文档，并保持内容最新。

通过知识库控制面板、CLI 或 API 管理知识库。了解知识库是什么以及智能体如何使用它，请参阅知识库。

知识库主界面，显示文档 列表

添加文档

可通过文件、网页或纯文本创建文档。创建后，将文档关联到智能体，即可在对话中使用其内容。

在知识库控制面板或智能体配置页面中，点击 添加文档，然后选择来源。

1

文件

上传 PDF、TXT、DOCX、HTML、EPUB 或 Markdown 格式的文档，每个文件最大 20MB。

文件上传界面，显示支持的格式和 20MB 大小限制

2

URL

粘贴 URL 即可导入网页。如需采集整个网站，请使用抓取选项——可从起始 URL 沿链接抓取整个网站，也可从网站的站点地图导入页面。如果页面导入失败，请确认网站允许爬虫用户代理。

URL 导入界面，用户可粘贴文档链接

请确保你有权使用所提供 URL 中的内容。
3

文本

手动输入文本并命名。

文本输入界面，用户可命名并添加自定义内容

爬虫用户代理

URL 导入和抓取任务使用用户代理 ElevenlabsBot/1.0 获取页面。

如果网站位于 CDN、WAF 或机器人防护规则之后，请允许此用户代理，以便爬虫读取页面。请求被拦截时，仍会创建文档，但无法从中提取内容。

爬虫还会遵循 robots.txt。禁止 ElevenlabsBot 或所有用户代理访问的页面会被跳过；如果预期应被索引的页面缺失，请检查相关规则。要明确允许爬虫访问：

robots.txt
User-agent: ElevenlabsBot
Allow: /

将现有文档添加到智能体

文档可在多个智能体之间复用，因此共享知识只需维护一次。

  1. 前往智能体配置。
  2. 找到知识库部分，然后点击 添加文档。
  3. 从知识库中选择现有文档，或上传新文档。

将文档添加到 智能体的界面

在多个智能体之间复用文档可保持知识一致，避免重复上传。

编辑文档

可直接编辑文档内容，无需删除后重新上传。编辑文档会自动重新生成内容搜索分块和 RAG 嵌入向量，确保搜索和智能体检索保持同步。

  • 文本和文件文档：直接编辑内容并保存。
  • 文件文档：也可使用新版本替换原文件。
  • URL 文档：自动同步关闭时可编辑内容。自动同步开启时，同步周期会管理文档，无法手动编辑。

在知识库中直接编辑文档 内容

# 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"),
)

保持 URL 内容最新

通过 URL 创建的文档可刷新，以重新获取来源中的最新内容。刷新会重新索引文档，使启用 RAG 的智能体使用更新后的内容。

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

在控制面板中，还可启用自动同步，按计划自动刷新 URL 文档，使内容无需手动更新也能保持最新。

使用文件夹整理

文件夹可将相关文档分组，便于管理和批量关联。创建文件夹后，可通过控制面板或 API 将文档移入其中。

关联到智能体的文件夹会通过 RAG 提供其中所有文档，因此智能体必须启用 RAG 才能使用文件夹。

创建文件夹并将文档移入 其中

# 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,
)

依赖关系和删除

每个文档都有一个 依赖智能体 标签页，其中列出了当前依赖该文档的智能体。

文档详情视图，显示“依赖智能体” 标签页

只要有智能体依赖某个文档，就无法删除该文档。请先从这些智能体中移除文档，或使用强制删除一次性将其从所有依赖项中解除关联。