Доступ к данным
Агенты читают из корпоративных систем нужные им аналитические витрины, операционные системы, документы, почту, календарь и внешние индексы. Каждое обращение проходит через инструментальную политику.
Этот документ про интеграционный слой платформы. Здесь разобрано, какие данные и действия становятся доступны агентам, через какие паттерны это устроено, как платформа подключается к корпоративным и внешним системам и какой минимальный набор интеграций имеет смысл собирать на старте.
Главная ценность интеграционного слоя в том, что один коннектор пишут один раз, и пользуются им все агенты в пределах своих прав. Количество подключённых систем тут вторично. За счёт этого разрастание каталога агентов превращается в операцию конфигурации.
Платформа сознательно не дублирует корпоративное хранилище и не строит собственный Data Lake поверх корпоративного. Данные остаются в тех системах, где они уже живут, а агенты обращаются к ним через управляемые коннекторы. Это решение продиктовано комплаенсом и эксплуатацией и подробно разобрано в 05-architecture, раздел «Данные».
Для первой версии концепта список конкретных систем менее важен, чем понимание интеграционных паттернов и их компромиссов. Один и тот же DWH в разных сетях подключается по-разному, и универсальной таблицы коннекторов здесь не получится. Зато паттерны переносимы. Поэтому в этом документе сначала разбираются типы и паттерны интеграций, потом приоритетный набор для MVP, и только в конце справочник возможных систем как опорный материал для разговора с конкретным заказчиком.
Без интеграций мультиагентная платформа превращается в обособленный диалоговый интерфейс. Сотрудник по-прежнему сам идёт за цифрой в BI и за письмом в почту, а статус поставки ему приходится отдельно выяснять в WMS. Ценность Напарника и функциональных агентов раскрывается ровно в той мере, в какой они дотягиваются до корпоративных данных и действий.
Через интеграционный слой агенты закрывают четыре задачи одновременно.
Доступ к данным
Агенты читают из корпоративных систем нужные им аналитические витрины, операционные системы, документы, почту, календарь и внешние индексы. Каждое обращение проходит через инструментальную политику.
Действия в системах
Помимо чтения, агенты могут исполнять действия (отправить письмо, поставить задачу, обновить статус, забронировать слот). Действия с внешним эффектом по умолчанию идут на Tier 2, то есть агент готовит действие, а человек его подтверждает. В Tier 3 выносят только отдельно согласованные автономные действия с явными границами (см. Tier-модель). Подробности лежат в 05-architecture, раздел «Human-in-the-loop».
Реакция на события
Платформа сама запрашивает данные и вдобавок получает уведомления от внешних систем о сорванных поставках, аномалиях в продажах и входящих письмах от поставщиков. Отобранные события становятся карточками для агента, который их разберёт. События внешних таск-трекеров подключаются позже, по запросу заказчика.
Унификация
Система, подключённая под один сценарий, остаётся доступной для всех следующих агентов. Сотрудник получает нового агента с уже доступными ему данными, без ожидания отдельной интеграции под этот сценарий.
В архитектуре платформы интеграционный слой стоит между инструментами агентов и корпоративными данными. Агенты обращаются к данным через инструменты, а инструменты к системам через коннекторы. Место этого слоя в общей картине подробно показано в 05-architecture, раздел «Карта архитектуры».
Эти принципы прошиты в каждый коннектор и каждую инструментальную политику. Они работают как ограничения при подключении новой системы и как чек-лист при пресейле, когда нужно быстро понять, какие риски и сложности возникнут в конкретном ИТ-окружении заказчика.
Один коннектор для всех агентов
Систему подключают один раз на уровне платформы. Дальше любой агент, у которого в инструментальной политике стоит право пользоваться этим коннектором, получает доступ. Команде внедрения дублировать интеграцию под каждого агента нельзя. Почему именно так, разобрано ниже.
Read-only по умолчанию
Любой новый коннектор подключается в режиме только чтения. Запись добавляется отдельно, под явное обоснование и с явным расширением инструментальной политики. Это снижает класс возможных ошибок и упрощает согласование с информационной безопасностью.
Права сотрудника не расширяются
Напарник и вызванные им агенты не должны получать данных больше, чем доступно сотруднику. Если у менеджера нет доступа к данным соседнего подразделения, у Напарника тоже нет. Личные подключения работают под учётной записью самого сотрудника. В общих подключениях через сервисную учётную запись его периметр удерживают инструментальные политики и разграничение доступа на уровне строк в источнике. Для систем без такого разграничения вопрос открыт (см. 05-architecture и «Открытые вопросы»).
Данные не покидают периметр
Платформа не строит собственную копию корпоративных данных. Запросы исполняются там, где данные физически живут, и в том же сетевом контуре. Если хранилище стоит on-premise, обращение к нему идёт on-premise. Исключения составляют RAG-индекс, кэш частых запросов и batch-выгрузки. Они живут в том же контуре, что и источник, учитывают его права доступа и хранятся ограниченный срок. Что уходит к языковой модели в промпте, зависит от варианта развёртывания.
Каждое обращение аудируется
Любой вызов коннектора попадает в журнал. В журнале фиксируется агент-инициатор, инструмент, параметры запроса и сжатый результат. Сотрудник может в один клик провалиться в источник, а комплаенс-офицер может разобрать любой случай по записи.
Стандартный протокол вместо точечных скриптов
По возможности интеграция строится на стандартном протоколе (MCP-подобный коннектор, REST, событийная шина), а не на одноразовых скриптах. Такую интеграцию проще тестировать и передавать в эксплуатацию заказчику, а провайдера в ней легче сменить.
Интеграции удобно сгруппировать по тому, что именно агент делает с системой. У каждой группы свои паттерны и комплаенс-нюансы, да и подключают группы в разном темпе.
Чтение аналитики
В группу входят запросы к DWH, BI и семантическим витринам. Сюда же относятся Text2SQL поверх корпоративного хранилища и обращения к семантическому слою. В крупной сети это чаще всего самая зрелая группа.
Чтение операционных данных
Текущая операционная картина (SLA поставщиков, фактические даты прихода, остатки, договоры, цены) на практике берётся из хранилища, куда эти данные регулярно выгружаются из ERP, WMS, TMS и систем ценообразования. Прямое обращение в сами бизнес-критичные системы остаётся исключением (см. врезку «Про прямое чтение из бизнес-критичных систем» в разделе «Принципы интеграции»).
Поиск по документам
Сюда относится RAG-контур поверх корпоративных регламентов, прецедентов, аналитических отчётов и стандартов. Может включать также общие папки, корпоративный портал и базы знаний. Подробнее эта группа разобрана в разделе «RAG по корпоративным документам».
Коммуникации
Группа объединяет корпоративный мессенджер, почту, календарь и таск-трекер. С Напарником работают через два канала, мессенджер и веб-портал платформы, а все четыре системы показывают, что происходит вокруг сотрудника прямо сейчас. По комплаенсу это чувствительная зона, потому что здесь часто лежат персональные данные и переписка с внешними контрагентами.
Действия в системах
Сюда входят запись в учётные системы, отправка писем, постановка задач и бронирование слотов в календаре. Каждое такое действие по умолчанию идёт на Tier 2, с подтверждением человека. Перевести действие в Tier 3 можно только по отдельно согласованному сценарию. Подробности подтверждения человеком собраны в 05-architecture, раздел «Human-in-the-loop».
Внешние источники
В группу входят индексы цен на сырьё, публичные отчёты, рыночные данные и мониторинг конкурентов. Внешний контент по умолчанию недоверенный и оборачивается специальной разметкой, чтобы агент не выполнил инструкции, спрятанные в письме или на странице. Механизм описан в 05-architecture, раздел «Защита от prompt injection».
В реальном внедрении эти группы редко покрываются одинаково и одновременно. Аналитика обычно зрелая, операционные системы хорошо описаны, но сложные по правам, документы разбросаны по нескольким источникам. От стартовой зрелости каждой группы зависит, какие сценарии и какие агенты войдут в пилот (Фазу 1). Эта картина важна на пресейле. Какие интеграции подключают на какой фазе, собрано ниже в разделе «Интеграции по фазам».
Один и тот же DWH разные заказчики подключают к платформе через разные паттерны. Иногда выбирают MCP-подобный коннектор, иногда обычный REST-API, иногда выгрузку на S3 раз в сутки. Универсального правильного ответа здесь нет, но есть несколько устойчивых паттернов, и каждый применим в своих условиях.
| Паттерн | Когда подходит | Чем платим |
|---|---|---|
| API-интеграция | У системы есть аккуратное REST/GraphQL/gRPC API с понятной аутентификацией и нагрузочными ограничениями. | Каждый запрос идёт в систему-источник в реальном времени. Это требует доступности этой системы. |
| Event-driven | Система должна реагировать на события сама, не дожидаясь запроса по требованию. Агент отслеживает сорванную поставку, новое письмо или аномалию. | Сложнее наладить надёжную доставку и идемпотентность. Требуется событийная инфраструктура у заказчика. |
| Batch | Нужно работать с большими объёмами исторических данных, ночными витринами или тяжёлыми отчётами. | Данные в платформе будут отставать на интервал выгрузки. Не подходит для оперативной картины. |
| RAG поверх документов | Когда нужно искать смысл в неструктурированных текстах (регламенты, прецеденты, отчёты). | Качество зависит от качества индекса и обновлений. Нужна отдельная процедура переиндексации. |
| Tool calling | Любая интеграция, которую агент должен вызывать сам, через стандартизованные функции. | Накладные расходы на проектирование функций и их версионирование. |
| MCP-подобный коннектор | Когда нужна управляемая интеграция со стандартным интерфейсом, общая для всех агентов. | Требуется поддержка платформой и провайдером. Выгода видна на масштабе нескольких систем. |
Паттерны можно и нужно комбинировать. Один и тот же DWH может быть подключён через MCP-коннектор для горячих запросов и через batch-выгрузку для тяжёлых аналитических задач. Один и тот же мессенджер может одновременно отдавать события об упоминаниях и принимать команды через API.
Если у заказчика уже есть интеграционная шина или iPaaS, коннекторы платформы подключают через неё, а не к каждой системе напрямую. Платформа получает данные в тех же форматах и с теми же правами, что и другие потребители шины, а владельцам систем не нужно согласовывать ещё одно прямое подключение.
Это базовый паттерн для большинства корпоративных систем с современным интерфейсом. Платформа делает запрос в систему-источник и возвращает агенту полученный ответ. Преимущество в простоте и в том, что данные приходят свежими, ровно в момент запроса.
В аккуратной API-интеграции аутентификация идёт через сервисную учётную запись с минимальным набором прав, а не через персональный токен сотрудника. Лимиты вызова платформа отслеживает у себя, чтобы один пытливый агент не перегрузил систему-источник, а ошибки и тайм-ауты обрабатывает явно, не превращая их в зависший шаг агента. Версию API при этом закрепляют явно, чтобы обновление на стороне поставщика не сломало работу платформы.
Этот паттерн нужен там, где работа агентов начинается не с вопроса сотрудника, а с события в корпоративной среде. Это может быть сорванная поставка, аномалия в продажах или входящее письмо от поставщика. Платформа подписывается на поток внешних событий и превращает их в карточки для агентов.
Технически это может быть Kafka, Rabbit, Event Hub, Redis Streams или другая событийная шина заказчика. В этом сюжете платформа подключается к шине как один из потребителей. На стороне платформы поток читает сервисный обработчик событий. Он отсеивает повторы и нерелевантные события и ставит карточку агенту, например агенту мониторинга и аномалий, а тот после разбора сообщает о результате Напарнику нужного сотрудника. Само внешнее событие агента не будит. Его будит назначение карточки, которое относится к событиям платформы (см. 05-architecture, раздел «Делегирование»).
При event-driven интеграциях доставка событий должна быть как минимум at-least-once, иначе часть оповещений будет теряться. Идемпотентность обязательна, потому что одно и то же событие может прийти дважды. Задержка от события до агента считается на этапе проектирования. Полчаса для аналитического оповещения обычно нормально, для срыва поставки уже долго.
Этот паттерн подходит для тяжёлых витрин, исторических массивов и для систем, у которых нет нормального API. Выгрузка идёт по расписанию (раз в сутки, раз в час), результат складывается в стандартное место (S3, локальная папка, внутренняя витрина), и агенты обращаются уже к ней.
Главный компромисс в актуальности. Если данные обновляются раз в сутки, утренний брифинг строится на вчерашней картине. Это терпимо для долгих аналитических разборов и непригодно для оперативной коммуникации. Поэтому batch-интеграции обычно дополняют API-интеграции, а не заменяют их.
Через RAG (Retrieval-Augmented Generation) к платформе подключают всё, что не лежит в реляционной модели, то есть регламенты, стандарты, переговорные прецеденты, аналитические отчёты, инструкции, шаблоны писем и методологии. Агент задаёт семантический поиск по индексу, получает релевантные фрагменты и опирается на них, когда строит ответ.
В крупной сети документы редко лежат в одном месте. Они разбросаны по SharePoint, Confluence, общим папкам, корпоративному порталу и почтовым архивам. Поэтому в RAG-контуре обычно работает не один коннектор, а сборщик, который ходит по нескольким источникам, нормализует контент, разбивает его на фрагменты и поддерживает индекс актуальным.
На пилоте RAG время экономят четыре приёма.
Не индексируйте всё подряд. Сначала закрываются конкретные сценарии, например регламенты переговоров, прецеденты по поставщикам, шаблоны коммерческих писем и антикризисные протоколы. Индекс «вообще все документы компании» обычно не работает.
Контролируйте права доступа. Индекс должен помнить, к какому фрагменту у какого сотрудника есть доступ, иначе агент случайно покажет менеджеру коммерческой дирекции содержимое HR-документов. Подробнее эта тема разобрана в 05-architecture, раздел «Безопасность и права доступа».
Поддерживайте свежесть индекса. Регламенты обновляются, и устаревший фрагмент в ответе агента это уже ошибка. Для этого индекс переиндексируют по расписанию и обновляют инкрементально, когда появляются новые документы.
Фиксируйте источник в каждом ответе. Когда агент опирается на фрагмент из регламента, в ответе должна стоять ссылка на конкретный документ и страницу, иначе сотрудник не сможет проверить ответ, а платформа потеряет доверие.
Это стандартный для современных LLM механизм, в котором модель сама решает, какую функцию вызвать и с какими параметрами, а платформа исполняет вызов и возвращает результат в контекст. На уровне архитектуры это та конструкция, через которую агент превращает желание (получить данные, выполнить действие) в реальный вызов конкретного инструмента.
При проектировании функций для агентов имя и описание пишут для модели, а не для разработчика. Нечёткое описание приводит к тому, что модель применяет функцию не туда. Параметры строго типизированы, потому что свободный JSON быстро превращается в источник ошибок. Возвращаемый результат структурирован одинаково для похожих функций, иначе агент учится вручную пересобирать ответы. Каждая функция атомарна и закрывает одно действие. «Универсальная функция работы с заказами» это плохая идея, по тем же причинам, по которым плохая идея универсальный агент.
Подробнее про инструменты и их группировку можно посмотреть в 05-architecture, раздел «Инструменты агентов».
Model Context Protocol и его аналоги стали в 2025 году стандартом для подключения корпоративных систем к LLM-приложениям. К концу 2025 и началу 2026 MCP поддерживается всеми крупными провайдерами моделей, и для большинства распространённых корпоративных систем уже есть готовые серверы.
В терминах платформы MCP-сервер и есть коннектор. Это удобно по нескольким причинам. Один коннектор подключается один раз, а пользоваться им могут все агенты в пределах своих прав. Авторизация и квоты управляются на уровне сервера, а не вшиваются в каждого агента. Замена провайдера модели не ломает интеграцию, потому что протокол стандартизованный.
В ритейле это работает так. У сети есть DWH, BI, ERP и WMS. Платформа поднимает четыре MCP-сервера (или использует готовые от поставщика). Дальше Text2SQL получает право читать данные через сервер DWH, агент мониторинга и аномалий читает из DWH через тот же сервер, а агент OOS берёт оттуда остатки и поставки. Доступ к серверу WMS агент OOS получает только по отдельно согласованному сценарию, где нужна свежесть данных. Когда в каталоге появляется новый агент, он получает доступ к нужным серверам через инструментальную политику, и подключение готово.
Право пользоваться коннектором ещё не значит пользоваться им без ограничений. Доступ к каждой интеграции проходит через ту же иерархию инструментальных политик, что и любой другой инструмент агента. На каждом уровне (платформа, провайдер модели, агент, сотрудник, субагент, песочница) разрешения можно только сузить, но не расширить. Полное устройство этой иерархии с разбором каждого уровня и таблицей политик разобрано в 05-architecture, раздел «Инструментальные политики».
На практике это значит, что один коннектор к DWH подключают на уровне платформы, а право обращаться к нему получают только те агенты, которым он нужен для задачи. Text2SQL и агент OOS читают из хранилища, а агенту базы знаний и регламентов тот же коннектор недоступен, потому что он работает с корпусом документов. Так одна интеграция обслуживает несколько агентов, и при этом каждый видит ровно тот срез, который ему положен.
Состояние каждого подключения видно администратору и агентам. Платформа регулярно проверяет коннекторы и помечает их как рабочие, требующие внимания (например, истекла авторизация) или недоступные. Агент, чей источник недоступен, сообщает об этом в ответе, а не возвращает молча неполный результат. Права выдаются явно по матрице «коннектор × агент», и администратор в одном месте видит, какие агенты имеют доступ к какому источнику.
Личные и общие подключения. Личное подключение работает под учётной записью сотрудника через делегированный доступ к его почте, календарю и файлам. Сотрудник подключает его сам, и Напарник видит ровно то, что видит сотрудник. Общее подключение работает под сервисной учётной записью, его настраивает администратор платформы, а агенты пользуются им по инструментальным политикам. Так, например, работает подключение к хранилищу для Text2SQL. Если задаче нужно личное подключение, которого у сотрудника нет, карточка переходит в статус «ждёт человека», и сотрудник видит в списке «Требует моего внимания», что именно нужно подключить.
Режимы действий. Чтение и действия коннектора настраиваются раздельно. Каждое действие стоит в одном из трёх режимов. Оно либо разрешено, либо идёт с подтверждением, либо выключено. Действия с внешним эффектом по умолчанию идут с подтверждением, режим «разрешено» для них возможен только в границах Tier-модели. Новые действия, которые появились у MCP-сервера после обновления, выключены, пока их не проверит администратор. Сотрудник может для своего Напарника только сузить режим, то есть выключить действие или поставить его под подтверждение (см. 05-architecture, раздел «Инструментальные политики»).
Стартовый набор интеграций должен закрывать сценарии пилота и не требовать инфраструктуры, которой у заказчика ещё нет. Для большинства крупных торговых сетей этот набор устроен примерно одинаково и состоит из пяти позиций.
| Интеграция | Что даёт на старте | Связанные агенты и сценарии |
|---|---|---|
| DWH, Data Lake, Lakehouse | Аналитическая фактура по продажам, марже, остаткам, ценам и промо. Без этого не работает ни один аналитический сценарий. | Text2SQL, агент мониторинга и аномалий, агент промо, агент финансового эффекта. Сценарии 1 и 2, сценарий 3 при наличии данных по акциям. |
| Корпоративные документы и регламенты | RAG-контур для прецедентов, регламентов и стандартов. Главный источник «что у нас уже было в похожих ситуациях». | Агент базы знаний и регламентов, через него скилл переговоров Напарника (за прецедентами). Сценарий 1. |
| Корпоративный мессенджер, почта, календарь | С Напарником работают в двух каналах, в мессенджере и на веб-портале платформы. Почта и календарь дают входящие сигналы и слоты для встреч, а письма и бронирования уходят после подтверждения. | Все Напарники, их скиллы почты и календаря. Агент встреч и follow-up подключается после пилота. Сценарий 1. Сценарий 5 становится доступен после включения межнапарниковой коммуникации на Фазе 3. |
| BI-системы | Готовые расчёты и нормализованные витрины, поверх которых проще разбирать отклонения и формировать презентации. | Text2SQL, агент мониторинга и аномалий, генерация презентаций. |
| Таск-трекер или доски платформы | Точка фиксации действий и follow-up. Без неё договорённости теряются между мессенджером и почтой. Если трекера у команды нет, договорённости фиксируются карточками на досках платформы, и интеграция на старте не нужна. | Скилл Напарника для контроля договорённостей, а на следующих фазах к нему добавляется агент встреч и follow-up. |
Этот набор сознательно не включает ни ERP, ни WMS, ни систему ценообразования. Они подключаются на следующих фазах под конкретные сценарии. На старте пилота их отсутствие не блокирующее, потому что данные о поставках и SLA как правило уже доступны в DWH через регулярные выгрузки.
Фазы внедрения описаны в 07-roadmap. Для интеграций они выглядят так.
| Фаза | Что подключают |
|---|---|
| Фаза 0, подготовка | Сервисные учётные записи, сетевой доступ, согласование с ИБ и владельцами систем, в том числе для почты и календаря. Если семантического слоя или каталога данных нет, здесь же описывают основные метрики и поля хранилища. |
| Фаза 1, пилот | Пять позиций MVP. Почта и календарь работают на чтение, письма и бронирования уходят после подтверждения. Семантический слой подключают вместе с DWH, если он есть. Систему промо-планирования подключают на чтение, если агент промо входит в стартовый набор, а параметров акций нет в хранилище. |
| Фаза 2, расширение | ERP, WMS и TMS через выгрузки в хранилище и точечные прямые подключения, ценообразование, данные конкурентов, ВКС с расшифровками встреч, CRM или SRM, если они есть. |
| Фаза 3, масштабирование | Системы новых ролей и подразделений, внешние источники под новые сценарии. Межнапарниковая коммуникация идёт внутри платформы и отдельных интеграций не требует. |
Каждое подключение требует подготовки на стороне системы, и её лучше начинать на Фазе 0, потому что согласования обычно идут дольше самой технической работы.
Справочник не претендует на полноту. Он показывает типовые системы крупной сети, и на него можно опираться в разговоре с заказчиком. Конкретный список собирается под заказчика, и далеко не все интеграции из него имеет смысл строить.
Это главный источник аналитических данных для платформы. В крупных российских сетях это чаще всего Greenplum, ClickHouse, реже PostgreSQL или Vertica. Постепенно растёт доля решений на базе Lakehouse (Apache Iceberg, Delta Lake) поверх объектного хранилища.
Платформа подключается к DWH только на чтение. Через него работают Text2SQL, агент мониторинга и аномалий, агент промо, агент финансового эффекта и агент OOS (карточки агентов и их инструментальные политики разобраны в 03-agents). Семантический слой поверх DWH (если он есть) подключается отдельно и используется агентами для интерпретации полей и метрик.
Агенты, особенно в проактивном цикле, создают в DWH собственный поток запросов. Его объём замеряют на пилоте и закладывают в проектирование. Под этот поток выделяют отдельную сервисную учётную запись и очередь ресурсов, а частые запросы кэшируют на стороне платформы.
Из ERP приходят договоры, поставки, заказы, контрактные условия и многие корпоративные справочники. В российских сетях это чаще всего 1С в одной из конфигураций, реже SAP S/4HANA, Oracle EBS или собственная разработка.
По общему принципу (см. врезку «Про прямое чтение из бизнес-критичных систем» в разделе «Принципы интеграции») платформа берёт данные ERP из его регулярных выгрузок в DWH. Прямое подключение к ERP оправдано только там, где задержка в выгрузке принципиально мешает сценарию или где нужна запись (например, обновление статуса заказа). В этих случаях интеграция собирается точечно, под узкий список операций, и согласуется с владельцем системы. Запись в ERP подключается под Tier 2.
Для 1С есть универсальный подход, который не требует писать коннектор под каждую конфигурацию. Коннектор отдаёт агенту метаданные конфигурации (справочники, документы, регистры), и агент строит запрос на языке запросов 1С так же, как Text2SQL строит SQL к хранилищу. Ограничения те же, что у прямого чтения любой бизнес-критичной системы. Нужны отдельный пользователь только на чтение, проверка запроса перед выполнением и контроль нагрузки на рабочую базу. Пускать ли агентов к рабочей базе 1С напрямую, пока открытый вопрос (см. «Открытые вопросы»).
CRM хранит работу с поставщиками и клиентами, а именно историю контактов, контракты и активные сделки. CDP собирает данные о поведении покупателей сети, программе лояльности и отклике на промо.
В коммерческой дирекции крупной сети CRM иногда отсутствует как отдельная система, и её роль закрывают почта, Excel и заметки в мессенджере. В таких случаях коннектор к CRM не нужен, а профили поставщиков ведутся в личной памяти Напарника (как Напарник ведёт профили контрагентов и коллег, описано в 02-partner, раздел «Уровень 3. Коммуникационный помощник»). В сетях со зрелой CRM коннектор полезен для подготовки к переговорам. Историю контактов и контракты из неё берёт скилл переговоров Напарника, а в целевом каталоге их берёт агент переговоров.
PIM хранит атрибуты товаров, MDM хранит мастер-данные по поставщикам, контрагентам, локациям. Эти системы подключаются для сценариев, в которых нужна точная атрибутика, например для разбора ассортиментной матрицы или подготовки к листингу нового SKU.
На стартовом наборе MVP эти интеграции обычно избыточны. Они подключаются ближе к зрелости платформы, когда коммерческий контур уже работает.
SRM это система управления отношениями с поставщиками. В ней ведут профили поставщиков, контракты, KPI поставщика и тендеры. У большинства крупных сетей SRM как отдельной системы нет. Если она есть, коннектор к ней полезен для подготовки к переговорам, потому что профиль поставщика больше не приходится собирать по почте и трекерам.
WMS отвечает за склады, остатки, фактические поставки и SLA по поставщикам. TMS отвечает за транспорт. Остатки, поставки и SLA для агента OOS и агента мониторинга и аномалий чаще всего читаются из DWH, куда WMS их регулярно выгружает.
Прямое подключение к WMS оправдано только там, где сценарию принципиально нужна свежесть, которую выгрузки в DWH не обеспечивают (например, оперативная картина по конкретному РЦ в момент срыва поставки), и собирается точечно по общему принципу (см. раздел «Принципы интеграции»). Запись в WMS по умолчанию закрыта. Изменения поставок идут через стандартные маршруты компании. Агент OOS готовит рекомендацию, а Напарник после подтверждения логиста или менеджера оформляет запрос ответственной службе (Tier 2). Прямая запись, в том числе стандартное переключение между РЦ как автономное действие Tier 3 (см. примеры классификации по Tier), подключается только по отдельно согласованному сценарию. Это сознательное архитектурное ограничение, которое снижает риск неоткатываемых ошибок.
BI как правило уже работает в сети и закрывает регулярную аналитику. На платформе BI используется двумя способами. В первом случае платформа напрямую читает те же витрины, поверх которых строятся дашборды. Это удобно, потому что витрины уже проверены. Во втором случае платформа интегрируется с самим BI-инструментом, чтобы встраивать готовые отчёты в ответы агентов и генерировать новые дашборды под конкретные ситуации.
Распространённые BI-инструменты в российских сетях включают PIX BI, Datalens, Apache Superset, реже Tableau и Power BI на отдельных контурах. Подключение к ним идёт через REST-API инструмента или через прямое чтение витрин в DWH.
Системы ценообразования содержат правила переоценки, ценовое позиционирование и эластичность спроса. На пилоте обычно не входят, потому что агентам на старте хватает исторических цен из DWH. Подключение нужно для сценариев, в которых агент должен предлагать новую цену или объяснять причину изменения.
Параметры и планы акций нужны агенту промо, который входит в стартовый набор. Если они регулярно выгружаются в DWH, агент берёт их оттуда. Если нет, чтение из системы промо-планирования подключают уже на пилоте, а если такой системы у сети нет, агента промо из стартового набора убирают (см. 03-agents). Изменения в самом плане делает менеджер по стандартному маршруту, агент только готовит обоснование.
Из маркетинг-систем приходят бюджеты, охваты и креативы рекламных кампаний. Эти данные нужны для полного разбора промо в сценарии 3, когда эффект акции оценивают вместе с медиаподдержкой. Подключаются после пилота и только под конкретного заказчика.
Через эту интеграцию агенты дотягиваются до корпоративной базы знаний, переговорных прецедентов, аналитических отчётов, инструкций, шаблонов писем и методологий. В крупной сети всё это редко лежит в одном месте, поэтому работа с группой идёт через RAG-паттерн со сборщиком по нескольким источникам, разобранный в разделе «RAG по корпоративным документам».
Через эту интеграцию работает агент базы знаний и регламентов, а скилл переговоров Напарника получает прецеденты через него. В стартовый набор эта интеграция входит, потому что без прецедентов и регламентов скилл переговоров не видит прошлых уступок и стандартов, и досье к переговорам сводится к цифрам из хранилища.
ЭДО хранит контракты, дополнительные соглашения и документы по согласованиям. Подключение нужно для сценариев, где агент должен поднять конкретный контракт или статус согласования. Интеграция чувствительная по правам и обычно идёт после стандартной RAG-интеграции с базой знаний.
Это точка фиксации задач и договорённостей между людьми. В российских сетях это часто ранее купленная Jira без поддержки вендора, всё чаще отечественные трекеры, иногда внутренний инструмент или 1С с надстройкой. Для платформы внешний трекер необязателен, и возможны два режима.
Работа агентов (разборы, расчёты, подготовка документов) в корпоративный трекер не выгружается, иначе трекер зарастёт сотнями машинных задач. Она живёт на досках платформы и в реестре задач. Задача в трекере может ссылаться на результат на платформе, но по ссылке его откроют только те, у кого есть на него права в платформе.
Это один из двух пользовательских каналов платформы наряду с веб-порталом. Напарник у сотрудника один, и в обоих каналах это он. У каждого сотрудника свой бот или личный чат с Напарником. Запросы на подтверждение Tier 2 приходят в чат кнопками и одновременно появляются в списке «Требует моего внимания» на портале. Длинные результаты, файлы и доски удобнее смотреть на портале, а мессенджер остаётся каналом быстрых вопросов и уведомлений.
В российских сетях это обычно MAX или eXpress, а в закрытых контурах Mattermost или корпоративные сборки Rocket.Chat. Мессенджер подключается через заменяемый коннектор. Конкретный мессенджер выбирают под ИТ-политику заказчика, а модель работы с Напарником от этого выбора не меняется. Подробности базового решения по каналам лежат в 01-vision, раздел «Базовые допущения концепта».
Из почты приходят письма от поставщиков, коллег и систем. Подключается через стандартные протоколы (IMAP, MS Graph, JMAP) или через корпоративную почтовую систему. Почту подключают лично для каждого сотрудника, и Напарник работает с его ящиком через делегированный доступ. Чтение почты входит в стартовый набор, потому что без него Напарник не видит входящих сигналов.
Отправка писем от имени сотрудника подключается под Tier 2. Черновик готовит Напарник, отправку подтверждает человек.
Через календарь работают сценарии встреч, бронирований и напоминаний. Подключение делается на стороне корпоративного провайдера (Microsoft 365, Google Workspace, Яндекс 360, отечественные альтернативы). Чтение слотов входит в стартовый набор, бронирование под Tier 2, а подбор общего слота через Напарников разных сотрудников разбирается в 04-usecases, разделе «Сценарий 5. Межфункциональная встреча через Напарников».
Сюда относятся Zoom, Microsoft Teams, Яндекс.Телемост, отечественные альтернативы. Платформа подключается к ним через корпоративный API или через бот-участника. Этот коннектор нужен для сценариев записи встречи, последующего разбора расшифровки и генерации follow-up. На пилоте Напарник работает с готовыми расшифровками, которые присылает сотрудник, а коннектор к ВКС и бот-участник встречи подключаются на Фазе 2 вместе с агентом встреч и follow-up.
Подсказки в реальном времени на встрече требуют отдельной обвязки и обычно подключаются позже, как продвинутый сценарий. Подробности этой темы собраны в 02-partner, раздел «Уровни зрелости ИИ-Напарника».
Сюда входят цены, ассортимент, активные акции и наличие в магазинах конкурентов. В сетях это часто отдельный сервис парсинга или внешний поставщик. Коннектор подключается для агента ценообразования и конкурентного мониторинга. В каталоге этот агент относится к развитию после стартового набора, но под конкретного заказчика может заменить в стартовом наборе агента промо.
Если сеть продаёт через собственный интернет-магазин или маркетплейсы, оттуда приходят продажи и остатки по онлайн-каналу, цены и акции на площадках, отзывы и рейтинги товаров. Подключение идёт через API площадок или через выгрузки в хранилище. Эти данные нужны для разбора продаж по каналам, а также агенту ценообразования и конкурентного мониторинга. На пилоте такая интеграция обычно не нужна.
Сюда входят индексы цен на сырьё и упаковку, отраслевые отчёты, валютные курсы и макроэкономические показатели. Коннектор полезен для подготовки к переговорам. На эти данные опирается аргументация скилла переговоров Напарника, а в целевом каталоге на них опирается агент переговоров. Источники могут быть платными (CRU, ICIS), бесплатными (Росстат, профильные СМИ) или внутренними индексами компании.
Сюда входят открытые данные конкретных поставщиков, а именно финансовая отчётность, новости, тендерная активность и изменения в собственности. Коннектор полезен для подготовки к переговорам и для оценки рисков по поставщику. На пилоте эта интеграция обычно не нужна, потому что для подготовки к переговорам хватает корпоративных данных.
К открытым источникам относятся веб-поиск, агрегаторы новостей и отраслевые форумы. Они подключаются через стандартные поисковые API и оборачиваются защитной разметкой как источник недоверенного контента.
Ниже ограничения, с которыми столкнётся реальное внедрение, и что с ними делать.
| Ограничение | Описание | Что делать |
|---|---|---|
| Зрелость API у систем | У части корпоративных систем API ограниченный или его вовсе нет. Особенно у проприетарных российских ERP и специфичных WMS. | На старте идти через DWH-выгрузки. API подключать в момент, когда без него блокируется конкретный сценарий. |
| Качество данных | Если в DWH есть пустые поля, расхождения между справочниками или неактуальные витрины, агенты будут возвращать некачественные результаты. | Подключать проверки качества данных (сервисный агент для них назван в 03-agents, но карточка агента пока не проработана), фиксировать критичные витрины и согласовывать SLA с владельцами данных. |
| Доступ и комплаенс | Часть данных попадает под дополнительные требования (персональные данные клиентов, финансовые детали, переписка с внешними контрагентами). Подключение требует согласований. | Персональные данные клиентов и финансовые детали контрактов выносятся из MVP и подключаются точечно после согласования с информационной безопасностью. Почта и календарь, где лежит переписка с контрагентами, входят в MVP на чтение, а их согласование с ИБ проходит на Фазе 0. |
| Нагрузка на источники | Проактивный цикл и параллельная оркестрация создают собственный поток запросов к DWH и BI. Без подготовки это может ухудшить работу штатной аналитики. | Выделить отдельную сервисную учётную запись и очередь ресурсов, кэшировать частые запросы на стороне платформы. |
| Версионирование интерфейсов | Изменение API на стороне поставщика без согласования ломает работу платформы. | Версия API фиксируется явно, обновления проходят через регрессионный прогон агентов на тестовом контуре. |
| Устаревание индекса в RAG | Устаревший фрагмент в ответе агента уже ошибка, подробнее в разделе «RAG по корпоративным документам». | Регулярно переиндексировать и дополнять индекс инкрементальными обновлениями, а в каждом ответе агента фиксировать дату документа. |
Здесь темы, по которым у концепта пока нет финального ответа. Часть из них требует отдельной проработки, часть решается только под конкретного заказчика.
📄 Скачать эту страницу в Markdown (файл .mdx удобно передать ИИ-агенту или читать офлайн)