Добавить расширение x-yc-apigateway-integration:http для интеграции с YandexGPT
-
В консоли управления
выберите каталог, в котором создали или хотите создать API-шлюз. -
В списке сервисов выберите API Gateway.
-
Выберите API-шлюз или нажмите кнопку Создать API-шлюз, чтобы создать новый.
-
В поле Спецификация нажмите значок
. -
Укажите в поле:
- Путь — относительный путь к интеграции, который будет добавлен к URL-адресу API Gateway. Переменные указывайте в фигурных скобках, например
/static/{function_id}
. Подробнее см. спецификацию OpenAPI 3.0 . - HTTP-метод — метод, который будет использоваться для взаимодействия с интеграцией.
-
Сервисный аккаунт — сервисный аккаунт для авторизации при обращении к YandexGPT API. Если у вас нет сервисного аккаунта, создайте его.
-
URI модели — URI модели, которая будет использоваться для генерации или классификации.
-
Действие — тип действия и параметры, соответствующие этому типу действия:
-
Генерация текста
:- (Опционально) Температура — определяет вариативность ответа модели: укажите значение от
0
до1
. Чем выше температура, тем более креативными и случайными будут ответы модели. Значение по умолчанию —0.3
. - (Опционально) Количество токенов — максимальное число токенов генерации. По умолчанию
5
. Позволяет при необходимости ограничить объем ответа модели.
- (Опционально) Температура — определяет вариативность ответа модели: укажите значение от
-
Классификация текста
:-
Описание задания — текстовое описание задания для классификатора.
-
Классы — список классов, к которым может относиться текст. Чтобы добавить класс, нажмите значок
.
Чтобы получить корректные результаты, используйте осмысленные названия классов. -
(Опционально) Примеры запросов — примеры текстовых запросов для классов в формате
текстовый запрос:класс
. Чтобы добавить пример, нажмите значок . Подробнее см. в разделе Классификатор Few-shot.
-
-
- Путь — относительный путь к интеграции, который будет добавлен к URL-адресу API Gateway. Переменные указывайте в фигурных скобках, например
-
Нажмите кнопку Добавить.
В поле Спецификация отобразится OpenAPI-спецификация с указанными значениями параметров.
Требования к структуре входящего запроса
Чтобы API-шлюз корректно обрабатывал входящие запросы, для них должно быть задано значение заголовка Content-Type: application/json
, а тело запроса должно иметь следующую структуру:
- Генерация текста —
{"message": "<текстовый_запрос_к_модели>"}
. - Классификация текста —
{"text": "<текст_который_нужно_классифицировать>"}
.