MCP - Транзакционный агент
Адрес MCP-сервера
Тестовый контур
https://iftfintech.testsbi.sberbank.ru:9443/fintech/api/transactional-agent/mcp
Промышленный контур
https://fintech.sberbank.ru:9443/fintech/api/transactional-agent/mcp
Scope
Для доступа к этому методу в параметре scope ссылки авторизации пользователя должен быть указан сервис MCP_COMMON и MCP_TRANSACT_AGENT.
Авторизация и аутентификация
Для успешного взаимодействия вам потребуются следующие параметры:
-
TLS-сертификат: Необходим для организации защищенного канала связи и аутентификации вашего приложения.
-
Access_token: Токен доступа, который требуется передавать в заголовках.
Инструменты (Tools)
Инициация сбора данных
| Свойство | Описание |
|---|---|
| Имя | summarise.agent_check_collect |
| Описание | Инициирует получение данных из внешних и внутренних источников, их агрегацию и суммаризацию. |
| Бизнес-сценарий | Запуск процесса сбора информации по клиенту. После вызова этого инструмента необходимо периодически вызывать summarise.agent_get_data для получения результата. |
Входные параметры
Уникальный ключ идемпотентности. Формат — UUID4.
Пример: 550e8400-e29b-41d4-a716-446655440000
Текстовое сообщение к ИИ-агенту. Может содержать вопрос, инструкцию или контекст от клиента. Агент может учесть это сообщение при формировании ответа на основе собранных данных.
Пример: Подготовь сводку по клиенту за последний месяц
Получение собранных данных
| Свойство | Описание |
|---|---|
| Имя | summarise.agent_get_data |
| Описание | Получение собранных и обработанных AI-агентом данных. Если сбор данных еще не завершен — возвращается пустой ответ. |
| Бизнес-сценарий | Используется для опроса статуса обработки и получения итоговой сводки по клиенту. При успешном завершении возвращает агрегированную информацию. |
Входные параметры
Уникальный ключ идемпотентности (тот же, что использовался в check_collect).
Пример: 550e8400-e29b-41d4-a716-446655440000
Возможные значения: [business_card, client_profile, documents, documentCancel, tasklist, udkz, fskk, authority]
Фильтр по разделам. Если указать один или несколько разделов, в ответе будет полный ответ (data), сгенерированный GigaChat, только по этим разделам (остальные исключаются).
Если ни один раздел не указан, ответ вернётся с кратким резюме (short_summary) без data. Если для указанного раздела нет данных, элемент с таким integrationName не попадёт в результат.
Допустимые значения:
- business_card (готовые к выдаче бизнес-карты)
- client_profile (обновление клиентских данных)
- documents (готовые справки для выдачи)
- documentCancel (отказы по заказанным справкам)
- tasklist (готовые к выдаче документы клиента)
- udkz (задолженность клиента перед банком)
- fskk (ограничения на счетах клиента)
- authority (заканчивается срок действия доверенности)
Пример: ["business_card", "documents"]