В этом руководстве изложены архитектурные стратегии для создания библиотек, платформ и шлюзов на основе API Gemini. В нем подробно описаны технические компромиссы между использованием официальных SDK GenAI, прямого API (REST/gRPC) и уровня совместимости OpenAI.
Это руководство пригодится, если вы разрабатываете инструменты для других разработчиков, например, для фреймворков с открытым исходным кодом, корпоративных шлюзов или агрегаторов SaaS, и вам необходимо оптимизировать их с точки зрения управления зависимостями, размера пакета или функционального соответствия.
Что такое интеграция с партнерами?
Партнером считается любой, кто занимается интеграцией между API Gemini и конечными разработчиками. Мы разделяем партнеров на четыре архетипа. Определение того, к какому из них вы больше всего соответствуете, поможет вам выбрать правильный путь интеграции.
Структура экосистемы
- Кто вы: Разработчик или сопровождающий фреймворка с открытым исходным кодом (например, LangChain, LlamaIndex, Spring AI) или языкового клиента.
- Ваша цель: широкая совместимость. Вы хотите, чтобы ваша библиотека работала в любой среде, выбранной пользователем, без возникновения конфликтов.
Платформа среды выполнения и периферийных устройств
- Кто вы: SaaS-платформы, шлюзы искусственного интеллекта или поставщики облачной инфраструктуры (например, Vercel, Cloudflare, Zapier), где выполнение кода происходит в ограниченных средах.
- Ваша цель: производительность. Вам необходима низкая задержка, минимальный размер пакета и быстрый холодный запуск.
Агрегатор
- Кто вы: Платформы, прокси-серверы или внутренние «моделевые сады», которые стандартизируют доступ ко многим различным поставщикам LLM (например, OpenAI, Anthropic, Google) в единый интерфейс.
- Ваша цель: портативность и единообразие.
Корпоративный шлюз
- Кто вы: Вы работаете во внутренних командах разработки платформ в крупных компаниях, создавая «золотые пути» для сотен внутренних разработчиков.
- Ваша цель: стандартизация, управление и унифицированная аутентификация.
Сравнение с первого взгляда
Глобальная передовая практика: Все партнеры должны отправлять заголовок x-goog-api-client независимо от выбранного пути.
| Если вы... | Рекомендуемый путь | Ключевое преимущество | Ключевой компромисс | Передовая практика |
|---|---|---|---|---|
| Корпоративный шлюз, структура экосистемы | Google GenAI SDK | Платформа Gemini Enterprise Agent Platform: соответствие стандартам и скорость. Встроенная обработка типов, аутентификации и сложных функций (например, загрузка файлов). Беспроблемная миграция в Google Cloud. | Вес зависимостей. Транзитивные зависимости могут быть сложными и находиться вне вашего контроля. Ограничено поддерживаемыми языками (Python/Node/Go/Java). | Блокировка версий. Закрепите версии SDK во внутренних базовых образах, чтобы обеспечить стабильность работы между командами. |