n8n-nodes-gigachat
Version:
A user-friendly GigaChat AI (Sber) nodes for n8n
125 lines (76 loc) • 9.56 kB
Markdown
# 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)
⭐️ Не забывайте ставить звезду на репозиторий, если узел оказался вам полезным. Давайте посмотрим, сколько нас!

Буду рад фидбэку и предложениям по улучшению! 🚀
## Рекомендация блогерам
Господа, прекрасно понимаю, что все глобальные примеры базированы на узле **AI Agent**, и подключить модель через узел **GigaChat Model** может звучать крайне логично и красиво. НО я напоминаю, что **GigaChat Model** - исключительно мост между langchain-gigachat и n8n. Он не проходил строгий аудит перед выкладкой. Кроме того, я почти уверен, что там кэширование токенов либо работает очень плохо, либо не работает вообще. Таким образом, рекомендуя людям добавлять **GigaChat Model** к **AI Agent**, вы:
- Даёте не самую правильную рекомендацию
- Оставляете зрителей в заблуждении, что отечественные модели обходятся очень дорого
- Увеличиваете объём аудитории на Legacy узле, который почти невозможно сопровождать
**Что же тогда использовать?** - спросите вы. А я отвечу: 👇👇👇
### 👉 GigaChat AI

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

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

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

Устаревший узел из первых версий. Когда нужна органическая интеграция. Хотя узел и есть, его поддержка прекращена ввиду технических ограничений 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)