> ## Documentation Index
> Fetch the complete documentation index at: https://docs.layeron.ru/llms.txt
> Use this file to discover all available pages before exploring further.

# Extensions

> Как подключать внешние сервисы и расширять возможности проекта.

## Что такое Extensions

Extensions — это внешние сервисы и интеграции, которые проект может использовать для расширения функциональности: аутентификация, базы данных, API, storage, платёжные системы и многое другое.

Extensions подключаются к AI через стандартный протокол для интеграции с внешними сервисами.

## Как использовать extensions

### Выбор при генерации

При отправке запроса в чат вы можете выбрать relevant extensions в панели выбора. AI будет учитывать выбранные extensions при генерации кода.

### Автоматический выбор

Если вы не выбрали extensions вручную, AI может предложить подключить нужные сервисы на основе описания проекта.

### Установка extensions

<Steps>
  <Step title="Откройте каталог extensions">
    Перейдите в раздел Explore → Extensions или используйте поиск в чате.
  </Step>

  <Step title="Найдите нужный extension">
    Используйте категории или поиск по названию.
  </Step>

  <Step title="Установите extension">
    Нажмите "Install". Extension станет доступна для ваших проектов.
  </Step>
</Steps>

## Категории extensions

| Категория        | Примеры                      |
| ---------------- | ---------------------------- |
| Аутентификация   | Вход через email, OAuth, 2FA |
| Базы данных      | Хранение данных проекта      |
| API и интеграции | Подключение внешних сервисов |
| Storage          | Файловое хранилище           |
| Платежи          | Прием платежей               |
| Уведомления      | Telegram, Email              |
| Аналитика        | Статистика посещений         |

## Создание собственного extension

Вы можете создать свой extension, если нужна интеграция, которой нет в каталоге.

<Steps>
  <Step title="Откройте форму создания">
    Перейдите в My Extensions → Create Extension.
  </Step>

  <Step title="Определите инструменты">
    Опишите, какие операции extension предоставляет AI: их названия, параметры и описания.
  </Step>

  <Step title="Настройте промпт">
    Добавьте инструкции для AI, как использовать этот extension в контексте проекта.
  </Step>

  <Step title="Опубликуйте extension">
    Extension станет доступна в каталоге для других пользователей (опционально).
  </Step>
</Steps>

## Как это работает

Extensions подключаются к AI через стандартный протокол. Когда вы отправляете запрос с подключенным extension, AI получает доступ к дополнительным инструментам этого сервиса и использует их при генерации кода.

### Примеры интеграций

| Тип                   | Что делает                                           |
| --------------------- | ---------------------------------------------------- |
| Поиск в интернете     | Находит актуальную информацию, документацию, примеры |
| Генерация изображений | Создает картинки, иконки, фон для проекта            |
| Аутентификация        | Подключает вход через email, OAuth, 2FA              |
| Базы данных           | Настраивает хранение данных проекта                  |
| Платежи               | Подключает прием платежей                            |
| Уведомления           | Отправляет сообщения в мессенджеры и email           |

## Управление extensions в проекте

### Подключение extension к проекту

Включите extension во вкладке проекта или выберите его при отправке запроса в чат.

### Отключение extension

Отключите extension в настройках проекта, если он больше не нужен.

### Обновление extensions

Extensions обновляются автоматически. Если вы создали свой extension, вы можете обновить его версию в каталоге.

<Tip>
  Используйте extensions для реальных интеграций: аутентификации, баз данных, API. Не добавляйте ключи API в чат — храните их в Cloud Env.
</Tip>

## Troubleshooting

### Extension не работает

* Проверьте, что extension установлена и подключена к проекту
* Убедитесь, что переменные окружения для extension добавлены в Cloud Env
* Проверьте логи на наличие ошибок API

### AI не использует extension

* Убедитесь, что extension выбрана в панели выбора при отправке запроса
* Опишите в запросе, какой сервис или интеграцию вы хотите использовать
* Проверьте, что extension поддерживает нужный тип операции