准备您的知识库，以便进行更快、更准确的 AI 检索。

转译自：Kevin Attard Compagno，3CX产品沟通经理

AI 智能体 的回答质量，完全取决于它能检索到的信息质量。在设置 AI 智能体时，最大的挑战之一是准备知识库。传统的格式，如 PDF、Word 文档、电子表格和演示文稿，主要是为了方便人类阅读而设计的，AI 并不容易直接理解和处理 。这可能会产生问题：

  • 标题可能会与其所属的文本分离。
  • 表格可能会失去其结构。
  • 重要的上下文可能会被遗漏。
  • AI 智能体可能会检索到文档的错误部分。

为避免这种情况，请为您的 AI 智能体知识库使用 Markdown (.md) 文件。

Markdown 能让文档保持结构清晰、内容纯粹且易于阅读。它不仅适用于人，还可为 AI 智能体提供更清晰的内容以供搜索和检索。

为什么 Markdown 效果更好

Markdown 消除了不必要的格式，并保持文档结构清晰。它使用简单的文本标记来表示标题、列表、表格和部分。这有助于 AI 智能体理解信息的组织方式。

  • 清晰的标题： Markdown 标题（如 #、## 和 ###）创建了清晰的结构。这有助于将主主题与子主题紧密关联，避免上下文断层。
  • 可读的表格： Markdown 表格使行和列保持对齐，从而使产品规格、设置要求和比较表格更易于处理。
  • 更纯粹无杂质的内容： Markdown 剔除了传统 Office 文档中冗余的排版格式和复杂的布局代码。
  • 更快的检索： 无冗余代码的文件有助于减少处理的文本量，并使检索更高效。
  • 减少错误回答： 结构更好的知识库有助于 AI 智能体更可靠地找到正确的信息。

将现有文档转换为 Markdown

您无需手动重写每个文件。MarkItDown 和 Docling 等开源工具可以帮助将现有文件转换为结构化的 Markdown。这些工具可以处理常见的格式，例如：

  • .docx
  • .pptx
  • .xlsx
  • PDFs

它们还可以帮助保留阅读顺序、将表格转换为 Markdown 格式，并从更复杂的文档布局中提取内容。

为您的 AI 智能体准备 Markdown 文档的示例

打开您的终端，设置一个干净的 Python 环境并安装所需的工具。

# Create and activate a virtual environment
python3 -m venv .venv
source .venv/bin/activate# Install MarkItDown with all format support
pip install ‘markitdown’

安装后，您可以直接从命令行转换文件，或使用命令行将其放入您的自动化数据工作流程中：

markitdown internal_kb_report.pdf > internal_kb_report.md

…或使用 Python 代码：

from markitdown import MarkItDown# Initialize the converter

md_converter = MarkItDown()

# Convert a complex layout file to structured Markdown

result = md_converter.convert(“product_specs.docx”)

# Take a look at the clean, machine-readable text

print(result.text_content)

 

Markdown 格式规则

在为 AI 智能体知识库创建或编辑 Markdown 文件时，请遵循以下规则：

  • 不要跳过标题级别： 保持标题顺序。不要从 # 直接跳到 ###。
  • 在表格周围留出空间： 在每个 Markdown 表格之前和之后添加一个空行。
  • 在顶部添加上下文：在合适位置（如文件开头）添加简短的元数据块，帮助 AI 智能体快速了解文档的核心主题。

示例：

—

category: Technical Documentation

product: 3CX PBX V20

audience: System Administrators

last_updated: 2026-06-01

—

# Setting up AI Agent Knowledgebases

…

 

更干净的知识库有助于您的 AI 智能体返回更好的答案。梳理您现有的文件，将核心文档转换为 Markdown，并在提供给 AI 智能体使用前，检查并确认标题、表格和元数据清晰无误。

参与互动

关注我们的互动频道，我们通过视频、图片、文档，包括召开技术及市场交流会议的形式，方便你了解及掌握 3CX 最新的资讯与技术信息，同时非常欢迎您在我们的媒体平台进行留言。