Сборка AI
Обратно к статьям

Канбан-доска для кодинг-агентов весом 4 МБ: 10–60 токенов на ответ вместо JSON-простыней

Обсудить
Канбан-доска для кодинг-агентов весом 4 МБ: 10–60 токенов на ответ вместо JSON-простыней
5 мин. чтения

Каждый вызов инструмента в MCP (Model Context Protocol — протокол, через который ИИ-агент подключается к внешним инструментам) оставляет след в контекстном окне агента. Чем подробнее ответ, тем дороже следующий ход: многословные ответы накапливаются и съедают окно, в котором модели еще есть место думать. Именно из-за этой проблемы водин из пользователей Reddit собрал небольшую self-hosted* канбан-доску для агентов: один бинарник около 4 МБ, несколько мегабайт оперативной памяти, никакого рантайма и сервера, а ответ на запрос — 10–60 токенов. Проект называется kanzo. 

*Self-hosted (самохостинг) — это подход, при котором вы запускаете программное обеспечение и храните данные на собственном сервере или оборудовании, вместо того чтобы пользоваться облачными сервисами сторонней компании.


Идея проста до предела. Вместо того чтобы держать план работы внутри диалога, агент обращается к внешней доске: берет задачу, переводит ее в статус «в работе», отмечает выполнение. Доска хранит состояние между сессиями, а контекст остается свободным от истории переписок и разбора вложенных объектов.

Одна строка вместо JSON

Главное решение — формат ответов. Это не структурный JSON, а короткие однострочные текстовые ответы. Причина не в экономии символов ради экономии: агенты заметно хуже ориентируются в глубоко вложенных объектах, когда разговор длинный. Обычный текст им проще разобрать и не потерять смысл. Автор проекта прямо называет цель — сделать все как можно дешевле и по токенам, и по ресурсам: ответы остаются в контексте на всю оставшуюся сессию, поэтому их компактность имеет накопительный эффект.

Второй слой экономии — не возвращать агенту то, что он и так знает. Как только задача перешла в «в работе», сервер больше не отправляет агенту всю доску: это состояние уже хранится снаружи. Формат ответа помогает, но решающий шаг именно в том, чтобы не передавать агенту состояние, которое принадлежит доске.

Как два агента не возьмут одну задачу

Очевидный вопрос к таких доскам: что произойдет, если два агента одновременно попросят следующую задачу. В основе лежит SQLite, небольшая встроенная база в одном файле. Интерфейс получения задачи устроен так: вызов next_task открывает транзакцию с BEGIN IMMEDIATE, забирает блокировку на запись еще до чтения, потом выбирает верхнюю задачу из очереди и переводит ее в «в работе». Второй агент ждет блокировку (до пяти секунд) и после этого читает уже измененное состояние — и получает следующую задачу. Каждый агент запускает свой процесс kanzo mcp, а блокировка стоит на файле базы, поэтому правило работает и между разными процессами, а не только внутри одного.

Флаг «человек» выставляет границу между ручной и автоматической работой. Задача с этим флагом движок агентам не отдает: исключение происходит на сервере, а не потому, что агент «помнит, что эту задачу трогать нельзя». Это принципиальный выбор архитектуры: правила должны жить в коде и данных, а не в надежде на послушность маленькой или запутавшейся модели.

Где это пригодится

Самое интересное применение — не одиночная сессия, а несколько агентов, работающих на разных машинах над одним набором задач. Доска с атомарным захватом задачи через блокировку SQLite практически готова к такому сценарию: состояние общее, а разграничение доступа — в базе. Параллельно доска годится для асинхронной работы: человек раскладывает задачи, подмечает детали, пересматривает план между подходами агента, и все это сохраняется, пока контекст модели давно уже сменился.

Ограничения тоже видны. Один из слабых мест — повторные запросы: если ответ пришел медленно и агент повторил запрос, next_task может выдать вторую задачу, потому что первая уже в статусе «в работе». Защита здесь очевидна — возвращать вызывающему ту задачу, которая уже за ним закреплена, и добавлять «аренду» с таймаутом (временное закрепление задачи за агентом (аренда): если агент не отчитался за отведенное время, задача возвращается в очередь), возвращающую заброшенные карточки в очередь. Это уже задача для следующей версии, а не свойство, которое проект обеспечивает сегодня.

Синхронизация между несколькими машинами — следующий вопрос без четкого ответа в текущем описании: как именно будут сходиться правки доски с разных устройств и потребуется ли ручное разрешение конфликтов. Для того чтобы доска стала действительно общей для распределенной команды агентов, этот слой придется решать отдельно.

Что из этого стоит забрать себе

Философия kanzo применима не только к доске задач. Три правила переносятся на любой MCP-инструмент для агентов:

  • держите состояние вне контекста: если инструмент сам знает, что происходит, не пересказывайте это модели заново на каждом шаге;
  • отвечайте плоским коротким текстом, а не вложенными объектами: агенту нужна ориентация, а не выгрузка данных;
  • переносите правила и ограничения в сервер: флаг «человек» должен обрабатываться на сервере, а не запретом в промпте.

Для небольших собственных проектов доска дает еще и быстрый путь к многопоточности: тот же SQLite с блокировкой на запись уже готов делить очередь между агентами, а вся инфраструктура укладывается в несколько мегабайт памяти. kanzo не пытается заменить трекеры задач для людей. Он делает другое: дает агенту внешнюю память, которая стоит почти ничего и не мешает ему думать.

А как вы решаете проблему памяти агентов? Поделитесь в комментариях.

Источник:r/LLMDevs

Комментарии к статье

Пока нет комментариев. Будьте первым!

Подписывайтесь на нас в Telegram и VK

Оставайтесь в курсе последних тенденций и новостей из мира AI