Почта России: ИИ-агент для адресов и индексов

Почта России публикует API отправителя: заказы, партии, документы и справочники отделений. Для агента здесь важнее всего справочная часть — адреса, индексы и коды качества, на которых держится корректная отправка.

Агент — программа, которая делает дело целиком, а не отвечает на вопрос. Три признака: работает в ваших сервисах, доводит до результата, работает без вас. Чат-бот расскажет, как писать индекс, агент вернётся с исправленной таблицей адресов и списком отделений.

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

Коннектор — описание подключения: где взять токен, как проверить связь, какие данные доступны. Не плагин и не доработка: вы один раз выдаёте токен приложения и ключ пользователя, и агент работает в рамках этого доступа.

Пароль от кабинета он не хранит: доступ живёт на выданном ключе и в любой момент отзывается в кабинете.

API отправителя покрывает заказы, пользовательские сессии, партии, документы и справочники. Отдельный блок — данные: нормализация адреса, ФИО и телефона с кодами качества, расчёт пересылки по параметрам отправления, текущее количество запросов по API. Есть поиск отделений по индексу, адресу и координатам, поиск индексов в населённом пункте и выгрузка из паспорта ОПС.

### Своя система по API: чтение и запись

Агент обращается к API по токену и забирает справочные данные: нормализует адрес, проверяет ФИО и телефон, находит индекс и отделение. Результат он складывает в вашу систему или таблицу — тот слой, который раньше писали разработчики под каждый отчёт. Авторизация двухступенчатая: токен приложения и ключ пользователя, оба берутся в кабинете. Так справочник остаётся актуальным без ручной выгрузки.

### Пересчёт чужой таблицы: найти ошибку

Самая частая работа с адресами — сверить чужой список с базой отделений. Агент проходит строку за строкой: адрес нормализуется, индекс существует, населённый пункт и улица совпадают, отделение обслуживает этот адрес. На выходе — таблица с расхождениями и причиной по каждой строке, а не сообщение об ошибке без адреса. Спорные строки агент помечает отдельно, чтобы вы смотрели только их.

### Индексация и техошибки: список правок

Когда адреса и точки на карте — часть вашей витрины, агент собирает замечания: индекс не найден, адрес распознан частично, отделение закрыто, код качества низкий. Перечень правок с приоритетом заменяет ручной перебор, а код качества нормализации показывает, где ошибка в написании, а где в самом адресе. Приоритет агент ставит по числу затронутых строк, адресов и отделений.

Спорный адрес, дом с несколькими индексами и решение по нестандартной доставке подтверждает человек. Агент показывает варианты с кодами качества и ждёт выбора: он не переписывает адрес в базе сам.

Доступ берётся в личном кабинете отправителя: там выдаются токен приложения и ключ авторизации пользователя. Проверка связи — один запрос нормализации адреса: если вернулся адрес с кодом качества, доступ работает. Отдельно в API видно текущее количество запросов, чтобы не выйти за лимит.

Не отправляет и не оплачивает отправления. Не обходит лимиты запросов. Не исправляет адреса в вашей базе без подтверждения: только готовит список правок.

Что такое агент, если коротко? Программа, которая делает дело целиком и возвращается с результатом: исправленной таблицей адресов, найденным индексом, списком правок. Она меняет данные, а не просто отвечает текстом.

Что такое коннектор? Описание подключения: где взять токен, как проверить связь, какие данные доступны. Вы выдаёте ключ один раз, и агент работает в рамках этого доступа, не забирая пароль.