Сколько раз ты ловил себя на мысли: «Если бы нейросеть могла не просто рассуждать о моих рабочих делах, а сама заглянуть в CRM, проверить статус оплаты контракта и прикрепить ссылку на актуальный документ из корпоративного хранилища»? Долгое время для этого приходилось либо копировать конфиденциальные выгрузки в окно диалога вручную, либо нанимать разработчиков для сборки кастомных чат-ботов поверх открытых API.
Google сделала решительный шаг навстречу бесшовной интеграции, масштабировав платформу Gemini Connected Apps. Каталог расширений вырос до более чем 50 готовых сервисов (от Slack и GitHub до Salesforce и Jira), а главное — разработчики получили возможность подключать собственные внутренние микросервисы компании через стандартизированный протокол OpenAPI 3.0. Мы уже исследовали, как устроена платформа Google Connected Apps и запуск сервисов через MCP, а сегодня разберем практическую интеграцию своего эндпоинта.
Как устроена работа Connected Apps под капотом
В основе Connected Apps лежит механизм декларативного вызова инструментов (Function Calling). Когда пользователь формулирует запрос в веб-интерфейсе или приложении Gemini — например: «Найди все открытые сделки с компанией Вектор за октябрь и выведи сумму задолженности», — модель не выдумывает цифры из головы.
Она сканирует зарегистрированные инструменты, находит подключенный коннектор к CRM, формирует валидный HTTP-запрос и передает его через защищенный шлюз. Ответ API парсится моделью и превращается в аккуратную сводную таблицу прямо в окне чата.
Ключевые принципы архитектуры Connected Apps:
- Динамический выбор инструментов: Модель сама решает, в какой из 50 подключенных сервисов отправить запрос на основе семантики промпта.
- Сериализация ответов в структурированный контекст: Сложные вложенные JSON-ответы фильтруются и передаются в контекстное окно в компактном виде, экономя токены.
- Бесшовная аутентификация через OAuth 2.0: Пользователю достаточно один раз связать учетные записи в настройках безопасности Google Workspace.
- Кэширование схем: Спецификации OpenAPI загружаются один раз при инициализации сессии и не расходуют входящий лимит контекстного окна при каждом диалоге.
Регистрация кастомного корпоративного инструмента
Давай посмотрим, как подключить к Gemini собственный внутренний API для поиска сделок. Для этого создается манифест спецификации в формате OpenAPI:
openapi: 3.0.3
info:
title: Corporate CRM Connector for Gemini
description: Предоставляет Gemini доступ к поиску контрактов и истории сделок
version: 1.0.0
servers:
- url: https://api.crm.internal-corp.com/v1
paths:
/deals/search:
get:
summary: Поиск сделок по ключевым словам и контрагенту
operationId: searchDeals
parameters:
- name: clientName
in: query
required: true
description: Наименование компании клиента
schema:
type: string
example: "ООО Вектор"
- name: status
in: query
required: false
description: Статус сделки
schema:
type: string
enum: ["lead", "in_progress", "won", "closed"]
responses:
'200':
description: Список найденных сделок
content:
application/json:
schema:
type: object
properties:
totalFound: { type: integer }
deals:
type: array
items:
type: object
properties:
dealId: { type: string }
amountRub: { type: number }
status: { type: string }
Проверить доступность и корректность ответов твоего эндпоинта перед публикацией в каталоге Connected Apps можно стандартной консольной утилитой curl:
# Проверка ответа CRM API для интеграции с Connected Apps
curl -X GET "https://api.crm.internal-corp.com/v1/deals/search?clientName=%D0%9E%D0%9E%D0%9E+%D0%92%D0%B5%D0%BA%D1%82%D0%BE%D1%80&status=in_progress" -H "Authorization: Bearer test_service_token_4091" -H "Accept: application/json"
Безопасность данных и защита от случайных действий
Главный камень преткновения при интеграции языковых моделей с боевыми бизнес-системами — безопасность:
- Разделение прав на чтение и запись: Для всех методов, модифицирующих данные (
POST,PUT,DELETE), в Gemini Connected Apps предусмотрен обязательный шаг явного подтверждения человеком (Confirmation Screen). Модель никогда не спишет средства и не удалит контакт втихую. - Изоляция учетных данных: Сервис использует токены OAuth 2.0 с ограниченным временем жизни. Прямой доступ к мастер-паролям сотрудников у модели отсутствует.
- Защита от утечки в обучающие выборки: Для корпоративных пользователей Workspace Enterprise действует строгое соглашение: данные, проходящие через коннекторы Connected Apps, не используются для обучения базовых моделей Google.
- Журнал аудита действий: Администратор безопасности тенанта видит полный след каждого вызова: какой пользователь задал вопрос, какой эндпоинт дернула Gemini и какие данные вернул сервер.
Connected Apps превращают Gemini из эрудированного собеседника в полноценный операционный центр, избавляя сотрудников от бесконечного переключения между десятками корпоративных закладок.