ДокументацияОткрыть Kanyman
Разделы документации

Разработчикам

Интеграция внешнего продукта

Как связать сайт или личный кабинет с Web Chat, безопасным контекстом и актуальной диагностикой.

Обновлено: 7 августа 2026

Архитектура

textKanyman docs
внешний продукт
  → Web Chat v3
  → подписанный снимок контекста
  → Kanyman AgentContext
  → опциональный read-only HTTP tool
  → ответ или handoff оператору

Снимок отвечает на вопрос «кто пользователь и где он находится». Инструмент получает только актуальные данные, которых не было в снимке. Документация проекта объясняет правила продукта, но не заменяет состояние конкретного пользователя.

Порядок подключения

  1. 1Создайте активный Web Chat и свяжите его с агентом.
  2. 2Зарегистрируйте внешнее приложение, Origin, issuer, audience и открытый ключ.
  3. 3Опишите объект data закрытой JSON Schema.
  4. 4Проверьте короткоживущий тестовый JWT.
  5. 5При необходимости добавьте read-only HTTP tool и активируйте его безопасным тестом.
  6. 6Установите kenyman-chat.v3.js и передавайте JWT только из серверного контура продукта.
  7. 7Проведите end-to-end UAT с реальным оператором.

Границы доверия

  • Браузер переносит контекст, но не создаёт и не подписывает его.
  • Модель не управляет subject, integration_id или внешними entities.
  • Секреты инструмента не передаются модели, виджету и оператору.
  • Любые данные внешнего продукта считаются данными, а не инструкциями для модели.

Продолжить

Интеграция внешнего продукта — Kanyman Docs