Community Скиллы Российские сервисы

Odata и бот для данных 1С

Универсальное

Установка

git clone (см. README)

Описание

1c-odata-skill — связка скиллов и ботов для данных 1С: OData-скилл — запросы к данным базы через стандартный протокол, поиск по метаданным — агент находит нужные объекты конфигурации, Telegram-бот — вопросы о данных из мессенджера, email-бот — ответы на письма с запросами, обычный язык — спрашивайте «сколько осталось товара X» без SQL. Для владельцев 1С, желающих спрашивать у базы вопросы голосом переписки.

Что умеет:
— запрашивать данные через OData;
— искать по метаданным конфигурации;
— отвечать в Telegram и на email;
— понимать вопросы обычным языком.

Полная документация ниже — автоматически из репозитория gybson63/1c-odata-skill (ветка main). Оригинальные материалы проекта распространяются на условиях его лицензии.

Публикация на https://infostart.ru/1c/articles/2686030

1c oData bot

Работа с 1С:Предприятие через стандартный OData: скиллы для AI-агентов, Telegram- и email-бот с мультиагентной архитектурой, обработка публикации объектов в OData.

Возможности

Email-интерфейс

Запросы к 1С обычным письмом: IMAP/SMTP, ответ HTML + вложения (таблицы, графики)
Тот же мультиагентный пайплайн (аналитик → OData → форматирование), диалог в цепочке писем
Префикс [analyze] — аналитик метаданных; whitelist отправителей в конфиге

Подробнее: docs/email.md.

Данные 1С на естественном языке

Telegram-бот: вопрос на русском → данные из базы 1С без ручных запросов
Мультиагентный AI-пайплайн: аналитик метаданных (опционально) → OData (формирование запроса) → форматтер (оформление ответа)
Подбор сущности по смыслу вопроса, подсчёт записей (/$count), раскрытие ссылок через $expand
Учёт токенов и стоимости по сессии (/tokens)

Подробнее: docs/user-guide.md, bot/README.md.

conf-doc: поиск по метаданным

Семантический keyword-поиск объектов и реквизитов конфигурации до OData-запроса
Обогащение Step 1 OData-агента контекстом из метаданных
MCP 1c-conf-doc для Cursor и бота

Подробнее: skills/conf-doc/SKILL.md, docs/mcp-setup.md.

Аналитик метаданных

Первый этап пайплайна (pre-step): conf-doc + profile → MetadataBrief для OData Step 1
Отдельный режим: /analyze в Telegram, [analyze] в email — без запроса данных
Domain profiles (ЗУП КОРП и др.): decision trees, anti-patterns

Подробнее: skills/analyst/SKILL.md.

SearXNG: веб-поиск для аналитика

Локальный self-hosted metasearch через MCP mcp-searxng
Fallback, когда conf-doc и profile не дают достаточно контекста (имена реквизитов, OData-поведение, внешняя документация 1С)
Gating: SearXNG только после успешного conf-doc search
Инструменты: searxng_web_search, web_url_read

Подробнее: docs/searxng.md.

Скиллы для AI-агентов

skills/odata/ — OData-запросы через MCP
skills/1cconfinfo/ — структура конфигурации
skills/conf-doc/ — семантический поиск метаданных
skills/analyst-* — аналитик, domain profiles, MCP-каталог

Workflow: conf_doc_search → fetch (OData). См. docs/full-guide.md.

EnableODataInterface

Внешняя обработка для публикации объектов в OData из режима Предприятия — без Конфигуратора, с выбором конкретных справочников, документов и регистров.

Подробнее: processing/README.md.

Быстрый старт

pip install -r requirements.txt
cp env.example.json env.json   # заполните токены и OData
python -m bot

Полный чеклист (OData, conf-doc, SearXNG): docs/getting-started.md.

Документация

Аудитория	Куда идти
Email-интерфейс	`docs/email.md`
Пользователь бота (Telegram / email)	`docs/user-guide.md`
Установка и настройка	`docs/getting-started.md`, `docs/configuration.md`
MCP в Cursor	`docs/mcp-setup.md`
SearXNG	`docs/searxng.md`
Разработчик бота	`bot/README.md`, `docs/architecture.md`
Участие в разработке	`CONTRIBUTING.md`
Полный индекс	`docs/README.md`

Участие в разработке

Feature-ветки от main, Conventional Commits, PR-only merge, pre-commit (ruff, mypy). См. CONTRIBUTING.md и docs/ci-cd.md.