# n8n-nodes-gigachat

_n8n 2.0 совместимый, используйте последний релиз_

**_Неофициальный Community узел. Разработано энтузиастами. Официальные интеграции изучайте на официальном сайте [developers.sber.ru](https://developers.sber.ru/dev)._**

n8n-nodes-gigachat (вы здесь) | [**n8n-nodes-salutespeech**](https://github.com/tomyumm-ge/n8n-salutespeech)

## Disclaimer

Все права на товарные знаки, логотипы и иные обозначения принадлежат их законным правообладателям. Товарный знак "Сбер", логотипы и наименования сервисов Сбера являются собственностью ПАО "СберБанк". Настоящий проект не является официальным продуктом Сбера и создан независимым разработчиком в некоммерческих целях.

Это программное обеспечение предоставляется "как есть", без каких-либо явных или подразумеваемых гарантий, включая, но не ограничиваясь, гарантией товарной пригодности или пригодности для конкретной цели. Автор не несёт ответственности за любые убытки, включая упущенную выгоду, возникшие в результате использования этого ПО. Используется на ваш страх и риск.

Проект носит экспериментальный характер и может быть неидеальным для Production.

## Описание

Вы находитесь в репозитории n8n узла GigaChat. Вы можете установить узел к себе в n8n, и вызывать GigaChat API на высоком уровне, без необходимости писать HTTP запросы самостоятельно.

Чтобы установить узел, перейдите в настройки n8n, вкладка Community Nodes.

📌 **Ссылка на npm**: [n8n-nodes-gigachat](https://www.npmjs.com/package/n8n-nodes-gigachat)

⭐️ Не забывайте ставить звезду на репозиторий, если узел оказался вам полезным. Давайте посмотрим, сколько нас!

![GigaChat node installation](https://raw.githubusercontent.com/tomyumm-ge/n8n-gigachat/master/screenshots/screenshot_4.png)

Буду рад фидбэку и предложениям по улучшению! 🚀

## Рекомендация блогерам

Господа, прекрасно понимаю, что все глобальные примеры базированы на узле **AI Agent**, и подключить модель через узел **GigaChat Model** может звучать крайне логично и красиво. НО я напоминаю, что **GigaChat Model** - исключительно мост между langchain-gigachat и n8n. Он не проходил строгий аудит перед выкладкой. Кроме того, я почти уверен, что там кэширование токенов либо работает очень плохо, либо не работает вообще. Таким образом, рекомендуя людям добавлять **GigaChat Model** к **AI Agent**, вы:

- Даёте не самую правильную рекомендацию
- Оставляете зрителей в заблуждении, что отечественные модели обходятся очень дорого
- Увеличиваете объём аудитории на Legacy узле, который почти невозможно сопровождать

**Что же тогда использовать?** - спросите вы. А я отвечу: 👇👇👇

### 👉 GigaChat AI

![GigaChat node](https://raw.githubusercontent.com/tomyumm-ge/n8n-gigachat/master/screenshots/screenshot_1.png)

Широкий узел, подобный AI Agent, созданный эксклюзивно под GigaChat.

**Используете в 99% случаев** именно этот узел. Он кэширует токены, что позволяет экономить вам деньги. Кэш-токены не тарифицируются!

- **Выберите модель** На выбор все модели GigaChat. Раскройте потенциал максимальной модели, или решите простую задачу базовой моделью. Выбор за вами.
- **Подключите память** Конструируете чат? Никаких проблем! Подключите память, и ни одна деталь чата не будет забыта.
- **Добавьте инструменты** Собрать личного ассистента? Подключить базу данных сделок? А может, узнать погоду в Москве? Подключайте и комбинируйте инструменты чтобы сделать ассистента ещё умнее.
- **Полный контроль или простота использования** Что нужно вам? Выбираете только вы. С помощью галочки `Simplify Output` вы можете получить как простой ответ, так и детальную сводку по расходу токенов.

### GigaChat API

![GigaChat API node](https://raw.githubusercontent.com/tomyumm-ge/n8n-gigachat/master/screenshots/screenshot_5.png)

Функциональный узел для кастомных API запросов, на манер OpenAI узлов.

- **Посмотрите на изображения** компьютерным зрением. Модель Pro и Max в вашем распоряжении.
- **Теперь GigaChat будет видеть** Ваши чаты больше не будут ограничиваться только текстом. Проанализируйте изображение, чтобы понять, что хочет донести до вас собеседник.

**Анализ изображений не работает с линейкой моделей GigaChat Lite**

### GigaChat Embeddings

![GigaChat embeddings node](https://raw.githubusercontent.com/tomyumm-ge/n8n-gigachat/master/screenshots/screenshot_2.png)

Интеграция Embeddings нужна, чтобы иметь векторное представление вашей базы знаний.

- **Экосистема** Купите пакеты токенов, и используйте модель как для чата, так и для векторизации
- **Идеально для RAG** Сделайте векторное представление ваших данных, а затем найдите ближайшее совпадение с помощью узла GigaChat.

### GigaChat Model

![GigaChat model node](https://raw.githubusercontent.com/tomyumm-ge/n8n-gigachat/master/screenshots/screenshot_3.png)

Устаревший узел из первых версий. Когда нужна органическая интеграция. Хотя узел и есть, его поддержка прекращена ввиду технических ограничений n8n, не позволяющих его развивать.

- **Native Experience** Это что у вас? ChatGPT? Нет, я всегда могу выбрать GigaChat.
- **Просто проведите линию** Не нужно переизобретать логику после переезда. Достаточно поменять заграничную модель на отечественную, в один клик.
- **Хочется большего?** Воспользуйтесь полноценном узлом из описания выше. Раскройте полный потенциал автоматизации!

#### GigaChat Model можно добавить в:

- Basic LLM Chain
- Information Extractor
- Question and Answer Chain
- Sentiment Analysis
- Summarization Chain
- Text Classifier

Не поддерживается и никогда не будет поддерживаться ввиду архитектуры n8n:

- AI Agent

Вместо него используйте наш основной **GigaChat AI** узел.

## Локальная разработка/запуск

В папке с репозиторием:

```bash
npm install
npm run build
npm link
```

В инстансе n8n

```bash
npm i -g n8n # если ещё не установлен
# Если ещё никогда не запускали n8n на своей системе - запустите командой "n8n"
# Это создаст папку .n8n в домашней директории
cd ~/.n8n
mkdir custom && cd custom
npm init -y
npm link n8n-nodes-gigachat
n8n
```

## Лицензия

[MIT](https://github.com/tomyumm-ge/n8n-gigachat/blob/master/LICENSE.md)