> For the complete documentation index, see [llms.txt](https://docs.onerpa.ru/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.onerpa.ru/ai-platforma-oneapa/provajdery-llm/yandex-gpt.md).

# Yandex GPT

Настройка Yandex GPT в качестве LLM провайдера для OneAPA.

## Обзор

**Yandex GPT** — российский облачный сервис языковых моделей от Яндекса.

### Преимущества

| Преимущество              | Описание                           |
| ------------------------- | ---------------------------------- |
| Русский язык              | Отличное качество работы с русским |
| Российский провайдер      | Хранение данных в РФ               |
| Интеграция с Yandex Cloud | Единая экосистема                  |
| Доступная цена            | Ниже чем у OpenAI                  |

### Ограничения

| Ограничение | Описание                           |
| ----------- | ---------------------------------- |
| Нет Vision  | Не поддерживает изображения        |
| IAM токен   | Требует обновления каждые 12 часов |

## Получение доступа

### Шаг 1: Создание аккаунта

1. Зарегистрируйтесь в [Yandex Cloud](https://cloud.yandex.ru/)
2. Привяжите платёжный аккаунт
3. Активируйте грант (если доступен)

### Шаг 2: Создание каталога

1. Перейдите в консоль Yandex Cloud
2. Создайте каталог для OneAPA
3. Запомните `folder_id` — он понадобится для настройки

### Шаг 3: Включение сервиса

1. В каталоге перейдите в "Yandex Foundation Models"
2. Активируйте сервис
3. Примите условия использования

### Шаг 4: Получение IAM токена

**Через CLI:**

```bash
# Установка CLI
curl -sSL https://storage.yandexcloud.net/yandexcloud-yc/install.sh | bash

# Авторизация
yc init

# Получение токена
yc iam create-token
```

**Через API:**

```bash
curl -X POST \
  -H "Content-Type: application/json" \
  -d '{"yandexPassportOauthToken":"<OAuth_token>"}' \
  https://iam.api.cloud.yandex.net/iam/v1/tokens
```

## Настройка в OneAPA

### Создание модели

1. Откройте справочник "Модели"
2. Создайте новый элемент
3. Заполните поля:

| Поле         | Значение       |
| ------------ | -------------- |
| Наименование | Yandex GPT Pro |
| Провайдер    | Yandex         |
| Ключ         | (IAM токен)    |
| Каталог      | (folder\_id)   |
| URL          | (пусто)        |

### Пример

```
Наименование: Yandex GPT Pro
Провайдер: Yandex
Ключ: t1.9euelZqYjpqLz5aSj5mQmJONm5GQju3rnp...
Каталог: b1g9hv2loqpvuqmcm8e1
URL: 
```

## Доступные модели

| Модель               | ID                    | Описание          |
| -------------------- | --------------------- | ----------------- |
| **YandexGPT Pro**    | yandexgpt/latest      | Полная версия     |
| **YandexGPT Lite**   | yandexgpt-lite/latest | Быстрая версия    |
| **YandexGPT Pro RC** | yandexgpt/rc          | Release Candidate |

## Параметры

| Параметр    | Значение | Описание                  |
| ----------- | -------- | ------------------------- |
| temperature | 1        | Фиксировано               |
| max\_tokens | 1500     | Максимум токенов в ответе |

## Обновление IAM токена

### Проблема

IAM токен действует **12 часов**. После истечения агент перестанет работать.

### Решения

**1. Ручное обновление**

Периодически обновляйте токен в справочнике "Модели".

**2. Автоматизация через регламентное задание**

```bsl
Процедура ОбновитьIAMТокен() Экспорт
    
    // Получение нового токена
    НовыйТокен = ПолучитьIAMТокен();
    
    // Обновление в справочнике
    Модель = Справочники.APA_Модели.НайтиПоНаименованию("Yandex GPT Pro");
    Если НЕ Модель.Пустая() Тогда
        МодельОбъект = Модель.ПолучитьОбъект();
        МодельОбъект.Ключ = НовыйТокен;
        МодельОбъект.Записать();
    КонецЕсли;
    
КонецПроцедуры
```

**3. Использование сервисного аккаунта**

Создайте сервисный аккаунт с ролью `ai.languageModels.user` для более стабильной авторизации.

## Стоимость

| Модель         | Примерная стоимость      |
| -------------- | ------------------------ |
| YandexGPT Pro  | \~0.12 ₽ / 1000 символов |
| YandexGPT Lite | \~0.02 ₽ / 1000 символов |

{% hint style="info" %}
Актуальные цены смотрите на [cloud.yandex.ru/docs/yandexgpt/pricing](https://cloud.yandex.ru/docs/yandexgpt/pricing)
{% endhint %}

## Примеры использования

### Простой вопрос

```
Пользователь: Что такое ИИ?

Агент (Yandex GPT): Искусственный интеллект (ИИ) — это область 
информатики, занимающаяся созданием интеллектуальных систем, 
способных выполнять задачи, требующие человеческого интеллекта...
```

### Работа с данными 1С

```
Пользователь: Подготовь отчёт о продажах за январь

Агент (Yandex GPT): 
📊 Использую инструмент: Отчёт по продажам

Отчёт о продажах за январь 2026:

Общая выручка: 15 420 000 ₽
Количество заказов: 234
Средний чек: 65 897 ₽

Топ-3 товара:
1. Товар А — 3 200 000 ₽
2. Товар Б — 2 800 000 ₽
3. Товар В — 1 900 000 ₽
```

## Устранение проблем

### Ошибка авторизации (401)

| Причина               | Решение                          |
| --------------------- | -------------------------------- |
| Истёк IAM токен       | Обновите токен                   |
| Неверный folder\_id   | Проверьте ID каталога            |
| Сервис не активирован | Активируйте YandexGPT в каталоге |

### Ошибка квоты (429)

| Причина                 | Решение                       |
| ----------------------- | ----------------------------- |
| Превышен лимит запросов | Подождите или увеличьте квоту |
| Недостаточно средств    | Пополните баланс              |

### Медленные ответы

| Причина            | Решение                        |
| ------------------ | ------------------------------ |
| Перегрузка сервиса | Подождите или используйте Lite |
| Сетевые задержки   | Проверьте сеть                 |

## Далее

{% content-ref url="/pages/TRsFlXYWwpokhPEVyACO" %}
[OpenAI](/ai-platforma-oneapa/provajdery-llm/openai.md)
{% endcontent-ref %}
