docs: update deploy-architecture and README for per-agent routing

README.md

@@ -12,16 +12,19 @@ Matrix-бот для взаимодействия пользователя с AI
 Бот подключается к агенту через `lambda_agent_api.AgentApi` по адресу `AGENT_BASE_URL`.
 Протокол — WebSocket поверх HTTP, контракт описан в `docs/deploy-architecture.md`.
 
-**2. Shared volume**
-Бот пишет файлы пользователей в Docker volume, смонтированный как `/agents`.
-Агент должен видеть тот же volume — как `/workspace`.
+**2. Shared volume с per-agent поддиректориями**
+Shared volume монтируется в бот как `/agents`. Каждый агент видит свою поддиректорию.
 
 ```
-Bot container          Agent container
-  /agents/   ←──── named Docker volume ────→  /workspace/
+Bot container                  Agent containers
+  /agents/0/  ←── volume ──→  agent_0: /workspace/
+  /agents/1/  ←── volume ──→  agent_1: /workspace/
+  /agents/N/  ←── volume ──→  agent_N: /workspace/
 ```
 
-Бот кладёт входящие файлы по пути `surfaces/matrix/{user}/{room}/inbox/{file}` и передаёт агенту этот относительный путь. Исходящие файлы агент пишет в свой `/workspace/`, бот читает их оттуда же.
+- Бот сохраняет входящий файл в `{workspace_path}/incoming/{stamp}-{file}` и передаёт агенту `attachments=["incoming/{stamp}-{file}"]`
+- Агент пишет исходящий файл в свой `/workspace/output/file`, бот читает его из `{workspace_path}/output/file`
+- `workspace_path` для каждого агента задаётся в `config/matrix-agents.yaml`
 
 **3. Конфиг агентов**
 Файл `config/matrix-agents.yaml` — маппинг Matrix-пользователей на агентов. Вы заполняете его под свою инфраструктуру. Пример в `config/matrix-agents.example.yaml`.
@@ -109,11 +112,20 @@ user_agents:
 agents:
   - id: agent-0
     label: "Agent 0"
+    base_url: "http://lambda.coredump.ru:7000/agent_0/"
+    workspace_path: "/agents/0"
   - id: agent-1
     label: "Agent 1"
+    base_url: "http://lambda.coredump.ru:7000/agent_1/"
+    workspace_path: "/agents/1"
 ```
 
-Если `user_agents` не задан или пользователь не найден — используется первый агент из списка.
+- `user_agents` — маппинг Matrix user_id → agent_id. Если пользователь не найден — используется первый агент.
+- `base_url` — HTTP URL агент-эндпоинта (path-based routing через reverse proxy).
+- `workspace_path` — путь к воркспейсу агента внутри бот-контейнера на shared volume.
+  Бот сохраняет входящие файлы в `{workspace_path}/incoming/`, агент пишет исходящие в свой `/workspace/`.
+
+Полный пример с комментариями: `config/matrix-agents.example.yaml`
 
 ### Production (bot-only)