Вызов функций упрощает получение структурированных выходных данных из генеративных моделей. Затем вы можете использовать эти выходные данные для вызова других API и возврата соответствующих данных ответа в модель. Другими словами, вызов функций помогает подключить генеративные модели к внешним системам, чтобы сгенерированный контент содержал самую актуальную и точную информацию.
Вы можете предоставить модели Gemini описания функций. Это функции, которые вы пишете на языке вашего приложения (то есть они не являются облачными функциями). Модель может попросить вас вызвать функцию и отправить результат обратно, чтобы помочь модели обработать ваш запрос.
Подробнее о вызове функций можно узнать в документации Google Cloud.
При желании вы можете вызвать API Vertex AI Gemini на стороне сервера, используя серверные SDK Vertex AI или расширения Firebase для API Gemini .
При желании вы можете попробовать альтернативную версию Gemini API «Google AI», которая обеспечивает бесплатный доступ (в пределах ограничений и там, где это возможно) с использованием Google AI Studio и Google AI SDK .
Если вы решите использовать инструменты и сервисы Google AI, а также Firebase, мы рекомендуем следующее:
- Не используйте Google AI Studio и Google AI SDK с проектом Firebase , который используется вашим рабочим приложением .
- Ознакомившись с тем, как работает API Gemini, перейдите на Vertex AI для Firebase SDK , который имеет множество дополнительных функций, важных для мобильных и веб-приложений, например защиту API от злоупотреблений с помощью Firebase App Check .
Прежде чем вы начнете
Если вы еще этого не сделали, ознакомьтесь с руководством по началу работы с Vertex AI для Firebase SDK . Убедитесь, что вы выполнили все следующее:
Настройте новый или существующий проект Firebase, включая использование тарифного плана Blaze и включение необходимых API.
Подключите свое приложение к Firebase, включая регистрацию вашего приложения и добавление конфигурации Firebase в ваше приложение.
Добавьте SDK и инициализируйте службу Vertex AI и генеративную модель в своем приложении.
После того как вы подключили свое приложение к Firebase, добавили SDK и инициализировали службу Vertex AI и генеративную модель, вы готовы вызвать Gemini API.
Настройка вызова функции
В этом руководстве модель будет взаимодействовать с гипотетическим API обмена валюты, который поддерживает следующие параметры:
| Параметр | Тип | Необходимый | Описание |
|---|---|---|---|
currencyFrom | нить | да | Валюта для конвертации |
currencyTo | нить | да | Валюта для конвертации в |
Пример запроса API
{
"currencyFrom": "USD",
"currencyTo": "SEK"
}
Пример ответа API
{
"base": "USD",
"rates": {"SEK": 10.99}
}
Шаг 1. Создайте функцию, которая выполняет запрос API.
Если вы еще этого не сделали, начните с создания функции, которая отправляет запрос к API.
В демонстрационных целях в этом руководстве вместо отправки фактического запроса API вы будете возвращать жестко закодированные значения в том же формате, который возвращал бы реальный API.
Шаг 2. Создайте объявление функции.
Создайте объявление функции, которое вы передадите в генеративную модель (следующий шаг этого руководства).
Включите как можно больше подробностей в описания функций и параметров. Генеративная модель использует эту информацию, чтобы определить, какую функцию выбрать и как предоставить значения параметров при вызове функции.
Шаг 3. Укажите объявление функции во время инициализации модели.
Укажите объявление функции при инициализации генеративной модели, установив параметр tools модели:
Узнайте, как выбрать модель Gemini и, при необходимости, местоположение , подходящее для вашего варианта использования и приложения.
Шаг 4. Создайте вызов функции.
Теперь вы можете запросить модель с определенной функцией.
Рекомендуемый способ использования вызова функций — через интерфейс чата, поскольку вызовы функций хорошо вписываются в многоходовую структуру чата.
Что еще можно сделать?
Попробуйте другие возможности Gemini API
- Стройте многоходовые беседы (чат) .
- Генерация текста из текстовых подсказок .
- Генерируйте текст из мультимодальных подсказок (включая текст, изображения, PDF-файлы, видео и аудио).
Узнайте, как контролировать создание контента
- Понимание структуры подсказок , включая лучшие практики, стратегии и примеры подсказок.
- Настройте параметры модели, такие как температура и токены максимальной мощности.
- Используйте настройки безопасности , чтобы настроить вероятность получения ответов, которые могут быть расценены как вредные.
Узнайте больше о моделях Gemini
Узнайте о моделях, доступных для различных вариантов использования , а также об их квотах и ценах .Оставьте отзыв о своем опыте использования Vertex AI для Firebase.