Веб-интерфейсы
WebChat
Статус: macOS/iOS SwiftUI интерфейс чата общается напрямую с WebSocket шлюза.
Что это такое
- Нативный интерфейс чата для шлюза (без встроенного браузера и локального статического сервера).
- Использует те же сессии и правила маршрутизации, что и другие каналы.
- Детерминированная маршрутизация: ответы всегда возвращаются в WebChat.
Быстрый старт
- Запустите шлюз.
- Откройте интерфейс WebChat (приложение для macOS/iOS) или вкладку чата в Панели управления.
- Убедитесь, что аутентификация шлюза настроена (требуется по умолчанию, даже на loopback).
Как это работает (поведение)
- Интерфейс подключается к WebSocket шлюза и использует
chat.history,chat.sendиchat.inject. chat.historyограничен для стабильности: Шлюз может обрезать длинные текстовые поля, опускать тяжёлые метаданные и заменять слишком большие записи на[chat.history omitted: message too large].chat.injectдобавляет заметку ассистента напрямую в транскрипт и транслирует её в интерфейс (без запуска агента).- Прерванные запуски могут оставлять частичный вывод ассистента видимым в интерфейсе.
- Шлюз сохраняет прерванный частичный текст ассистента в историю транскрипта, если существует буферизованный вывод, и помечает эти записи метаданными о прерывании.
- История всегда загружается из шлюза (без отслеживания локальных файлов).
- Если шлюз недоступен, WebChat работает в режиме только для чтения.
Панель инструментов агентов в Панели управления
- Панель
/agentsв Панели управления получает каталог инструментов времени выполнения черезtools.catalogи помечает каждый инструмент какcoreилиplugin:<id>(плюсoptionalдля опциональных инструментов плагинов). - Если
tools.catalogнедоступен, панель возвращается к встроенному статическому списку. - Панель редактирует профиль и конфигурацию переопределений, но фактический доступ во время выполнения всё равно следует приоритету политик (
allow/deny, переопределения на уровне агента и провайдера/канала).
Удалённое использование
- Удалённый режим туннелирует WebSocket шлюза через SSH/Tailscale.
- Вам не нужно запускать отдельный сервер WebChat.
Справочник по конфигурации (WebChat)
Полная конфигурация: Конфигурация Параметры канала:
- Отдельного блока
webchat.*нет. WebChat использует конечную точку шлюза и настройки аутентификации, указанные ниже.
Связанные глобальные параметры:
gateway.port,gateway.bind: Хост/порт WebSocket.gateway.auth.mode,gateway.auth.token,gateway.auth.password: Аутентификация WebSocket (токен/пароль).gateway.auth.mode: "trusted-proxy": Аутентификация через обратный прокси для браузерных клиентов (см. Аутентификация через доверенный прокси).gateway.remote.url,gateway.remote.token,gateway.remote.password: Целевой удалённый шлюз.session.*: Хранилище сессий и ключи по умолчанию.