Разработчикам
Интеграция внешнего продукта
Как связать сайт или личный кабинет с Web Chat, безопасным контекстом и актуальной диагностикой.
Обновлено: 7 августа 2026
Архитектура
textKanyman docs
внешний продукт
→ Web Chat v3
→ подписанный снимок контекста
→ Kanyman AgentContext
→ опциональный read-only HTTP tool
→ ответ или handoff операторуСнимок отвечает на вопрос «кто пользователь и где он находится». Инструмент получает только актуальные данные, которых не было в снимке. Документация проекта объясняет правила продукта, но не заменяет состояние конкретного пользователя.
Порядок подключения
- 1Создайте активный Web Chat и свяжите его с агентом.
- 2Зарегистрируйте внешнее приложение, Origin, issuer, audience и открытый ключ.
- 3Опишите объект data закрытой JSON Schema.
- 4Проверьте короткоживущий тестовый JWT.
- 5При необходимости добавьте read-only HTTP tool и активируйте его безопасным тестом.
- 6Установите kenyman-chat.v3.js и передавайте JWT только из серверного контура продукта.
- 7Проведите end-to-end UAT с реальным оператором.
Границы доверия
- Браузер переносит контекст, но не создаёт и не подписывает его.
- Модель не управляет subject, integration_id или внешними entities.
- Секреты инструмента не передаются модели, виджету и оператору.
- Любые данные внешнего продукта считаются данными, а не инструкциями для модели.