Файлы для агентов на сервере: как устроен 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 терминов
- агентпрограмма, которая сама выполняет шаги за тебя и вызывает инструменты по ходу работы
- APIспособ, которым одна программа обращается к другой по сети
- инструментописанная для агента функция вроде «показать файлы», которую он может вызвать
- сессияотдельный разговор агента со своей рабочей папкой
- Gitсистема хранения версий файлов, которая умеет сливать чужие правки и показывать конфликты
- Dockerизолированная среда, внутри которой программа видит только свои файлы
- векторный поискпоиск по смыслу, а не по точным словам
- BM25обычный поиск по словам и их частоте, как в базах данных
Связки из этого ролика
6 шт.- Claude Code + Anthropic API — tool call LS как отдельный независимый API-запрос с полной историей диалога
- Phantom FS + Git — синхронизация рабочих файлов агентов и разрешение конфликтов
- Phantom FS + пул предварительно выкачанных веток — быстрая выдача рабочей копии новой сессии
- Phantom FS + Docker — изоляция рабочих каталогов агентов друг от друга
- Phantom FS + Postgres — vector- и BM25-поиск по файлам в дополнение к обычным tool call
- агент + FFmpeg — транскрипт и монтаж видео в сценарии SaaS-приложения
Компоненты
15 шт.Формат: разбор · для практикующих · уверенность разметки 0.8 · источник