# 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 %}


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.onerpa.ru/ai-platforma-oneapa/provajdery-llm/yandex-gpt.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.