Подготовьте базу знаний для более быстрого и точного извлечения данных ИИ.

Качество работы ИИ агента напрямую зависит от найденной информации. При настройке ИИ агента одной из главных трудностей является подготовка используемых источников знаний. Как правило, традиционные форматы, такие как PDF, документы Word, электронные таблицы и презентации, предназначены для чтения человеком. Однако их обработка с помощью ИИ часто затруднена. В результате это приводит к следующим проблемам:

  • Заголовки могут отделяться от относящегося к ним текста.
  • Таблицы могут терять свою структуру.
  • Важный контекст может быть упущен.
  • ИИ агент может извлекать неверную часть документа.

Чтобы избежать этого, используйте файлы Markdown (.md) в качестве источников знаний ИИ агента.

Knowledge Sources

Формат Markdown сохраняет документы чистыми, структурированными и легко читаемыми. Кроме того, он удобен для восприятия человеком и предоставляет ИИ агенту более четкий контент для поиска и извлечения.

Почему Markdown работает лучше

Markdown удаляет лишнее форматирование и сохраняет четкую структуру документа. В частности, используются простые текстовые маркеры для заголовков, списков, таблиц и разделов. Таким образом, это помогает ИИ агенту понимать логику организации информации.

  • Четкие заголовки: заголовки Markdown, такие как #, ## и ###, создают понятную структуру. Это позволяет группировать темы и подтемы вместе.
  • Читаемые таблицы: таблицы Markdown сохраняют выравнивание строк и столбцов, поэтому спецификации продуктов, требования к установке и сравнительные таблицы обрабатываются легче.
  • Более чистый контент: Markdown удаляет скрытое форматирование и лишние данные макета, присутствующие в традиционных офисных файлах.
  • Более быстрое извлечение: чистые файлы снижают объем обрабатываемого текста и повышают эффективность извлечения данных.
  • Меньше неправильных ответов: лучше структурированные источники знаний позволяют ИИ агенту надежнее находить правильную информацию.

Преобразование существующих документов в Markdown

Нет необходимости переписывать каждый файл вручную. Инструменты с открытым исходным кодом, такие как MarkItDown и Docling, помогают преобразовывать существующие файлы в структурированный Markdown. Более того, эти инструменты обрабатывают такие распространенные форматы, как:

  • .docx
  • .pptx
  • .xlsx
  • PDFs

Также поддерживается сохранение порядка чтения, преобразование таблиц в формат Markdown и извлечение контента из документов со сложной разметкой.

Пример подготовки документов 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[all]’

После установки можно конвертировать файл напрямую из командной строки или добавить его в автоматизированный рабочий процесс обработки данных с помощью командной строки:

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

При создании или редактировании файлов Markdown для источников знаний ИИ агента соблюдайте следующие правила:

  • Не пропускайте уровни заголовков: соблюдайте порядок заголовков. Не переходите от # сразу к ###.
  • Оставляйте пространство вокруг таблиц: добавляйте пустую строку до и после каждой таблицы Markdown.
  • Добавляйте контекст в начале: при необходимости используйте короткий блок метаданных, чтобы ИИ агент понимал содержание файла.

Пример:

—
category: Technical Documentation
product: 3CX PBX V20
audience: System Administrators
last_updated: 2026-06-01
—# Setting up AI Agent Knowledgebases
…

Чистые источники знаний помогают ИИ агенту давать более точные ответы. Следовательно, перед назначением ИИ агенту перепроверьте существующие файлы, конвертируйте ключевые документы в Markdown и убедитесь в четкости заголовков, таблиц и метаданных.

Присоединяйтесь к обсуждению

Присоединяйтесь к обсуждению 3CX на специализированных форумах для партнеров или клиентов. Кроме того, подписывайтесь на X и LinkedIn, чтобы быть в курсе последних новостей и выхода новых функций.