diff --git a/docs/new-surface-guide.md b/docs/new-surface-guide.md index d057c4e..f3b72b0 100644 --- a/docs/new-surface-guide.md +++ b/docs/new-surface-guide.md @@ -282,7 +282,19 @@ Matrix surface поддерживает staged attachments: - независимая проверка `config/-agents.yaml` - проверка, что surface запускается без локального агента -### 8.3. Проверка контрактов +### 8.3. Локальное E2E тестирование (fullstack) + +Для тестирования новой поверхности вместе с одним локальным агентом используйте паттерн `docker-compose.fullstack.yml`. +В этом режиме: +- Запускается 1 контейнер вашей поверхности +- Запускается 1 контейнер `platform-agent` +- Поднимается локальный shared volume (`surfaces-agents`) +- Поверхность настроена маршрутизировать запросы на `http://platform-agent:8000` (через `AGENT_BASE_URL`) +- Пользователь общается с ботом, а бот напрямую общается с локальным агентом, разделяя с ним общую папку для файлов. + +Это самый быстрый способ проверить интеграцию новой платформы без внешнего бэкенда. + +### 8.4. Проверка контрактов Особое внимание: