К содержимому
Дайджест

Файлы для агентов на сервере: как устроен Phantom FS

Stephen G. Pope·16 сентября 2026·19:29
текст даёт основное понять, как устроено промо
Открыть на YouTube
Разбор архитектуры файлового доступа для агентов: почему локальных файлов не хватает и как устроена библиотека Phantom FS — для тех, кто пишет своих агентов и упирается в общие файлы на разных машинах.

Что в ролике

Автор показывает, как агент вообще получает доступ к файлам: в запросе к API Anthropic он передаёт модель, лимит токенов, список инструментов и всю историю диалога, а инструмент LS — это просто код, который читает каталог и возвращает список файлов. Из этого следует важная деталь: каждый шаг диалога — отдельный независимый запрос, в котором вся переписка отправляется заново, а сам агент ничего не знает о том, как устроен его инструмент. Проблема начинается, когда файлы нужны в разных местах: у десктопного приложения Shockwave есть серверная часть для ночных задач, у SaaS — база с видео пользователей, и правки должны разъезжаться почти мгновенно. Решение — заменить локальное чтение на обращение к API: вместо кода, который смотрит на диск, инструмент делает запрос на сервер, а агент по-прежнему думает, что работает с локальной папкой. Так работает его библиотека Phantom FS: сервер отдаёт базовые инструменты (список файлов, чтение, запись, поиск внутри файлов), каждому агенту выдаётся свой идентификатор сессии, а файлы синхронизируются через Git, который заодно помогает разрешать конфликты, когда несколько агентов правят один файл. Чтобы новая сессия не ждала выкачивания репозитория, сервер держит пул заранее подготовленных веток, а команды выполняются внутри Docker — так один агент не видит рабочие файлы других. Отдельный маленький агент следит за изменениями в каждой рабочей папке и подтягивает их к GitHub как к источнику истины, а Postgres-часть поддерживает базу копий файлов и добавляет инструменты векторного и BM25-поиска. Масштаб, на который это рассчитано, — десятки агентов одновременно: автор говорит про двадцать агентов и сорок чатов, а также про двадцать пять агентов на одной файловой системе без конфликтов.

Практика

Что получишь
Поймёте, из каких частей состоит файловый доступ агента и что придётся добавить, если агентов станет много: сессии, синхронизацию через Git, изоляцию и поиск по файлам.
Первый шаг
Разберите один запрос к API с единственным инструментом LS — этого хватит, чтобы увидеть, как устроен вызов инструмента, — а дальше смотрите в сторону готовых решений вроде Phantom FS, Daytona или Vercel Sandbox.
Цифры
  • —20 агентов и 40 чатов — такой масштаб автор приводит как рабочий пример одной файловой системы
  • —25 агентов одновременно — столько, по его словам, можно запустить на одних файлах без конфликтов
  • —3 раза — столько репозиторий выкачивается заранее, чтобы держать пул готовых рабочих папок
  • —больше 30 лет — столько автор пишет код, этим он обосновывает свой курс
Честно
Phantom FS — собственный проект автора, и в ролике нет ни установки, ни кода целиком: конкретные запросы и команды видны только на экране, готовой инструкции по повторению не даётся. В конце автор зовёт в своё платное сообщество AI Architects с еженедельным круглым столом, живыми сборками и курсом. Настройку он сам называет нелёгкой: деталей много, и часть из них видна только в коде на экране.
Если слова незнакомы — 8 терминов

Связки из этого ролика

6 шт.

Компоненты

15 шт.

Формат: разбор · для практикующих · уверенность разметки 0.8 · источник