Инструменты по категориям

1C AI Agent в категории метаданных учитывается как расширение 1С, которое строит RAG-индекс по структуре конфигурации и использует его в диалоге агента. Это не MCP-сервер и не внешний индекс по выгрузке: логика живет внутри базы.

Инструменты по метаданным

  • GetMetadata - получает списки объектов метаданных: справочники, документы, регистры, перечисления и другие объекты, доступные в контуре агента.
  • GetObjectFields - возвращает реквизиты и табличные части выбранного объекта.
  • CheckObjectExists - проверяет существование объекта метаданных.
  • RAG-индексация - строит чанки по объектам, реквизитам и табличным частям; поиск идет по токенам, синонимам и TF-IDF-ранжированию.

Сильные стороны

метаданные индексируются прямо в базе, без отдельного сервера; RAG-подсказка подставляется в промпт агента и помогает выбирать правильные объекты и поля перед запросами к данным. Подходит для сценариев, где пользователь задает вопрос на естественном языке, а агент должен сам найти нужные справочники, документы или регистры.

Ограничения

нет отдельной модели форм, ролей и графа связей между объектами метаданных. Изменение метаданных не заявлено: write-действия в DSL относятся к данным, а не к структуре конфигурации. Это не универсальный MCP metadata endpoint для внешних клиентов.

Когда выбирать

когда нужен агент внутри 1С, который сам находит объекты и поля живой базы через RAG перед выполнением запросов или действий с данными.

1C AI Agent - это расширение 1С с собственным агентом, RAG по метаданным и DSL-командами для работы с живыми данными. В отличие от MCP-серверов, внешний клиент не вызывает отдельные MCP tools: пользователь работает через форму агента внутри базы, а оркестратор генерирует и выполняет DSL-сценарий.

Инструменты по данным и запросам

RunQueryвыполняет запрос на языке запросов 1С.
FindReferenceByNameищет ссылку в справочнике по наименованию.
FindReferenceByGUIDищет ссылку по уникальному идентификатору.
SelectObjectзагружает объект в контекст для последующего чтения или изменения.
CreateReferenceсоздает новый элемент справочника.
CreateDocumentсоздает новый документ.
SetFieldустанавливает значение реквизита текущего объекта.
Writeзаписывает текущий объект.
ForEach, SaveToStorage, LoadFromStorageслужебные DSL-действия для сценариев с коллекциями и промежуточным состоянием.

Связанные возможности

  • планирование задачи перед выполнением;
  • RAG-подсказка по метаданным перед генерацией запроса или действия;
  • OpenAI-compatible провайдеры, включая облачные и локальные endpoint.

Сильные стороны

агент находится внутри базы и работает с живыми данными в правах текущего пользователя. Есть явный режим Запрос1С только для чтения и отдельная настройка пользователя ДоступнаЗапись, которая запрещает create/set/write даже в агентском режиме. Хорошо подходит для сценариев, где пользователь задает бизнес-вопрос на естественном языке, а агент сам находит метаданные, строит запрос и показывает результат.

Ограничения

это не MCP endpoint для внешних клиентов и не универсальный query API. Нет отдельной команды валидации запроса до выполнения, нет BSL execution как самостоятельного инструмента, нет мультибазового routing и нет маскирования/approval уровня onec-mcp-universal или 1C Trusted Gateway. Write-сценарии требуют особенно аккуратной настройки прав и режима чтения.

Что учитывать

Подключениерасширение 1С внутри информационной базы; обращается к OpenAI-compatible провайдерам по HTTP/HTTPS, включая Gitsell AI Proxy, OpenAI API и локальные LLM endpoint вида http://localhost:1234/v1; не MCP-сервер.
Что нужноустановку расширения в базу 1С; настройку OpenAI-compatible провайдера и модели; первичную индексацию метаданных для RAG; для облачного провайдера - API-ключ, для локального HTTP-провайдера ключ может быть пустым.
Важнопроект помечен как beta. Агент работает от имени текущего пользователя 1С и учитывает права/RLS. Есть режим Запрос1С только для чтения, который запрещает CreateReference, SetField, Write, Delete; дополнительно в настройках пользователя есть флаг ДоступнаЗапись. В репозитории есть тестовый контур: модуль ИИА_Тесты, Python/COM runner, Vanessa Automation, pywinauto UI smoke, BSL Language Server анализ и Tau-Bench bridge; это инфраструктура проекта, а не отдельные пользовательские инструменты каталога.