GigaChat для сайта на Битриксе: российская модель и ваш каталог

Подключение по шагам

1. Получите авторизационные данные GigaChat

   В личном кабинете developers.sber.ru создайте проект GigaChat API и скопируйте «Authorization key» (строка в base64). Выберите область доступа: GIGACHAT_API_PERS для физического лица или GIGACHAT_API_B2B по договору.

2. Создайте ключ интеграции в кабинете сервиса

   Откройте «Подключить ассистента», выберите GigaChat, укажите сайт и доступ. Для отчётов хватит «только чтение», для обновления остатков нужен ключ «чтение и изменения» на одном сайте. Скопируйте ключ: он показывается один раз.

3. Установите библиотеки

   pip install langchain-gigachat langchain-mcp-adapters langgraph. Эти пакеты дают модель GigaChat для LangChain, клиент MCP и готовый цикл агента.

4. Запустите скрипт

   Скопируйте скрипт ниже, подставьте оба ключа и запустите. Агент подключится к адресу https://mcp.bxmcp.ru/mcp, получит список инструментов сайта и выполнит поручение из переменной TASK.

5. Переносите в своё приложение

   Тот же код работает внутри Telegram-бота, веб-формы или задания по расписанию. Храните ключи в переменных окружения, а не в коде, и давайте ключу сервиса ровно те права, которые нужны сценарию.

import asyncio
from langchain_gigachat import GigaChat
from langchain_mcp_adapters.client import MultiServerMCPClient
from langgraph.prebuilt import create_react_agent

GIGA_KEY = "AUTHORIZATION_KEY_ИЗ_КАБИНЕТА_СБЕРА"
BITRIX_KEY = "ВАШ_КЛЮЧ"
TASK = "Покажи сайты, которые ты видишь, и 5 последних товаров каталога."

async def main():
    model = GigaChat(credentials=GIGA_KEY, scope="GIGACHAT_API_PERS",
                     model="GigaChat-2-Max", verify_ssl_certs=False)
    client = MultiServerMCPClient({"bitrix": {
        "transport": "streamable_http",
        "url": "https://mcp.bxmcp.ru/mcp",
        "headers": {"Authorization": f"Bearer {BITRIX_KEY}"},
    }})
    tools = await client.get_tools()
    agent = create_react_agent(model, tools)
    result = await agent.ainvoke({"messages": [("user", TASK)]})
    print(result["messages"][-1].content)

asyncio.run(main())

Зачем GigaChat, если есть ChatGPT

Три причины, которые называют студии. Оплата по договору в рублях и закрывающие документы. Требование заказчика не отдавать данные каталога зарубежным сервисам. И отсутствие ограничений по стране: GigaChat открывается без обходных путей. Качество на задачах с инструментами у GigaChat-2-Max приемлемое для чтения и простых правок; для длинных многошаговых инструкций мы по-прежнему советуем Claude или ChatGPT, но выбор за вами.

Инструменты сайта одинаковы для всех моделей: каталог, цены, остатки, разделы, SEO, тексты, заказы и заявки. Права задаёт ключ интеграции: чтение или изменения, один сайт или все, доступ к заявкам отдельной галочкой, срок действия. Подтверждения в чате у ключей нет, поэтому для сценариев с изменениями проверяйте код на тестовом разделе и оставляйте откат: он доступен 30 дней и для изменений по ключу.

Первые фразы

• Покажи сайты, которые ты видишь, и 5 последних товаров каталога.Копировать

  Первый запуск: проверка ключа и доступа к каталогу.

• Собери остатки раздела «Склад Казань» и выдели позиции меньше 5.Копировать

  Чтение остатков, подходит для отчёта по расписанию с ключом «только чтение».

• Обнови остатки по списку из таблицы.Копировать

  Нужен ключ с изменениями. Предпросмотра в сценарии нет, проверяйте данные в коде.

• Что менял этот ключ за неделю?Копировать

  Журнал кабинета с пометкой имени ключа; оттуда же откат.