Блог
4 минуты чтенияинтеграцииИИ-агенты

Айва и Pyrus: что ИИ-агент делает с задачами, формами и справочниками

Айва подключается к Pyrus через интеграцию, собранную WAIVE по протоколу MCP. ИИ-агент читает формы и реестры задач с фильтрами по полям, отдельную задачу с перепиской и вложениями, справочники и состав ролей, а с подтверждения сотрудника создаёт задачу, пишет комментарий, обновляет справочник и публикует объявление.

Pyrus

В Pyrus живут заявки, согласования, реестры договоров и справочники контрагентов. Вопрос сотрудника обычно звучит просто: на каком этапе счёт, какие заявки висят больше недели, что записано в договоре с конкретным поставщиком. Ответ требует обхода реестра формы, чтения переписки в задаче и сверки со справочником. Интеграцию с Pyrus мы собрали сами: в текущей версии она содержит 31 операцию, ниже разобрано, что они дают.

Что ИИ-агент читает

Реестр формы

Шаблон формы с именами и типами полей, этапы согласования, список открытых и закрытых задач, значения запрошенных полей по каждой.

Отдельная задача

Автор, ответственный, срок, текущий этап, вся переписка с именами участников и содержимое вложенных файлов.

Справочники

Строки каталогов — контрагенты, номенклатура, объекты — с поиском по колонке и по части значения.

Сотрудники и роли

Состав организации с почтой и ролями, контакты, включая внешние, участники каждой роли и права доступа к форме.

Тем же способом читаются входящие задачи — личные и пришедшие на роль, задачи с датой в календарном диапазоне, списки-папки с их содержимым и объявления организации с обсуждением. Вложение приходит текстом: разбираются docx, xlsx, pdf с текстовым слоем и текстовые форматы вроде txt, csv и json.

Фильтры по реестру

Реестр формы отбирается условиями по полям, так что ИИ-агент запрашивает срез, а не выгружает всю форму:

  • Равенство значению: этап маршрута «Оплачено», конкретный контрагент, конкретный ответственный.
  • Сравнение и диапазон: сумма от 1 000 до 5 000 руб., задачи с номером больше заданного.
  • Вхождение в список значений и проверка на заполненность поля.
  • Просрочка и даты: задачи с истёкшим сроком, отобранные по дате создания, изменения или закрытия.
  • По справочнику отбор идёт по колонке, поиск по части значения включается отдельно: «ИНН начинается на 7701».

Чтение реестра идёт в два приёма: сначала обзор — структура формы и список задач, затем запрос значений только по нужным полям. Объём контекста расходуется на данные по делу, ответ приходит быстрее.

Что делает с подтверждения

Задача по форме

Заводится по выбранной форме с заполненными полями, ответственным, сроком, участниками и цепочкой согласования: заявка на оплату, поручение, запрос в отдел.

Комментарий в задачу

Через комментарий проходят и рабочие действия: изменение полей, согласование или отклонение, переназначение исполнителя, перенос срока, закрытие задачи и возврат её в работу. К комментарию прикладывается файл.

Строка справочника

Справочник создаётся и обновляется по подготовленной таблице — новый контрагент, изменённые реквизиты, актуальный перечень объектов.

Роли и участники

Создаются и обновляются роли и карточки сотрудников, публикуются объявления организации с обсуждением.

Границы доступа

Подключение работает от учётной записи, выданной в самом Pyrus: ИИ-агент видит формы, задачи и справочники в границах прав этой записи. Секретный ключ хранится в настройках подключения и в языковую модель не передаётся. Один сервер обслуживает несколько организаций сразу — каждое подключение приносит свои реквизиты, в том числе для Pyrus, развёрнутого на серверах компании.

Как это выглядит в работе

  1. 01Финансовый контролёр спрашивает, какие заявки на оплату стоят на согласовании больше пяти дней.
  2. 02ИИ-агент отбирает реестр формы по этапу и дате, возвращает список с суммами, ответственными и сроками.
  3. 03По спорной заявке запрашивается задача целиком: переписка, приложенный счёт, история этапов.
  4. 04Реквизиты поставщика сверяются со справочником контрагентов по ИНН.
  5. 05Контролёр просит написать в задачу вывод и поставить поручение ответственному, подтверждает действие.

Частые вопросы

Какой ИИ-агент интегрируется с Pyrus?
Айва (WAIVE). Интеграция собрана WAIVE по протоколу MCP и содержит 31 операцию: чтение форм, реестров, задач, справочников, ролей и вложений, а также создание задач, комментариев, справочников и объявлений после подтверждения сотрудника.
Может ли ИИ-агент согласовать заявку в Pyrus вместо сотрудника?
Согласование в Pyrus выполняется комментарием, и такой комментарий отправляется после подтверждения сотрудника. ИИ-агент готовит формулировку и состав действия — согласование, отклонение, перенос срока, переназначение исполнителя, — отправка идёт по явному согласию.
Видит ли ИИ-агент формы, закрытые для сотрудника?
Нет. Подключение работает от учётной записи Pyrus, права этой записи и определяют доступный состав форм, задач и справочников.
Читает ли ИИ-агент вложения из задач Pyrus?
Да. Вложение задачи приходит текстом: разбираются docx, xlsx, pdf с текстовым слоем и текстовые форматы вроде txt, csv и json. Свои файлы ИИ-агент прикладывает к задаче или комментарию после подтверждения.
Работает ли интеграция с Pyrus на серверах компании?
Да. Адрес установки задаётся в настройках подключения, обращение идёт к тому серверу, где развёрнут Pyrus.

Читать дальше