Open Knowledge Format: стандарт Markdown для ИИ-агентов

Интеллект ИИ-агентов ограничен лишь тем контекстом, который вы им предоставляете.

Большинство команд сталкиваются с одной и той же проблемой. У вас есть мощная модель и надежный фреймворк, но агент ничего не знает о вашей организации. Он не знает ваших таблиц базы данных, формул метрик или инструкций (runbooks) по устранению инцидентов.

Эти знания разбросаны по Notion, Slack и вики-системам. Чтобы передать их агенту, обычно приходится создавать кастомные интеграции для каждого отдельного источника.

Open Knowledge Format (OKF) меняет ситуацию.

OKF — это вендоронезависимая спецификация. Она упаковывает ваши знания в виде обычных Markdown-файлов. Любой агент может прочитать их без использования кастомных SDK или проприетарных инструментов.

Как это работает: Пакет (bundle) OKF — это директория Markdown-файлов. Каждый файл представляет собой определенную концепцию, например, таблицу, метрику или API.

Почему это эффективно:

  • Идентификация через пути к файлам: путь к файлу служит ID. База данных или реестр не требуются.
  • Графы знаний через ссылки: ссылки Markdown создают связи между концепциями. Это превращает папку в навигационный граф.
  • Специальный инструментарий не требуется: файловая система и есть API. Вам не нужно новое ПО для работы с ней.

Как это использовать:

  • Командам данных: документируйте таблицы и метрики, чтобы агенты могли писать точные SQL-запросы.
  • SRE-командам: пишите инструкции (runbooks), чтобы агенты могли диагностировать инциденты.
  • Платформенным командам: поставляйте определения API, чтобы агенты понимали эндпоинты.

OKF не является заменой RAG или MCP.

  • Используйте OKF для стабильных, курируемых знаний, таких как схемы и инструкции (runbooks).
  • Используйте RAG для больших архивов неструктурированных документов.
  • Используйте MCP для работы с живыми данными и подключения инструментов.

Этот формат распространяется под лицензией Apache 2.0. Его легко внедрять, и он предотвращает привязку к конкретному вендору (vendor lock-in). Ваши знания хранятся в вашем git-репозитории и остаются доступными для чтения любым инструментом.

Начните с малого. Выберите одну команду с беспорядочной документацией. Напишите три OKF-файла и направьте на них агента.

Source: https://dev.to/suhas_mallesh/open-knowledge-format-okf-the-markdown-standard-your-ai-agents-have-been-waiting-for-3mfb

Optional learning community: https://t.me/GyaanSetuAi